API Camile AI

Crie, gerencie e implante entidades digitais programaticamente. Nossa API REST usa JSON e autenticação via API Key.

🔑 Autenticação

Todas as requisições exigem o header Authorization: Bearer SUA_API_KEY. Gere sua chave no Dashboard.

curl -H "Authorization: Bearer sk-camile-xxxx" \
  https://api.camileai.com/v1/agents

🧠 Entidades

GET /v1/agents

Lista todas as entidades da sua conta.

curl https://api.camileai.com/v1/agents \
  -H "Authorization: Bearer sk-camile-xxxx"

POST /v1/agents

Cria uma nova entidade digital.

curl -X POST https://api.camileai.com/v1/agents \
  -H "Authorization: Bearer sk-camile-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Atendente XPTO",
    "personality": "Profissional, empático e proativo",
    "channels": ["whatsapp"],
    "plan": "core"
  }'

💬 Chat

POST /v1/chat/{agent_id}/messages

Envia uma mensagem para a entidade e recebe a resposta.

curl -X POST https://api.camileai.com/v1/chat/ag_123/messages \
  -H "Authorization: Bearer sk-camile-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"content": "Olá! Qual meu saldo?"}'

💾 Memória

Cada entidade possui memória permanente. Consulte e gerencie lembranças.

GET /v1/agents/{agent_id}/memory

Lista fatos e lembranças da entidade.

📡 Canais

POST /v1/agents/{agent_id}/channels

Conecta um canal de comunicação (WhatsApp, Telegram, Web).

🪝 Webhooks

Receba eventos em tempo real: novas mensagens, erros, alterações de status.

POST /v1/webhooks

curl -X POST https://api.camileai.com/v1/webhooks \
  -H "Authorization: Bearer sk-camile-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://meusite.com/webhook", "events": ["message.received"]}'

⚡ Limites e Rate Limits

Plano Spark	100 req/dia
Plano Core	1.000 req/dia
Plano Start	5.000 req/dia
Plano Pro	20.000 req/dia
Plano Scale	100.000 req/dia
Enterprise	Ilimitado