# API Oficial WABA ## Integração ZPRO e API Oficial da Meta (WhatsApp) O ZPRO 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 ZPRO. * **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 ZPRO é 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 ZPRO) 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 ZPRO #### Opção 1: Login Incorporado com coexistência pelo APP do ZPRO (Recomendada) O usuário utiliza o App nativo da própria ZPRO para realizar a conexão. * **Como funciona:** No painel do ZPRO, selecione "WhatsApp OAuth" e escolha o aplicativo da ZPRO. 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 ZPRO 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](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md) #### Opção 2: Tornar-se um Tech Provider O assinante ZPRO 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. [Tutorial Tech Provider](/api-oficial-waba/api-oficial-cadastro-incorporado-e-coexistencia-waba-beta.md)\ [Tutorial API manual](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md) *** ### 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 ZPRO. 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 ZPRO 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 ZPRO não realiza esse serviço, mas fornece uma lista de profissionais indicados que prestam essa assessoria. **O ZPRO cobra taxa por mensagem na API Oficial?** Não. O ZPRO 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](/api-oficial-waba/cobrancas-da-meta-whatsapp-business-platform.md) **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](/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.md) *** #### Documentação detalha o processo para conectar os canais do Facebook Messenger e do Instagram ao Z-PRO utilizando o Login Incorporado (OAuth) com o aplicativo nativo da ZDG: [Tutorial Instagram e Facebook via Oauth](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ajuda.zdg.com.br/api-oficial-waba.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.