Quando usar
-
Você já usa o Twilio como provedor da API do WhatsApp e quer integrar ao Cloud Chat
-
Você não pode/não quer usar a integração nativa via API oficial da Meta
-
Você precisa do passo a passo de configuração via Twilio Sandbox ou número Twilio
Pré-requisitos
-
Estar logado como administrador no Cloud Chat
-
Conta no Twilio com número de WhatsApp já configurado
-
Account SID e Auth Token do Twilio (disponíveis no Dashboard)
Algumas funcionalidades nativas do WhatsApp (como botões e formulários interativos) não estão disponíveis via Twilio — só na integração direta com a Meta (Embedded Signup).
Se essas funcionalidades forem importantes pra você, considere a integração nativa: Guia Mestre — Como conectar seu número de WhatsApp ao Cloud Chat.
Passo a passo
Etapa 1 — Acessar Configurações de caixa
- Vá em Configurações

- Selecione Caixa de Entrada (Inboxes)

- Clique em Adicionar Caixa de Entrada

- Selecione WhatsApp

Etapa 2 — Selecionar Twilio como provedor
-
No campo API Provider, selecione Twilio
-
Defina o nome da inbox e o número de telefone que será integrado

Etapa 3 — Pegar Account SID e Auth Token no Twilio
- Acesse o Twilio Account Dashboard

- Localize o Account SID e clique no botão lateral para copiar

-
Cole no campo Account SID do Cloud Chat
-
Faça o mesmo com o Auth Token

- Clique em Create Twilio Channel

Etapa 4 — Adicionar agentes
Adicione os agentes que vão atender a nova inbox.

Etapa 5 — Configurar webhook no Twilio
- Copie a URL do callback gerada e volte ao Twilio

- No Twilio, vá em Senders → WhatsApp Senders

- Selecione o número que vai usar na nova inbox

-
Messaging Service = None (importante)
-
Cole a URL do callback no campo Webhook URL for incoming messages

- Clique em Update WhatsApp Sender

Etapa 6 — Garantir ClaudIA na caixa (opcional)
Se você quer que a ClaudIA atenda essa inbox:
- Vá na aba Collaborators

- Confirme que a ClaudIA está atribuída à inbox

Etapa 7 — Adicionar a inbox às automações da ClaudIA
- Acesse Automation

- Encontre Assign to ClaudIA e clique em Edit

- Adicione a nova inbox na lista de inboxes da automação

- Repita para a automação Message Created

A inbox Twilio está pronta para enviar e receber mensagens no Cloud Chat usando o número configurado.
Observações
-
Para integração nativa com a Meta (com botões e formulários interativos): Guia Mestre — Como conectar seu número de WhatsApp ao Cloud Chat
-
Para entender melhor as automações da ClaudIA: Como integrar a ClaudIA ao Cloud Chat e adicionar canais
-
Para enviar mensagem proativa via Twilio: Como enviar mensagens proativas unitárias no Cloud Chat
-
Para evitar bloqueio do número (mesmas regras valem via Twilio): Como evitar bloqueios e banimentos no WhatsApp