Conversas
Responda seus clientes em tempo real
Notificações
Nenhuma notificação
AgeuBot
Selecione uma conversa ao lado para começar a responder seus clientes em tempo real.
Grupos do WhatsApp
Selecione um grupo ao lado para visualizar e responder mensagens.
A automação não funciona em grupos
Fluxos de atendimento
Qual fluxo atende em cada número
Escolha o fluxo de cada número. O botão ao lado pausa ou inicia a automação só daquele número.
Configure seu Atendimento IA
Em poucos passos sua IA estará atendendo seus clientes
Conte sobre seu negócio
A IA vai usar essas informações para atender seus clientes de forma personalizada
Selecione em qual(is) conexão(ões) a IA vai atender automaticamente
Mídias do atendimento
Envie imagens, PDFs, catálogos ou áudios que a IA pode enviar aos clientes
Revisar e Ativar
Confira as informações e ative sua IA com um clique
Follow-up Automático
Envia mensagens quando o cliente não responde (aplica a todas as automações)
Horário de Atendimento
Configure os horários de atendimento. Fora do horário, uma mensagem automática será enviada.
Pausa Automática
Configure o que acontece quando você intervém manualmente em uma conversa
Quando você envia uma mensagem pelo painel ou pelo WhatsApp no celular, a automação pode pausar naquela conversa para evitar que o bot responda junto com você.
Configuração de API OpenAI
Configurar sua própria chave para usar em todos os fluxos e automações
Integrações
Conecte o AgeuBot com seus sistemas favoritos via API
Todas as requisições devem incluir o header: X-API-Key: sua_chave_aqui
/send
- Enviar mensagem de texto
Envia uma mensagem de texto para um contato do WhatsApp (pelo número, em phone) ou do Instagram e do Messenger (pelo identificador, em jid).
curl -X POST https://ageubot.com.br/api/public/send \ -H "Content-Type: application/json" \ -H "X-API-Key: SUA_CHAVE_AQUI" \ -d '{ "phone": "5511999999999", "message": "Olá! Esta é uma mensagem via API." }'
Resposta (200):
{ "success": true, "message_id": "3EB0A97C11783ED74F44DD" }
Campos opcionais : session_id escolhe por qual número sai: o ID vem do /sessions; "auto" = o número em que a conversa com o contato já está (sem conversa anterior, responde 400 com a lista dos seus números). Sem session_id: com um número conectado, sai por ele; com dois ou mais, informe o session_id (pode vir 400 com a lista). Se o número escolhido estiver desconectado, a resposta é 503 com a lista dos seus números e nada é enviado. "pause_automation": true pausa o atendimento automático daquele contato no próprio envio, seguindo a sua Pausa Automática (Automação › Pausa Automática). Limite: 15 envios por minuto por conta, contando os envios pela API (/send e /send-file) e os áudios e arquivos mandados pelo painel; tentativas que dão erro também contam.
Instagram e Messenger: no lugar de phone, mande "jid" com o identificador do contato, do jeito que ele aparece no /contacts e nos webhooks: { "jid": "123456789@instagram", "message": "Olá!" } (no Messenger, ...@messenger).
A mensagem sai pela conexão do Instagram (ou do Messenger) em que a conversa com o contato está. Se essa conexão estiver desligada, a resposta é 503 e nada é enviado. Sem conversa anterior: com uma só conexão do tipo conectada, sai por ela; com duas ou mais conectadas, a resposta é 400 com os session_id delas para você escolher. Um session_id de número de WhatsApp para contato do Instagram (ou o contrário) também dá 400.
A Meta só deixa responder quem escreveu para você nas últimas 24 horas. Fora disso, ou se a Meta recusar por outro motivo, a resposta é 502 com o motivo no campo detalhe. Textos acima de 1.000 caracteres vão em partes: se uma parte falhar, as anteriores já saíram, então confira antes de reenviar o texto inteiro. O jid também aceita contato do WhatsApp: 5511999999999@s.whatsapp.net ou o @lid do /contacts.
/send-file
- Enviar arquivo (PDF, imagem, vídeo, áudio, documento)
NOVO
Envia um arquivo para qualquer número de WhatsApp conectado. Aceita PDF, imagens, vídeos, áudios e documentos Office. Máximo 25 MB. Limite de 15 envios/min por conta. Use file_url (URL pública do arquivo — recomendado para Make/Zapier) ou file (base64).
curl -X POST https://ageubot.com.br/api/public/send-file \ -H "Content-Type: application/json" \ -H "X-API-Key: SUA_CHAVE_AQUI" \ -d '{ "phone": "5511999999999", "file_url": "https://make-output.example.com/recibo.pdf", "filename": "recibo.pdf", "caption": "Segue seu comprovante!" }'
Resposta (200):
{ "success": true, "message_id": "3EB0...", "internal_id": "a1b2-...", "media_url": "/media/uuid.pdf" }
💡 Dica Make/Zapier: use file_url apontando pra URL pública do arquivo gerado (Google Drive, Dropbox, S3 etc). Para integrações antigas, alternativa: file com conteúdo em base64 (data URI ou string pura). Tipos aceitos: PDF, JPG, PNG, MP4, MP3, DOCX, XLSX, PPTX, ZIP. Bloqueados: EXE, BAT, SH, JS, etc. Redirects HTTP seguidos até 3 níveis com revalidação anti-SSRF.
/contacts
- Listar contatos
Retorna os últimos 100 contatos com nome, telefone e status.
curl https://ageubot.com.br/api/public/contacts \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "contacts": [{ "jid": "5511999999999@s.whatsapp.net", "name": "João Silva", "phone": "5511999999999", "status": "novo", "created_at": "2026-02-24T12:00:00" }] }
/messages/:jid
- Buscar mensagens de um contato
Retorna as últimas 50 mensagens de uma conversa. O jid é o identificador do contato (ex: 5511999999999@s.whatsapp.net).
curl https://ageubot.com.br/api/public/messages/5511999999999@s.whatsapp.net \ -H "X-API-Key: SUA_CHAVE_AQUI"
/stats
- Estatísticas gerais
Retorna o total de contatos do CRM, o total de mensagens e os contatos em andamento no CRM (os que não estão como perdido nem cliente).
curl https://ageubot.com.br/api/public/stats \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "total_contacts": 150, "total_messages": 4320, "active_conversations": 23 }
/ai-context
IA · n8n
Injeta um contexto dinamico por conversa no system prompt da IA. Use para enviar (via n8n/Make/Zapier) um resumo atualizado dos dados ja coletados — assim o agente nunca perde essas informacoes, mesmo em captacoes longas. O texto e incluido em toda resposta da IA para esse contato. Máximo 4000 caracteres: acima disso o texto é cortado, e o campo length da resposta mostra o tamanho gravado. Identifique o contato por phone (DDI+DDD+numero) ou contact_jid.
curl -X POST https://ageubot.com.br/api/public/ai-context \ -H "X-API-Key: SUA_CHAVE" \ -H "Content-Type: application/json" \ -d '{"phone":"5511999999999","context":"Lead: Joao. Busca apto 2 quartos ate R$400mil na zona sul. Ja visitou 2 imoveis."}'
Resposta (200):
{ "success": true, "contact_jid": "5511999999999@s.whatsapp.net", "length": 80 }
n8n / dica: a cada nova mensagem do lead, chame este endpoint com o resumo atualizado — o modelo recebe esse contexto em toda resposta e nao esquece. Para ler o que esta salvo: GET /api/public/ai-context?phone=5511999999999. A sua X-API-Key esta no topo desta pagina.
/sessions
- Listar seus números conectados
Devolve os números de WhatsApp da conta com o session_id de cada um. É esse ID que você usa no campo session_id do /send para escolher por qual número a mensagem sai. Instagram e Messenger não aparecem aqui: para eles, mande o jid do contato no /send, e a conexão vem da conversa com ele (com duas ou mais conectadas e sem conversa, o 400 traz os session_id).
curl https://ageubot.com.br/api/public/sessions \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "sessions": [{ "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "numero": "5511999990001", "nome": "Atendimento", "status": "connected", "slot_number": 1 }] }
Pausar e retomar o atendimento automático por contato
O robô e a IA param de responder só aquele contato, e o atendimento automático segue normal para todos os outros. Exemplo com CRM: quando o vendedor assume a conversa, chame o /pause; quando ele terminar, chame o /resume.
A pausa feita pela API fica até o /resume: não vira temporária quando o atendente responde, qualquer que seja a sua Pausa Automática, e enquanto ela vale nem o bloco Colaborador do fluxo nem a mensagem de fora do horário falam com o contato. No painel, Retomar Bot, Reiniciar e Excluir conversa também a tiram, e a limpeza de conversas antigas (abaixo) também.
/chats/:jid/pause
- Pausar o atendimento automático do contato
Não tem corpo: tudo vai na URL. A pausa fica até o /resume (veja acima o que mais a tira). Chamar duas vezes não duplica nada. No lugar de :jid use o identificador do contato exatamente como vem no /contacts ou nos webhooks (ex.: 5511999999999@s.whatsapp.net). Só os dígitos também funcionam (o servidor completa com @s.whatsapp.net), mas, se o contato estiver guardado de outro jeito (por exemplo, sem o nono dígito), a pausa fica num identificador que não recebe mensagem e o robô continua respondendo. Para Instagram e Messenger, use sempre o identificador completo.
curl -X POST https://ageubot.com.br/api/public/chats/5511999999999/pause \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "success": true, "jid": "5511999999999@s.whatsapp.net", "is_paused": true, "paused_until": null }
/chats/:jid/resume
- Retomar o atendimento automático
Remove a pausa daquele contato e, se a conversa estava finalizada (botão Finalizar ou encerrada pela automação), reabre, igual ao Retomar Bot do painel. was_paused diz se havia uma pausa valendo; reopened diz se a conversa foi reaberta.
curl -X POST https://ageubot.com.br/api/public/chats/5511999999999/resume \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "success": true, "jid": "5511999999999@s.whatsapp.net", "was_paused": true, "is_paused": false, "reopened": false }
/chats/:jid/pause-status
- Consultar se o contato está pausado
Só consulta, não muda nada. is_paused: true com paused_until: null = pausa por tempo indeterminado; com uma data = pausa temporária, que acaba sozinha naquele horário.
curl https://ageubot.com.br/api/public/chats/5511999999999/pause-status \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "jid": "5511999999999@s.whatsapp.net", "is_paused": false, "paused_until": null }
Atenção: a limpeza automática apaga as conversas antigas (60 dias sem mensagens em conta assinante; 30 nas demais) e, junto, a pausa por tempo indeterminado: o atendimento automático volta para aquele contato. Para um contato não receber mais resposta automática, finalize a conversa no painel (botão Finalizar).
/team
- Listar a equipe
Devolve os atendentes da conta, para você ligar os responsáveis do seu sistema às pessoas do AgeuBot.
curl https://ageubot.com.br/api/public/team \ -H "X-API-Key: SUA_CHAVE_AQUI"
Resposta (200):
{ "success": true, "total": 1, "members": [{ "id": "a1b2c3d4-...", "name": "Sofia Martins", "email": "sofia@suaempresa.com.br", "phone": "5511999999999", "role": "atendente", "is_active": 1 }] }
/chats/:jid/assign
- Encaminhar a conversa para um atendente
Atribui a conversa ao atendente e avisa ele. Identifique o atendente pelo member_id (do /team) ou pelo email. Diferente do botão Encaminhar do painel, não confere se o atendente atende o número daquela conversa.
curl -X POST https://ageubot.com.br/api/public/chats/5511999999999/assign \ -H "Content-Type: application/json" \ -H "X-API-Key: SUA_CHAVE_AQUI" \ -d '{"email": "sofia@suaempresa.com.br"}'
Resposta (200):
{ "success": true, "jid": "5511999999999@s.whatsapp.net", "assigned_to": { "id": "a1b2c3d4-...", "name": "Sofia Martins", "email": "sofia@suaempresa.com.br" } }
/contacts/:jid/status
- Mudar a etapa do contato no CRM
Muda a etapa (coluna do Kanban) de um contato que já está no CRM. O status é a chave da etapa: novo, qualificado etc.; uma etapa que você criou vira minúsculas, sem acento e com _ no lugar de espaço e símbolos (Em Negociação = em_negociacao). Um valor que não é etapa sua também é gravado, e o cartão aparece em Novo. O old_status diz de onde ele saiu.
curl -X PUT https://ageubot.com.br/api/public/contacts/5511999999999/status \ -H "Content-Type: application/json" \ -H "X-API-Key: SUA_CHAVE_AQUI" \ -d '{"status": "qualificado"}'
Resposta (200):
{ "success": true, "jid": "5511999999999@s.whatsapp.net", "contact_id": "e5f6...", "old_status": "novo", "new_status": "qualificado" }
O webhook status_changed desta mudança sai com "source": "public_api". Se a sua automação escuta esse webhook e também muda o status, use esse campo para não reagir à própria alteração.
Códigos de Erro
| Código | Descrição | Solução |
|---|---|---|
400 | Parâmetros inválidos | Confira os campos. No /send, com dois ou mais números conectados, informe o session_id (a resposta traz a lista). O mesmo vale para contato do Instagram/Messenger com duas ou mais conexões do tipo conectadas e sem conversa anterior |
401 | API Key ausente ou inválida | Confira o header X-API-Key e use o endereço do topo desta página |
403 | session_id que não é da conta | Use um ID do /sessions (no Instagram/Messenger, um dos session_id que vêm no 400) |
404 | Não encontrado | Atendente (/assign) ou contato do CRM (/status) que não existe nesta conta |
429 | Limite excedido | 100 requisições/min por chave; no /send e /send-file, 15 envios/min por conta. Aguarde 1 minuto |
502 | O WhatsApp não aceitou o envio (no Instagram/Messenger, a Meta: o motivo vem em detalhe, ex.: fora da janela de 24 horas; em texto longo, partes anteriores podem ter saído) | Confira a conexão do número antes de repetir: se o erro foi por tempo esgotado, a mensagem pode ter saído |
503 | WhatsApp desconectado (ou o número escolhido no session_id; no Instagram/Messenger, a conexão da conversa ou nenhuma do tipo conectada) | Nada foi enviado. Reconecte o número no painel ou use outro session_id |
Exemplos em Outras Linguagens
import requests API_KEY = "SUA_CHAVE_AQUI" BASE_URL = "https://ageubot.com.br/api/public" # Enviar mensagem response = requests.post( f"{BASE_URL}/send", headers={"X-API-Key": API_KEY}, json={ "phone": "5511999999999", "message": "Olá via Python!" } ) print(response.json()) # Listar contatos contacts = requests.get( f"{BASE_URL}/contacts", headers={"X-API-Key": API_KEY} ).json() print(contacts)
Suas conexões
Conecte até 3 canais ao seu painel: WhatsApp, Instagram ou Messenger
Minha Conta
Gerencie seu perfil e assinatura
Dados Pessoais
Minha Assinatura
Renovar Assinatura
Grupos ADICIONAL
Alterar Senha
Minha Equipe
Gerencie membros e permissões de acesso
Olá! Tudo bem?
Atenção: Risco de Banimento por Spam
O envio de mensagens em massa via QR Code (WhatsApp Web) pode resultar no banimento permanente do seu número pelo WhatsApp. O WhatsApp monitora envios em larga escala e pode bloquear sua conta sem aviso prévio.
Recomendação: Use a API Oficial do WhatsApp Business para envios em massa. Com a API Oficial, você tem zero risco de banimento, maior taxa de entrega e selo de verificação. Conecte via API Oficial na aba Conexão.
0
Total de Campanhas
0
Em Andamento
0
Concluídas
0
Mensagens Enviadas
Nenhuma campanha criada ainda
Funil de Vendas
R$ 0,00Agendamentos
Gerencie consultas e compromissos do Google Calendar
0
Hoje
0
Proximos
0
Realizados
0
Cancelados
0
Confirmados
0
Aguardando
0
Total
Carregando agendamentos...
Por que usar o Disparo?
Pelo seu próprio número
Usa a mesma conexão do seu AgeuBot. Sem ler QR Code de novo, sem outro aparelho.
Importe seus contatos do CRM
Traga os contatos do AgeuBot por status (cliente, lead, novo...) com um clique.
Agende seus envios
Programe campanhas e mensagens individuais para a melhor hora. O sistema envia sozinho.
Menor risco de bloqueio
Intervalos inteligentes entre as mensagens, limite diário e aquecimento automático do número.
Acompanhe em tempo real
Veja quantas mensagens foram entregues, quem respondeu e o que falhou, na hora.
Modelos prontos
Comece rápido com mensagens prontas de reativação, promoção, lembrete e cobrança.
Tudo isso já está incluso na sua assinatura.
É só abrir e começar a enviar — sem pagar nada a mais.
Recurso exclusivo para assinantes com assinatura ativa do AgeuBot.
Gestão
CRM empresarial integrado - produtos, orçamentos, pedidos e financeiro
0
Total
0
Ativos
0
Estoque baixo
R$ 0,00
Valor estoque
Carregando produtos...
Cobranças PIX
Cobre seus clientes por PIX pelo Mercado Pago. A IA também gera a cobrança na conversa.
0
Total
0
Pendentes
0
Recebidos
0
Expirados
R$ 0
Recebido
Carregando...
Minha Conta
Gerencie seu perfil e assinatura
