API Oficial WABA
Integração ChatPRO e API Oficial da Meta (WhatsApp)
O ChatPRO possui integração nativa com a API Oficial da Meta (WABA). Este documento explica os termos técnicos, as opções de conexão e responde às dúvidas frequentes sobre o funcionamento do serviço.
1. Vocabulário da Meta
- App (Facebook Developers): Aplicativo na plataforma de desenvolvedores da Meta que faz a comunicação entre o WhatsApp e o sistema ChatPRO.
- Gerenciador de Negócios (Business Manager - BM): Painel administrativo da Meta onde a empresa gerencia contas, ativos de negócios e métodos de pagamento.
- Tech Provider (Provedor de Tecnologia): Status concedido a uma empresa com App aprovado pela Meta para fornecer soluções de WhatsApp a terceiros. O ChatPRO é um Tech Provider certificado.
- OAuth (Cadastro Incorporado / Embedded Signup): Tecnologia de conexão onde o usuário faz login com o Facebook para vincular o número de WhatsApp de forma visual e direta, sem a necessidade de configurar um App próprio.
- Coexistência: Funcionalidade que permite operar o número na API Oficial (conectada ao ChatPRO) e no aplicativo WhatsApp Business do smartphone simultaneamente. Esse recurso utiliza a arquitetura de "Dispositivos Conectados" da Meta, ou seja, é preciso ler o QR Code no celular, assim como faz no WhatsApp Web.
2. Opções de Integração no ChatPRO
Opção 1: Login Incorporado com coexistência pelo APP do ChatPRO (Recomendada)
O usuário utiliza o App nativo da própria ChatPRO para realizar a conexão.
- Como funciona: No painel do ChatPRO, selecione "WhatsApp OAuth" e escolha o aplicativo da ChatPRO. Uma janela da Meta será aberta para efetuar o login com o Facebook. O usuário seleciona a conta do WhatsApp Business e, no aplicativo do celular, acessa 'Dispositivos Conectados' para escanear o QR Code gerado no painel. Isso vincula o ChatPRO como um dispositivo adicional, permitindo a coexistência
- Aviso sobre Instagram e Facebook: É possível utilizar este mesmo método de login incorporado (OAuth) para integrar contas do Instagram e Facebook Messenger de forma nativa, conectando os canais por meio do seu gerenciador de negócios.
Tutorial Oauth (login incorporado) com coexistência
Opção 2: Usar APP próprio (como Tech Provider da Meta)
O assinante ChatPRO cria um App no Facebook Developers e submete à Meta para análise e aprovação.
- Indicação: Para revendas (SaaS) que desejam oferecer o processo de login incorporado para seus clientes utilizando a própria marca (White-label) na tela de autenticação.
Cadastro incorporado e Coex com APP Próprio\ API manual WABA
3. Perguntas Frequentes (FAQ)
É melhor coexistência ou número direto da Meta? Qual a diferença de escolha?
A coexistência permite manter o aplicativo WhatsApp Business ativo no celular e responder as mensagens simultaneamente pelo painel do ChatPRO. A conexão de um número direto na API Oficial (sem coexistência) exige um número exclusivo, essa escolha pode ter uma estabilidade maior por não ter dois locais utilizando o mesmo número. A escolha depende da operação da empresa.
Como usar esse recurso na minha revenda?
Para oferecer o login incorporado com coexistência para seus clientes sob a sua marca, você deve criar um App no Facebook Developers e aprová-lo como Tech Provider. Caso não queira ou não tenha o status de Tech Provider, seus clientes podem utilizar o App oficial do ChatPRO para realizar a autenticação.
Não estou conseguindo habilitar minha coexistência para meus clientes, o que fazer?
Para habilitar a coexistência em contas de terceiros, o seu aplicativo precisa estar verificado e aprovado pela Meta no processo de "Análise do App" (App Review) para obter o status de Tech Provider. Esse processo exige o envio de documentos da empresa e vídeos demonstrando o uso das permissões no sistema. O suporte do ChatPRO não realiza esse serviço, mas fornece uma lista de profissionais indicados que prestam essa assessoria.
O ChatPRO cobra taxa por mensagem na API Oficial?
Não. O ChatPRO cobra o valor fixo da licença do software. As taxas de envio e de uso da infraestrutura do WhatsApp são cobradas e pagas diretamente à Meta.
Como funciona a cobrança das mensagens na Meta? O pagamento é gerenciado na Business Manager (BM) da Meta, através do cartão de crédito cadastrado. Mensagens recebidas de clientes abrem uma janela de 24 horas para resposta gratuita. Mensagens ativas ou notificações (templates) enviadas fora desta janela são cobradas de acordo com a categoria da mensagem (utilidade, marketing, etc.) e cotação do dólar. Detalhamento da cobrança na Meta aqui
A API Oficial bloqueia o número? O uso da API Oficial é o método homologado pela Meta, o que elimina bloqueios causados pelo uso de sistemas não oficiais. No entanto, o número ainda está sujeito a bloqueios se houver envio de spam, violação das políticas de uso do WhatsApp ou acúmulo de denúncias por parte dos destinatários.
Explicação sobre a diferença da API Oficial e as APIs não oficiais