Como configurar um canal do WhatsApp com o Twilio?

Pranav

Pranav

Última atualização em Jun 3, 2026

Gerencie as conversas da sua conta comercial do WhatsApp através do Chatwoot. Você tem duas opções de provedores:

  1. WhatsApp Cloud API (modo preferido)

  2. Twilio

Este guia irá orientá-lo pelo processo de configuração.

Pré-requisitos

  1. Um número de telefone válido

  2. Uma conta Twilio. Se você ainda não tem uma, crie aqui: https://www.twilio.com/en-us/messaging/channels/whatsapp

Usando a API do Twilio

Existem duas maneiras de usar o Twilio com o Chatwoot:

  1. Maneira comum, sem serviço de mensagens

  2. Com serviço de mensagens

Configurando o Twilio Sem Serviço de Mensagens

Acesse sua conta Twilio e clique em "Create New Account"

Complete todos os campos obrigatórios e finalize o processo de criação da conta

Copie seu Account SID, Auth Token e número de telefone. Se você ainda não adicionou um número de telefone à sua conta Twilio, faça isso antes de prosseguir.

Acesse sua conta Chatwoot, clique em Configurações > Caixa de entrada > Adicionar Caixa de Entrada e selecione Whatsapp

Digite seu Account SID, Auth Token e número do WhatsApp aqui

Adicione agentes para gerenciar sua caixa de entrada do WhatsApp

Vá para Configurações > Caixa de entrada, selecione sua caixa, clique em Configuração e copie sua URL de webhook

Volte para o painel do Twilio

  1. Vá para Twilio Console → Phone Numbers → Manage → Active Numbers

  2. Clique no seu número do WhatsApp.

  3. Clique em Configure

  4. Em Messaging, procure o campo “Webhook (When a message comes in)”.

  5. Atualize a URL do webhook.

Pronto! Agora você pode começar a enviar mensagens do WhatsApp pelo Chatwoot.

Configurando o Twilio com Serviço de Mensagens

Configurar o Twilio com um serviço de mensagens requer etapas adicionais em comparação à configuração comum.

Navegue até Messaging > Services e clique no botão "Create Messaging Service".

Preencha todos os campos obrigatórios nas etapas seguintes até chegar aqui. Copie seu ID do serviço de mensagens e clique em “Save”.

Acesse sua conta Chatwoot. Ao criar uma caixa de entrada, marque a caixa "Use Twilio Message Service". Em seguida, cole seu Account ID, Message Service ID e Token nos campos apropriados.

Vá até o painel do Twilio, navegue até Messaging > Services > Select Service > Integration e cole sua URL de Webhook aqui.

Pronto—tudo certo! Agora você pode começar a enviar mensagens do WhatsApp pelo Chatwoot.

FAQ’s

Quais tipos de modelos do WhatsApp o Chatwoot suporta ao usar Twilio?

Atualmente, o Chatwoot não suporta modelos com Twilio.

Estou usando o Twilio Studio. São necessárias etapas adicionais para fazê-lo funcionar?

Se você usar o Twilio Studio para um fluxo de conversa personalizado, atualizar a URL do webhook diretamente irá quebrar sua integração existente.

Siga estas etapas em vez disso:

  1. Identifique o passo do seu fluxo onde deseja que aconteça a “transferência para o agente”.

  2. Adicione um “widget de requisição http” conforme mostrado abaixo com os valores fornecidos.

  3. Certifique-se de que o seu fluxo possa lidar com as respostas dos usuários às respostas dos agentes.