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"

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRFNSTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--784152d346a96a155ab73a504bb6df54c6e0acb4/t-1.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRmlSTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--7b4d9e0544a6ddfe5f69f79cf0c3f99dcc2b9646/t-2.png)

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.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSGFSTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e72aadfc84256463109f47ef44c0a1c0fcbbc8fb/t-3.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSlNSTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--34dd8eb528bdd4535363aa879332db08a2a0ec44/cw-1.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTHFSTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9b2702ab9f9da5f18ec72567101bf19242fef6c8/t-4.png)

Adicione agentes para gerenciar sua caixa de entrada do WhatsApp

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQStTTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3dd0b29e7fe4edc96f15054775c125bcf708a389/cw-3.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ3FTTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b595460c77794a0c3a9198669264102f8f41198d/t-5.png)

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.


![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT3JyVlFRPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5a653f228f85ffe8a4bc379bf183bdf83395e328/CleanShot%202026-02-25%20at%2013.30.03@2x.png)

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".

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT2VTTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--714e74911a5f6e3c8e11826540f83fe30fbf3491/m-1.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUHlTTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ea08dfe9f1955053f6d38e8ea4c2ae36a2d21ddf/m-8.png)

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.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQlNUTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--d146c4d831b0ebb5fc7fc0766774887c38c6a930/m-10.png)

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQzNNZHdFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ffb7d554aa705d75d9434ba766b2626168667dcc/SCR-20250529-pqvo.png)

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.

   ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSTJUTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1e1ddf2affd4b68fb31a3a0971fb7373db88c084/SCR-20250320-cayt.png)

   ![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS0tUTkFFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3469126ca2b9c752b408006fe8b4b81a6fd10c25/SCR-20250325-tbgg.png)

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