Seu Grok Bot reagindo ao seu WhatsApp
Faça uma rotina do Grok Bot rodar a cada mensagem que chega ao seu WhatsApp, com o n8n no meio para conferir a assinatura e entregar a chave da rotina.
Com o webhook da Coloquia, uma rotina do Grok Bot pode rodar sozinha a cada mensagem que chega ao seu WhatsApp: resumir, avisar você, anotar um pedido. Este guia liga as duas pontas.
Por que o n8n no meio: a rotina do Grok Bot só aceita chamadas com a chave dela no cabeçalho Authorization, e a Coloquia envia apenas os próprios cabeçalhos de assinatura (X-Coloquia-…). A rotina também recebe só o corpo da chamada, sem os cabeçalhos, então não teria como conferir a assinatura. O n8n resolve as duas coisas: recebe da Coloquia, confere a assinatura e repassa a mensagem ao Grok Bot com a chave. Se você ainda não usa o n8n, o n8n Cloud serve.
Os nomes de telas e botões abaixo são os da interface em inglês do Grok Bot e do n8n; com outro idioma, eles aparecem traduzidos.
1. Criar a rotina com gatilho webhook
- No chat do Bot que vai cuidar das mensagens, peça a rotina em palavras. Por exemplo: "Crie uma rotina com gatilho webhook. A cada chamada, leia a mensagem do WhatsApp que veio no corpo e me avise aqui se for um pedido de orçamento."
- No aplicativo do Grok Bot no computador, clique no nome do Bot no topo do chat, abra a aba Details e, em Routines, clique na rotina.
- Na seção Webhook, copie o campo POST to (o endereço da rotina) e o campo key (a chave). Guarde a chave como uma senha: com ela e o endereço, qualquer um dispara a rotina.
2. Montar o n8n
- Siga Webhook no n8n: receber as mensagens e conferir a assinatura até o fim. Lá você cola o endereço do n8n na área do cliente, em Conectar a IA → Configurar o webhook, copia o segredo e coloca o nó Code que confere a assinatura.
- Depois do nó Code, adicione um nó Filter com uma condição que deixe passar só os eventos em que
from_menão étrue. Sem ele, a rotina roda também para as mensagens que você e a sua IA enviam. - Depois do Filter, adicione um nó HTTP Request:
- Method:
POST. URL: o endereço copiado de POST to. - Authentication: uma credencial genérica do tipo Bearer Auth, com a chave copiada de key em Bearer Token. Assim a chave fica guardada na credencial do n8n, e não à vista no workflow. - Ligue Send Body, escolha JSON em Body Content Type e Using JSON em Specify Body, com o valor{{ JSON.stringify($json) }}. É o evento já conferido pelo nó Code. - Publique o workflow.
3. Enviar o teste
- Na tela do webhook da Coloquia, clique em Enviar teste. O evento de teste (
eventigual awebhook.test) não traz conteúdo de conversa. - No n8n, abra a aba Executions: a execução deve passar pelo Code, pelo Filter e pelo HTTP Request, que recebe
200do Grok Bot. - No Grok Bot, o resultado da rotina aparece no chat do Bot. O
200quer dizer só que o Grok Bot aceitou a chamada e começou a rodar a rotina, não que ela terminou. Qualquer outra resposta quer dizer que a rotina não rodou: confira se ela não está pausada e se a chave é a atual.
4. Verificar a assinatura
Quem confere a assinatura é o nó Code do n8n: se ela não bate, a execução para ali e nada chega ao Grok Bot. Para ver isso funcionando, troque uma letra do segredo no nó Code, publique e clique em Enviar teste. A execução deve parar no Code com Assinatura inválida, e a rotina não roda. Depois, volte o segredo certo e publique de novo.
Antes de deixar ligado
- Cada mensagem é uma execução da rotina e pode contar no uso do seu plano do Grok Bot, conforme as regras dele. Num WhatsApp movimentado, isso soma rápido: use o Filter para deixar passar só o que interessa (por exemplo, só algumas conversas, ou só texto).
- A mesma entrega pode chegar mais de uma vez. Se a rotina faz algo que não pode repetir, deduplique pelo
event_idno n8n antes do HTTP Request. - Mídia não vai junto. Foto, áudio e documento chegam só com o tipo, a legenda e uma referência; o arquivo, a sua IA conectada à Coloquia busca.
- O conteúdo das mensagens passa a ir para o n8n e para o Grok Bot, serviços que você escolheu e contratou. A Coloquia não guarda cópia do que é enviado ao webhook.