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

  1. 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."
  2. 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.
  3. 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

  1. 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.
  2. Depois do nó Code, adicione um nó Filter com uma condição que deixe passar só os eventos em que from_me não é true. Sem ele, a rotina roda também para as mensagens que você e a sua IA enviam.
  3. 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.
  4. Publique o workflow.

3. Enviar o teste

  1. Na tela do webhook da Coloquia, clique em Enviar teste. O evento de teste (event igual a webhook.test) não traz conteúdo de conversa.
  2. No n8n, abra a aba Executions: a execução deve passar pelo Code, pelo Filter e pelo HTTP Request, que recebe 200 do Grok Bot.
  3. No Grok Bot, o resultado da rotina aparece no chat do Bot. O 200 quer 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_id no 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.