Use a configuração manual se o seu número já estiver na Plataforma WhatsApp Business (API), se você é um provedor de tecnologia configurando seu próprio número, se está com hospedagem própria ou se a Configuração rápida não está disponível. Você conecta o Chatwoot ao seu próprio app Meta.
Plano & acesso
-
Todo plano que inclui WhatsApp (Startups e superiores, e o teste gratuito) no Chatwoot Cloud e auto-hospedado. Veja Preços & Planos.
-
Apenas para Administradores.
-
A coexistência (manter o app WhatsApp Business) não é suportada com a configuração manual. Se o seu número estiver 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 do Meta. O assistente de configuração do Chatwoot orienta você por cada um e fornece links para a tela correta do Meta:
-
Um app Meta com o caso de uso WhatsApp
-
O ID do número de telefone e o ID da Conta WhatsApp Business do seu número
-
Um token de acesso permanente de um usuário do sistema 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ê vai direto para a configuração manual.)
-
Crie ou selecione um app Meta. No Meta Developers, crie um app (ou escolha um que já use para esse número), opte por conectar com os clientes via WhatsApp e selecione o portfólio empresarial que possui o número. Clique em Meu app Meta está pronto.
-
Adicione seu número de telefone e obtenha seus IDs. No seu app Meta, abra o caso de uso WhatsApp e escolha Configuração da API. Em Enviar e receber mensagens, abra o seletor De e escolha seu número, ou selecione Adicionar número de telefone, preencha o perfil da empresa e faça a verificação com o código enviado pelo Meta. Copie o ID do número de telefone e o ID da Conta WhatsApp Business, insira-os no Chatwoot e clique em Próximo.
-
Gere um token de acesso permanente. Nas Configurações de Negócios do Meta, acesse Usuários › Usuários do sistema, crie um usuário admin do sistema (ou escolha um já existente), atribua seu app Meta e Conta WhatsApp Business com controle total, depois clique em Gerar token. Defina a expiração para Nunca, selecione whatsapp_business_management e whatsapp_business_messaging, e copie o token. O Meta mostra o token apenas uma vez. De volta ao Chatwoot, cole-o como Token de acesso permanente e clique em Verificar detalhes.
-
Revise o nome da empresa, 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, Callback do webhook e Inscrição do webhook, e configura o webhook no Meta para você. Quando os quatro mostrarem Verificado, clique em Continuar para adicionar agentes.
Teste: envie uma mensagem WhatsApp para seu número comercial a partir de outro telefone. Ela deve aparecer no Chatwoot. Responda e confira se a mensagem chega.
Mantenha seu token privado. Qualquer pessoa com ele pode usar sua conexão WhatsApp. Se você substituí-lo ou revogá-lo no Meta, atualize-o 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 (expiração Nunca) e tente novamente |
| Acesso ao modelo não verificado | O token está sem whatsapp_business_management. As mensagens funcionarão, mas os modelos não serão sincronizados. Gere um token com as duas permissões. |
| Callback do webhook ou Inscrição do webhook não verificado | Clique em Tentar configurar webhook novamente. Se continuar falhando, verifique se o usuário do sistema tem controle total da Conta WhatsApp Business. |
| Digite o ID do número de telefone e o ID da Conta WhatsApp Business | Copie ambos de Configuração da API no seu app Meta. São números diferentes. |
Para qualquer outra situação, veja Soluções de problemas do WhatsApp.
O que acontece depois
-
Modelos aprovados na sua Conta WhatsApp Business são sincronizados automaticamente. Veja Modelos e a janela de 24 horas.
-
Chamadas funcionam com configuração manual também, depois que seu número estiver habilitado na API de Chamadas do 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 faz o roteamento do webhook para cada uma, então não há necessidade de ajustes manuais.