Webhooks no WhatsApp: integre comandos do grupo com seu CRM, ERP ou API
No 9bot, a integração funciona de dentro para fora: quando alguém usa um comando no grupo, como /orcamento ou /pedido, o 9bot faz uma chamada HTTP de saída (GET, POST ou PUT) para o endereço do seu CRM, ERP ou API. O 9bot não oferece uma URL para receber webhooks de outros sistemas. É diferente do webhook da Cloud API da Meta, que envia eventos de mensagens para um servidor seu.
Como funciona na prática
O que é um webhook no WhatsApp
Resposta direta: webhook é uma chamada HTTP automática feita quando um evento acontece. No WhatsApp existem dois modelos: o webhook de entrada da Cloud API da Meta, que avisa o seu servidor sobre mensagens recebidas, e a chamada de saída disparada por um comando, que é o modelo do 9bot para grupos.
| Aspecto | Webhook da Cloud API (Meta) | Comando com API no 9bot |
|---|---|---|
| Direção | Entrada: a Meta chama o seu servidor | Saída: o 9bot chama o seu sistema |
| Gatilho | Eventos de mensagens da conta | Comando enviado no grupo |
| Métodos | POST para o seu endpoint | GET, POST ou PUT |
| URL de recebimento no provedor | Você configura a sua URL na Meta | Não existe URL de entrada no 9bot |
Como um comando do grupo dispara uma chamada GET, POST ou PUT
Crie o comando
No painel do 9bot, abra Comandos e clique em Novo comando. Defina o gatilho, que deve começar com ponto, exclamação ou barra.
Escolha o tipo API
Em Tipo de resposta, selecione API e informe o endereço e o método: GET para consultar, POST para criar, PUT para atualizar.
Use no grupo
Quando um membro autorizado envia o comando, o 9bot chama o seu sistema.
Acompanhe
Verifique a execução nos registros do painel e ajuste o comando se necessário.
O guia de comandos personalizados mostra a tela de criação passo a passo. Para fluxos com várias etapas, a ação de integração também pode ser usada dentro de um workflow do 9bot.
Casos de uso: CRM, pedidos, chamados e automação
| Comando | Método | Sistema | Resultado |
|---|---|---|---|
| /orcamento | POST | CRM | Cria um lead com o pedido do cliente |
| /pedido 1234 | GET | ERP ou e-commerce | Consulta o status do pedido |
| /chamado | POST | Help desk | Abre um ticket de suporte |
| /estoque produto | GET | ERP | Consulta disponibilidade |
| /atualizar 1234 | PUT | CRM | Atualiza a etapa de uma oportunidade |
| /relatorio | POST | n8n ou Make | Dispara um cenário de automação |
Plataformas como n8n e Make costumam expor uma URL de entrada para cada cenário. Nesse caso, o comando do 9bot chama essa URL, e a plataforma distribui os dados para os demais sistemas.
Se o grupo também recebe pedidos de revendedores, veja como organizar pedidos pelo WhatsApp com comandos e registro no seu sistema.
Exemplo de payload
O exemplo abaixo é ilustrativo. Os campos e o endereço dependem do contrato da sua API.
POST https://api.suaempresa.com/leads
Content-Type: application/json
{
"comando": "/orcamento",
"grupo": "Clientes Atacado",
"texto": "20 caixas do produto X"
}Para leitura de status, um GET com o número do pedido na URL costuma ser suficiente. Para atualizar um registro existente, use PUT.
Boas práticas de segurança para webhooks de saída
- HTTPS sempre: não aponte comandos para endereços sem TLS.
- Endpoint dedicado: crie uma rota específica para o 9bot, com permissões mínimas no CRM ou ERP.
- Validação na API: trate o texto recebido como entrada não confiável e valide formato e tamanho.
- Quem pode usar: restrinja comandos sensíveis a administradores e aos grupos certos.
- Idempotência e logs: evite registros duplicados e mantenha trilha de auditoria no seu sistema.
Leia também
Perguntas frequentes
O 9bot recebe webhooks de outros sistemas?
Qual a diferença para o webhook da API oficial?
Preciso programar para integrar com o CRM?
Quais métodos HTTP são suportados?
Quanto custa?
Transforme comandos do grupo em dados no seu CRM
326 clientes no mundo usam o 9bot para operar grupos de WhatsApp. Teste por 7 dias ou fale com um especialista para mapear as integrações da sua operação.
