Conecte-se com a configuração rápida do Meta

Pranav

Pranav

Última atualização em Oct 21, 2026

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

  1. Vá em Configurações › Caixas de entrada › Adicionar Caixa de entrada › WhatsApp e escolha WhatsApp Cloud.

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

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

  4. 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:

      1. Copie o código de verificação exibido na janela da Meta.

      2. No seu telefone, abra a mensagem do Facebook Business, toque em Conectar e depois em Conectar à Plataforma de Negócios.

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

      4. Digite o código copiado no app e finalize as etapas na janela da Meta.

  5. 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:

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.