🔌 Integrações¶
O Atende Ágil se conecta com o mundo de fora de duas formas bem diferentes: conectando um número de WhatsApp (pra atender clientes) e conectando sistemas externos (pra trocar dados com outras ferramentas que você já usa). Essa página é o mapa geral, cada uma tem sua própria página com mais detalhe.
📱 Conectando o WhatsApp¶
Existem duas formas de conectar um número, escolha pensando em volume e orçamento:
| 📷 API Não Oficial | ✅ API Oficial (Meta Cloud API) | |
|---|---|---|
| Como conecta | QR Code, tipo WhatsApp Web | Número verificado direto pela Meta |
| Setup | Rápido, minutos | Precisa de aprovação da Meta |
| Risco de bloqueio | Existe, com volume alto | Não, é gerenciado pela própria Meta |
| Fluxos (Flow Builder) | Disponível (menu numerado por texto) | Disponível (botões/lista nativos) |
| Custo | Sem custo por mensagem | Cobrança por conversa, conforme tabela da Meta |
Veja o detalhe de cada uma em API Oficial e API Não Oficial.
🔗 Conectando sistemas externos¶
- Webhooks de Entrada: outro sistema (seu site, uma planilha, um formulário) avisa o Atende Ágil quando algo acontece, e dispara uma mensagem, um Fluxo ou um template pro telefone informado.
- Webhooks de Saída: o caminho inverso dos de entrada, o Atende Ágil avisa o seu sistema quando algo acontece (mensagem, atendimento fechado, card movido, tarefa concluída).
- API Pública: o caminho inverso, o Atende Ágil expõe endpoints pra outro sistema seu ler ou escrever dados (mensagens, contatos, funil), autenticado por chave.
- MCP: conecte o Claude (ou outra IA compatível) ao seu workspace pra consultar e agir por conversa: quem falta responder, cadastrar listas de contatos, etiquetar, mover no funil, agendar e enviar mensagens.
🧾 Logs das integrações¶
Em Configurações → Logs ficam três históricos, úteis pra descobrir por que algo não funcionou:
- Logs de Integração HTTP: as chamadas feitas pelo bloco Integração HTTP dos seus Fluxos (método, URL, status e resposta).
- Webhooks de Saída disparados: as entregas dos seus Webhooks de Saída, com evento, destino, status e tempo.
- Chamadas da API Pública: o uso da sua chave (endpoint, método, status e tempo de resposta).
🤔 Não sabe qual escolher?
Se a dúvida é só sobre como conectar o WhatsApp, comece pela Não Oficial (mais rápida pra testar) e migre pra Oficial quando o volume crescer. Se a dúvida é sobre integrar com outro sistema seu, Webhooks é pra receber eventos, API Pública é pra buscar/enviar dados por conta própria.