Pré-requisitos
- Uma conta válida no Facebook
- Uma conta do WhatsApp Business (ou capacidade de criar uma)
- Acesso de administrador à sua instalação do AirysChat
Configuração do Super Admin
Antes que os usuários possam utilizar a Inscrição Incorporada do WhatsApp, os administradores devem configurar as seguintes variáveis de ambiente por meio do painel do Super Admin em/super_admin/app_config?config=whatsapp_embedded:
- WHATSAPP_APP_ID: O App ID do Facebook para integração com a API do WhatsApp Business
- WHATSAPP_CONFIGURATION_ID: O Configuration ID para o fluxo de Inscrição Incorporada do WhatsApp (obtido no Portal do Desenvolvedor da Meta)
- WHATSAPP_APP_SECRET: O App Secret para o fluxo de Inscrição Incorporada do WhatsApp (necessário para troca de tokens)
Essas configurações devem ser definidas por um Super Admin antes que a opção de Inscrição Incorporada do WhatsApp seja disponibilizada aos usuários.
Recuperando Valores de Configuração do Portal de Desenvolvedores da Meta
Para obter os valores de configuração necessários:1. Crie ou Acesse Seu Aplicativo do Facebook
- Vá para Meta for Developers
- Clique em “My Apps” na navegação superior
- Selecione um aplicativo existente ou clique em “Create App”
- Se estiver criando um novo aplicativo:
- Escolha “Business” como o tipo de aplicativo
- Selecione “Business” em “I want to connect my app to”
- Forneça os detalhes do aplicativo (nome, e-mail, portfólio de negócios)
2. Configure o Produto WhatsApp
- No painel do seu aplicativo, clique em “Add Product”
- Encontre “WhatsApp” e clique em “Set Up”
- Aceite os Termos do WhatsApp Business
3. Recupere o App ID e o App Secret
- App ID: Encontrado na parte superior do painel do seu aplicativo ou em Settings → Basic
- App Secret: Localizado em Settings → Basic (clique em “Show” e autentique-se para revelar)
4. Obtenha o Configuration ID
- Navegue para Facebook Login for Business → Configuration na barra lateral esquerda
- Clique em “Configurations”
- Configure:
- Selecione a variação de login para: WhatsApp Embedded Signup.
- Selecione a conta do WhatsApp como ativo (assets). (Conceda permissão para gerenciar a conta)
- Adicione as permissões necessárias mencionadas abaixo
- Salve a configuração
- Copie o Configuration ID gerado
5. Permissões Necessárias
Certifique-se de que seu aplicativo tenha as seguintes permissões habilitadas:whatsapp_business_management- Gerenciar ativos do WhatsApp businesswhatsapp_business_messaging- Enviar e receber mensagens do WhatsAppbusiness_management- Gerenciar ativos do negócio
Para uso em produção, seu aplicativo pode precisar passar pela Análise de Aplicativo (App Review) para obter acesso avançado a determinados recursos. O fluxo de inscrição incorporada funciona com Acesso Padrão (Standard Access) para a maioria dos casos de uso.
Criando um Canal do WhatsApp
Passo 1: Navegue até a Seleção de Canal
- Vá para Settings → Inboxes no painel do seu AirysChat
- Clique em “Add Inbox”
- Selecione WhatsApp nas opções de canais
Passo 2: Escolha o WhatsApp Cloud
Selecione “WhatsApp Cloud” para a configuração rápida por meio da Meta (inscrição incorporada).
Passo 3: Inicie a Inscrição Incorporada
Clique em “Connect with WhatsApp Business” para iniciar o fluxo de inscrição incorporada.
Passo 4: Autenticação no Facebook
Você será redirecionado para o Facebook para se autenticar. Você precisa fazer login com uma conta existente do Facebook.
Passo 5: Preencha as Informações do Negócio
Selecione um portfólio de negócios existente ou crie um novo para adicionar seu número de telefone. Preencha as informações do negócio exigidas:- Portfólio de negócios
- Nome do negócio
- Site do negócio ou página de perfil
- País
- Endereço (opcional)
Passo 6: Selecione a Conta do WhatsApp Business
Escolha uma conta existente do WhatsApp Business ou crie uma nova. Você também pode selecionar ou criar um Perfil do WhatsApp Business.
Passo 7: Conclua a Configuração
Depois de concluir todos os passos, você verá a tela de sucesso. Sua conta do WhatsApp Business agora está conectada e pronta para receber mensagens.
Recursos Principais
- Nenhuma configuração manual necessária: Todo o webhook e configuração de número de telefone são automatizados
- Autenticação segura baseada em OAuth: Usa o fluxo oficial OAuth 2.0 da Meta
- Configuração automática de webhook e número de telefone: Os webhooks são registrados automaticamente
- Acompanhamento de progresso em tempo real: Feedback visual durante o processo de inscrição
- Tratamento abrangente de erros: Mensagens de erro e orientações claras
Conformidade com a Política de Comércio
A Meta analisará seu negócio para garantir que esteja em conformidade com a Política de Comércio do WhatsApp e entrará em contato dentro de 24 horas se houver um problema.Documentação de Referência
Para obter mais detalhes técnicos sobre a Inscrição Incorporada do WhatsApp, consulte a documentação oficial da Meta:Solução de Problemas
Problemas Comuns
-
“Inscrição Incorporada do WhatsApp não disponível”
- Certifique-se de que o seu Super Admin configurou as variáveis de ambiente necessárias
- Verifique se todos os três valores (App ID, Configuration ID e App Secret) estão definidos adequadamente
-
Erros de Autenticação
- Certifique-se de que está usando uma conta do Facebook existente
- Verifique se você tem as permissões necessárias para o negócio
-
Problemas de Verificação de Negócios
- Certifique-se de que as informações do seu negócio estejam corretas e completas
- Verifique se o seu negócio está em conformidade com a Política de Comércio do WhatsApp
Obtendo Ajuda
Se você encontrar problemas durante a configuração:- Verifique os logs do AirysChat para qualquer mensagem de erro
- Verifique se todas as variáveis de ambiente estão configuradas corretamente
- Certifique-se de que suas contas do Facebook/WhatsApp cumprem os pré-requisitos
- Entre em contato com o suporte do AirysChat com mensagens de erro específicas se o problema persistir