Use a configuração manual se o seu número já estiver na Plataforma WhatsApp Business (API), você for um provedor de tecnologia integrando seu próprio número, utiliza hospedagem própria ou a Configuração rápida estiver indisponível. Você conecta o Chatwoot ao seu próprio aplicativo Meta.
Plano & acesso
-
Todo plano que inclui WhatsApp (Startups e acima, e o teste gratuito) no Chatwoot Cloud e em hospedagem própria. Veja Preços & Planos.
-
Apenas administradores.
-
A coexistência (manter o app WhatsApp Business) não é suportada com a configuração manual. Se o seu número está ativo no app WhatsApp Business, não o registre por este fluxo. Use a Configuração rápida (página 3) ou entre em contato com o suporte.
Antes de começar
Você precisa de três itens da Meta. A configuração guiada no Chatwoot explica cada um e leva para a tela certa na Meta:
-
Um aplicativo Meta com o caso de uso WhatsApp
-
O ID do número de telefone e o ID da Conta Comercial do 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 Configuração rápida, clique em fluxo de configuração manual na parte inferior. (Se a Configuração rápida não estiver disponível, você será direcionado diretamente para a configuração manual.)
-
Crie ou selecione um aplicativo Meta. No Meta Developers, crie um aplicativo (ou selecione o que você já usa para este número), escolha conectar com clientes via WhatsApp e selecione o portfólio comercial que é dono do número. Clique em Meu aplicativo Meta está pronto.
-
Adicione seu número de telefone e obtenha seus IDs. No seu aplicativo Meta, abra o caso de uso WhatsApp e escolha Configuração de API. Em Enviar e receber mensagens, abra o seletor De e selecione seu número, ou escolha Adicionar número de telefone, complete o perfil comercial e faça a verificação com o código enviado pela Meta. Copie o ID do número de telefone e o ID da Conta Comercial do WhatsApp, insira no Chatwoot e clique em Próximo.
-
Gere um token de acesso permanente. Nas Configurações Comerciais da Meta, vá em Usuários › Usuários de sistema, crie um usuário de sistema admin (ou selecione um), atribua o seu aplicativo Meta e a Conta Comercial do WhatsApp com controle total, depois clique em Gerar token. Defina validade como Nunca, selecione whatsapp_business_management e whatsapp_business_messaging, e copie o token. A Meta mostra o token apenas uma vez. De volta ao Chatwoot, cole-o como Token de acesso permanente e clique em Verificar detalhes.
-
Confira o nome da empresa, número e 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 o webhook na Meta para você. Quando todos os quatro mostrarem Verificado, clique em Continuar para adicionar agentes.
Teste: envie uma mensagem WhatsApp para o número da empresa de outro telefone. Ela deve aparecer no Chatwoot. Responda e verifique se chegou.
Mantenha seu token em segurança. Qualquer pessoa com o token pode usar sua conexão WhatsApp. Se você trocar ou revogar na Meta, atualize na aba Configuração da caixa de entrada.
Se uma etapa de verificação falhar
| Mensagem | O que fazer |
|---|---|
| Este token de acesso é inválido ou expirou | Gere um novo token permanente (validade Nunca) e tente novamente |
| Acesso a modelos não verificado | O token está sem o escopo whatsapp_business_management. As mensagens funcionarão, mas os modelos não vão sincronizar. Gere um token com as duas permissões. |
| Webhook callback ou Assinatura do webhook não verificada | Clique em Tentar configurar webhook novamente. Se ainda falhar, verifique se o usuário de sistema tem controle total da Conta Comercial do WhatsApp. |
| Insira o ID do número de telefone e o ID da Conta Comercial do WhatsApp | Copie ambos de Configuração de API no seu aplicativo Meta. São números diferentes. |
Para outros casos, veja Soluções para WhatsApp.
O que acontece depois
-
Modelos aprovados na sua Conta Comercial do WhatsApp são sincronizados automaticamente. Veja Modelos e a janela de 24 horas.
-
Chamadas também funcionam com configuração manual, após seu número estar inscrito na API de chamadas da Meta. Veja Chamadas WhatsApp.
Conectando mais de um número
Sim, é possível. Crie uma caixa de entrada Chatwoot separada para cada número. A configuração guiada já ajusta o direcionamento dos webhooks para cada uma, então não é preciso conectar manualmente.