Configuração rápida com a Meta (também chamada de Assinatura Incorporada) conecta seu número por meio de uma janela da Meta. O Chatwoot configura automaticamente o webhook, token e número de telefone para você.
Plano & acesso
-
Chatwoot Cloud: incluído a partir do plano Startups. Durante o teste gratuito, clique em Solicitar acesso, descreva como você usará o WhatsApp e clique em Enviar para ativar. O WhatsApp não está disponível no plano gratuito Hacker. Veja Preços & Planos.
-
Auto-hospedado: disponível apenas se sua instalação possuir seu próprio app Meta configurado para Configuração rápida (WhatsApp App ID, Configuration ID e App Secret, definidos pelo administrador da sua instalação). Se o botão Conectar com WhatsApp Business não aparecer, use a configuração manual. Veja Assinatura Incorporada do WhatsApp para auto-hospedados.
-
Apenas para Administradores.
Antes de começar
-
Entre no Facebook com uma conta que seja admin do portfólio de negócios Meta correto.
-
Permita pop-ups para o Chatwoot e Facebook.
-
Mantendo o app WhatsApp Business (Coexistência): atualize o app para a versão mais recente e mantenha o telefone online. A Coexistência funciona com o app WhatsApp Business, não com o WhatsApp pessoal. A Meta decide quais números são elegíveis.
-
Não exclua sua conta do app WhatsApp Business para usar a Coexistência. Se a Meta indicar que seu número não é elegível, ou que está conectado a outro provedor, contate o suporte antes de desconectar ou alterar qualquer coisa.
-
Conheça os limites da Coexistência antes de conectar: ao conectar, a Meta desvincula todos os dispositivos conectados (como WhatsApp Web e desktop), e você precisará vinculá-los novamente depois. WhatsApp para Windows e WhatsApp para Wear OS não são compatíveis. Conversas em grupo não são sincronizadas e não podem ser usadas no Chatwoot. A Meta também limita outras funções do app, como listas de transmissão e mensagens temporárias. Veja a lista completa em Onboarding WhatsApp Business app users da Meta.
-
-
Se você for criar um novo portfólio de negócios na janela da Meta, deixe preparados os detalhes do seu negócio: nome, endereço e site.
Conecte seu número
-
Vá em Configurações › Caixas de entrada › Adicionar Caixa de entrada › WhatsApp e escolha WhatsApp Cloud.

-
Clique em Conectar com WhatsApp Business. Uma janela da Meta será aberta.

-
Na janela da Meta, faça login, então escolha ou crie seu portfólio de negócios e Conta Comercial WhatsApp.

-
Escolha seu número:
-
Um novo número: digite e verifique-o com o código enviado pela Meta via SMS ou chamada de voz.
-
Um número no app WhatsApp Business (Coexistência): escolha conectar seu app existente e, em seguida:
-
Copie o código de verificação exibido na janela da Meta.
-
No seu telefone, abra a mensagem do Facebook Business, toque em Conectar e depois em Conectar à Plataforma de Negócios.
-
Toque em Confirmar e decida se deseja compartilhar o histórico de conversas com a Meta. Isso não importa mensagens antigas para o Chatwoot.
-
Digite o código copiado no app e finalize as etapas na janela da Meta.
-
-
-
Ao concluir a configuração, o Chatwoot exibirá Agora você pode interagir com seus clientes através do seu novo Canal. Bom atendimento e abrirá a etapa de Agentes. Escolha os agentes que devem responder a essa caixa de entrada e clique em Adicionar agentes.

Teste: envie uma mensagem de WhatsApp para o número do seu negócio a partir de outro telefone. Ela deve aparecer como uma nova conversa. Responda pelo Chatwoot e verifique se a resposta chega. Com Coexistência, confira também se o app no seu telefone continua funcionando.
O que acontece depois
-
Modelos aprovados na sua Conta Comercial do WhatsApp são sincronizados automaticamente pelo Chatwoot. Veja Modelos e a janela de 24 horas.
-
Chamadas: se chamadas estiverem disponíveis no seu plano, o Chatwoot tenta ativar essa função durante a configuração. Se seu número não estiver inscrito na Calling API da Meta, a caixa de entrada será criada mesmo assim e você poderá ativar chamadas depois. Veja Chamadas WhatsApp.
-
Histórico de conversas (Coexistência): o Chatwoot não importa conversas de antes da conexão. A partir do momento em que você conectar, novas mensagens de clientes aparecerão no Chatwoot, e respostas enviadas pelo app WhatsApp Business no telefone também aparecerão na conversa.
-
Revisões da Meta: a Meta pode pedir para você verificar sua empresa (enviar documentos) e irá revisar seu nome de exibição. Acompanhe ambos em Saúde da Conta. Veja Gerencie seu número do WhatsApp.
Se a Configuração rápida não estiver disponível
Às vezes, a Meta restringe a Configuração rápida para todos os provedores. O Chatwoot mostrará um aviso na tela de configuração. Durante este período:
-
Números já na API WhatsApp Cloud podem fazer configuração manual. Veja Conectar com WhatsApp Cloud API (configuração manual).
-
Números usando Coexistência não podem ser conectados até que a restrição seja removida.

Algo deu errado?
Veja Conexão em Solução de problemas do WhatsApp. Lá estão os erros mais comuns que você pode encontrar durante esse fluxo.