Use a configuração manual se seu número já estiver na Plataforma WhatsApp Business (API), se você é um provedor de tecnologia integrando seu próprio número, se está em ambiente self-hosted sem o Quick setup configurado ou se o Quick setup está indisponível. Você conecta o Chatwoot à sua própria aplicação Meta.
Plano & acesso
-
Todos os planos que incluem WhatsApp (Startups ou superiores, e o teste gratuito) no Chatwoot Cloud, e self-hosted. Veja Preços & Planos.
-
Apenas para Administradores.
-
A coexistência (manter o aplicativo WhatsApp Business) não é suportada na configuração manual. Se seu número estiver ativo no app WhatsApp Business, não o registre por esse fluxo. Use o Quick setup com a Meta ou entre em contato com o suporte.
Antes de começar
Você precisa de três coisas da Meta. O assistente no Chatwoot orienta você por cada uma e leva para a tela certa da Meta:
-
Uma aplicação Meta com o caso de uso WhatsApp
-
O Phone Number ID (ID do número de telefone) e WhatsApp Business Account ID (ID da conta empresarial WhatsApp) do seu número
-
Um token de acesso permanente de um usuário de sistema da Meta
Conecte seu número
-
Vá em Configurações › Caixas de entrada › Adicionar Caixa de entrada › WhatsApp e escolha WhatsApp Cloud. Na tela de Quick setup, clique em manual setup flow no rodapé. (Se o Quick setup não estiver disponível, você irá direto para a configuração manual.)
-
Crie ou selecione uma aplicação Meta. No Meta Developers, crie um aplicativo (ou escolha o que já usa para este número), selecione conectar-se com clientes pelo WhatsApp, e escolha o portfólio empresarial que possui o número. Clique em Minha aplicação Meta está pronta.
-
Adicione seu número e obtenha seus IDs. Em sua aplicação Meta, abra o caso de uso WhatsApp e escolha API Setup (Use cases › Connect with customers through WhatsApp › Customize › API Setup). Em aplicativos mais recentes, vá em Configuração básica › Configuração de produção e abra Registrar seu número de telefone do WhatsApp. Em Enviar e receber mensagens (ou Registrar seu número de telefone do WhatsApp), abra o seletor De e escolha seu número, ou clique em Adicionar número de telefone, complete o perfil comercial e faça a verificação com o código enviado pela Meta por SMS ou ligação. A Meta muda essa tela com frequência. O Phone Number ID e o WhatsApp Business Account ID geralmente aparecem próximos ao número selecionado em De. Copie o Phone Number ID e o WhatsApp Business Account ID, cole-os no Chatwoot e clique em Próximo.
-
Gere um token de acesso permanente. Em Configurações de Negócios da Meta, selecione o portfólio empresarial que possui sua Conta WhatsApp Business, depois vá em Usuários › Usuários do sistema. Crie um usuário de sistema admin (ou escolha um), atribua sua aplicação Meta e conta WhatsApp Business com controle total, aí clique em Gerar token. Escolha a aplicação Meta criada, em expiração selecione Nunca, marque whatsapp_business_management e whatsapp_business_messaging, e copie o token. A Meta mostra esse token apenas uma vez. De volta ao Chatwoot, cole-o como Token de acesso permanente e clique em Verificar detalhes.
-
Revise o nome comercial, o número e os IDs, altere o Nome da Caixa de entrada se desejar, e clique em Criar caixa de entrada.
-
O Chatwoot verifica Acesso ao número, Acesso a modelos, Webhook callback e Assinatura do webhook, e configura automaticamente o webhook na Meta para você. Quando os quatro aparecerem como Verificado, clique em Continuar para adicionar agentes.
Teste: envie uma mensagem WhatsApp para seu número comercial a partir de outro telefone. Ela deverá aparecer no Chatwoot. Responda e verifique se chega.
Mantenha seu token privado. Quem tiver acesso a ele pode usar sua conexão WhatsApp. Se alterar ou revogar o token na Meta, atualize-o na aba Configuração da caixa de entrada.
Se uma etapa de verificação falhar
| Mensagem | O que fazer |
|---|---|
| This access token is invalid or expired | Gere um novo token permanente (expiração Nunca) e tente novamente |
| Template access not verified | O token está sem whatsapp_business_management. As mensagens vão funcionar, mas os modelos não serão sincronizados. Gere um token com ambas permissões. |
| Webhook callback ou Webhook subscription not verified | Clique em Retry webhook setup. Se continuar falhando, verifique se o usuário de sistema tem controle total da Conta WhatsApp Business. Se mesmo assim não funcionar, configure o webhook manualmente: copie o Webhook URL e o Webhook Verification Token mostrados na tela final (o token também está em Configuração da caixa de entrada). Na sua aplicação Meta, vá em WhatsApp › Configuração, cole ambos, clique em Verificar e salvar, e então assine o campo messages. |
| Enter the Phone Number ID and WhatsApp Business Account ID | Copie ambos de API Setup na sua aplicação Meta. São números diferentes. |
Para outros casos, veja Solução de problemas do WhatsApp.
O que acontece depois
-
Modelos aprovados em sua Conta WhatsApp Business são sincronizados automaticamente. Veja Modelos e a janela de 24 horas.
-
Chamadas também funcionam com a configuração manual, depois que seu número está inscrito na API de Chamadas da Meta. Veja Chamadas WhatsApp.
Conectando mais de um número
Sim, você pode. Crie uma caixa de entrada Chatwoot separada para cada número. O assistente de configuração já faz o roteamento do webhook para cada caixa, então não é preciso configurar nada manualmente.