Principal Conexões com canais externos (caixas de entrada) Como conectar o WhatsApp ao Cloud Chat via Twilio

Como conectar o WhatsApp ao Cloud Chat via Twilio

Última atualização em May 21, 2026

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

  1. Vá em Configurações

  1. Selecione Caixa de Entrada (Inboxes)

  1. Clique em Adicionar Caixa de Entrada

  1. Selecione WhatsApp


Etapa 2 — Selecionar Twilio como provedor

  1. No campo API Provider, selecione Twilio

  2. Defina o nome da inbox e o número de telefone que será integrado


Etapa 3 — Pegar Account SID e Auth Token no Twilio

  1. Acesse o Twilio Account Dashboard

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

  1. Cole no campo Account SID do Cloud Chat

  2. Faça o mesmo com o Auth Token

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

  1. Copie a URL do callback gerada e volte ao Twilio

  1. No Twilio, vá em Senders → WhatsApp Senders

  1. Selecione o número que vai usar na nova inbox

  1. Messaging Service = None (importante)

  2. Cole a URL do callback no campo Webhook URL for incoming messages

  1. Clique em Update WhatsApp Sender


Etapa 6 — Garantir ClaudIA na caixa (opcional)

Se você quer que a ClaudIA atenda essa inbox:

  1. Vá na aba Collaborators

  1. Confirme que a ClaudIA está atribuída à inbox


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

  1. Acesse Automation

  1. Encontre Assign to ClaudIA e clique em Edit

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

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