Como integrar o Twilio com o n8n e a Whaticket

Neste tutorial, você conecta o Twilio, o n8n e a Whaticket. Sempre que um SMS chega no seu número do Twilio, o n8n captura a mensagem e chama a API da Whaticket, que envia o conteúdo por WhatsApp e cria o chat na sua bandeja.

O que muda para sua operação

Os SMS recebidos no Twilio viram conversas de WhatsApp na Whaticket, em tempo real.
Sua equipe atende tudo em um só lugar.
O cliente recebe a continuidade do atendimento no WhatsApp.

Antes de começar

Conta ativa no Twilio, com um número configurado para receber SMS.
Conta ativa no n8n.
Um token de API da Whaticket. Ele é criado em Integrações, aba Tokens, e herda as permissões do perfil escolhido. Para enviar mensagens, o perfil precisa das permissões Criar e Iniciar do grupo Campanhas.
O ID de uma conexão de WhatsApp conectada na Whaticket.

Passo a passo:

Copie as credenciais do Twilio

Acesse o painel do Twilio.
Copie o Account SID, o Auth Token e o número de telefone.

Configure o Twilio Trigger no n8n

No n8n, crie um novo fluxo.
Adicione o nó Twilio Trigger.
Em Credential, escolha sua conta do Twilio.
Em Trigger On, escolha New SMS.

Esse nó captura automaticamente cada SMS recebido.

Teste o recebimento

Clique em Execute Step.
Envie um SMS para o número do Twilio.
Confira se a mensagem aparece no n8n.

Crie o token e copie o ID da conexão na Whaticket

Na Whaticket, abra Integrações e a aba Tokens.
Clique em Novo token, dê um nome e escolha o Perfil. Clique em salvar.
Copie a Chave que aparece. Por segurança, ela não aparece de novo depois que você fecha a janela. Se perder, use Regenerar.
Em Conexões, abra o menu de ações (três pontos) da conexão de WhatsApp que vai enviar as mensagens, clique em Editar e use o ícone de copiar ao lado do título da janela para copiar o ID.

Configure o envio para a Whaticket

No n8n, adicione um nó HTTP Request depois do Twilio Trigger.
Em Method, escolha POST.
Em URL, use https://api.whaticket.com/api/v1/messages.
Em Headers, adicione accept: */* e Authorization: Bearer SUA_CHAVE_DE_API.

Em Body, escolha JSON e use a estrutura abaixo.

{
  "connectionId": "ID_DA_SUA_CONEXAO",
  "messages": [
    {
      "number": "EXPRESSAO_FROM",
      "name": "Cliente Twilio",
      "body": "EXPRESSAO_BODY"
    }
  ]
}

Troque EXPRESSAO_FROM pela expressão do n8n que lê o campo From do Twilio e EXPRESSAO_BODY pela que lê o campo Body. No n8n, uma expressão fica entre chaves duplas, com o nome do campo precedido de $json. Assim, o número e o texto de cada SMS entram automaticamente na mensagem. A API da Whaticket aceita só dígitos no campo number. Se o From vier com + na frente, remova o + na expressão, por exemplo com a função replace do n8n.

Confira o envio

Execute o fluxo.
Na Whaticket, abra Chats e confira se a conversa foi criada com a mensagem.
Se quiser acompanhar os envios, abra Campanhas: as mensagens enviadas pela API aparecem em uma campanha do tipo API, uma por dia para cada conexão.

Perguntas frequentes

A API responde, mas a mensagem não sai. O que conferir?
Confira se a conexão do ID informado está conectada, se a chave do token é válida e se o perfil do token tem as permissões Criar e Iniciar de Campanhas. Use os números só com dígitos, no formato internacional e sem começar com 0.

O envio pela API consome créditos?
Em conexões via QR Code, sim, como as campanhas. Durante o período de teste, todos os canais consomem créditos.

Que cuidados devo ter?
Teste com mensagens reais antes de colocar em produção, use os logs do n8n para encontrar erros e nunca compartilhe a chave do token publicamente.