> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/api-oficial-waba.md). # API Oficial WABA O Z-PRO possui integração nativa com a **API Oficial do WhatsApp (WABA)**, mantida e homologada pela Meta. O Z-PRO é um **Tech Provider certificado pela Meta**, o que permite que assinantes conectem números de WhatsApp Business por meio do aplicativo da ZDG, sem necessidade de criar um App próprio. Para quem já possui um App aprovado no Facebook Developers, o Z-PRO também oferece suporte à integração via App próprio. {% hint style="warning" %} **Custos da API Oficial:** os custos de uso da API Oficial (cobranças por conversas fora da janela de 24 horas) são faturados diretamente pela Meta na **Business Manager (BM) do número conectado**. O pagamento dessas taxas é responsabilidade do assinante. O Z-PRO cobra exclusivamente a licença do software. Veja mais em [Cobranças da Meta.](/api-oficial-waba/cobrancas-da-meta-whatsapp-business-platform.md) {% endhint %} {% hint style="info" %} **Risco de bloqueio:** o uso da API Oficial elimina o risco de banimento por uso de software não autorizado. No entanto, o número ainda está sujeito às avaliações de qualidade da Meta — bloqueios por envio de spam ou violação das políticas de mensageria são de responsabilidade do operador, independentemente da ferramenta utilizada. Siga sempre as [diretrizes da Meta](https://www.whatsapp.com/legal/business-policy/). {% endhint %} *** ### Como o Z-PRO conecta na API Oficial Ao conectar pela API Oficial, o número passa a operar em **modo de coexistência**: funciona simultaneamente no aplicativo WhatsApp Business do celular e no painel do Z-PRO. A conexão utiliza a arquitetura de "Dispositivos Conectados" da Meta — o processo inclui leitura de QR Code no celular, de forma semelhante ao WhatsApp Web. Há duas opções de integração disponíveis: *** #### Opção 1 — Via App Z-PRO (usando o App da ZDG como Tech Provider) O Z-PRO disponibiliza seu próprio App (aprovado como Tech Provider na Meta) para que assinantes façam a conexão OAuth diretamente pelo painel, sem precisar de um App próprio. **Como funciona:** 1. No painel, acesse **Canais → Adicionar Canal → WhatsApp OAuth** 2. Selecione o aplicativo da ZDG 3. Faça login com o Facebook, selecione a conta WhatsApp Business e escaneie o QR Code no celular 4. O número fica conectado em modo de coexistência {% hint style="info" %} Ao conectar pelo App da ZDG, a permissão de **ligações de voz** (`calls`) já está aprovada automaticamente. {% endhint %} {% hint style="warning" %} Números com alto índice de denúncias (status Red na Meta) podem ser desconectados do App compartilhado da ZDG para proteger os demais assinantes. Veja: [Score do App Tech Provider](/configuracao-superadmin/tenants-e-licenca/gerenciar-licenca-z-pro/score-do-app-tech-provider.md) {% endhint %} **Tutorial completo:** [WhatsApp Oficial OAuth (login)](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md) *** #### Opção 2 — Via App Próprio (para quem já tem um App aprovado na Meta) Assinantes que já possuem um App aprovado no Facebook Developers — ou que desejam criar um — podem integrar o Z-PRO usando as próprias credenciais. Nesse caso, o login incorporado exibe a marca do assinante (não a ZDG) para os usuários finais. **O que é necessário:** * App criado e aprovado no Facebook Developers com status de Tech Provider * Configuração do App no painel Super Admin {% hint style="warning" %} O processo de App Review da Meta exige envio de documentos e vídeos demonstrativos. O suporte do Z-PRO não realiza esse processo, mas pode indicar profissionais especializados. {% endhint %} **Tutorial completo:** [Cadastro Incorporado e Coexistência com App Próprio](/api-oficial-waba/api-oficial-cadastro-incorporado-e-coexistencia-waba-beta.md) **Configuração no Super Admin:** [Facebook — Login Incorporado WABA, Instagram e Messenger](/configuracao-superadmin/canais-superadmin/facebook-login-incorporado-waba-insta-messenger.md) *** ### Vocabulário essencial | Termo | O que significa | | -------------------------------- | ------------------------------------------------------------------------------------------------------------- | | **WABA** | WhatsApp Business API — a API Oficial mantida e homologada pela Meta | | **Tech Provider** | Empresa certificada pela Meta para fornecer soluções WABA a terceiros. O Z-PRO tem esse status | | **OAuth / Cadastro Incorporado** | Tecnologia de conexão via login do Facebook — vincula o número ao sistema sem configuração manual de webhooks | | **Coexistência** | O número funciona simultaneamente no app do celular e no painel do Z-PRO | | **Business Manager (BM)** | Painel da Meta onde a empresa gerencia contas, ativos e métodos de pagamento | | **Template (HSM)** | Mensagem pré-aprovada pela Meta para iniciar conversas fora da janela de 24 horas | {% hint style="info" %} **APIs não oficiais também são suportadas.** O Z-PRO permite conexão via QR Code por APIs não oficiais (Baileys, Evolution API, Z-API, entre outras). Cada modalidade tem características e riscos distintos. Veja: [API Oficial vs. APIs Não Oficiais](/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.md) {% endhint %} *** ### Documentação por área #### Conectar e gerenciar o canal * [WhatsApp Oficial OAuth (login com coexistência)](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md): passo a passo para conectar um número em modo de coexistência usando o App da ZDG * * [Integrações Meta — configurações do canal](/configuracao-administrador/configuracao/integracoes-meta.md): painel de configurações do canal após a conexão: webhook, roteamento de chamadas, número de teste e outras opções * [Contas WhatsApp na Meta](/configuracao-administrador/configuracao/integracoes-meta/whatsapp-contas-meta.md) — visualização e gestão dos números WABA vinculados à Business Manager #### Templates e disparos * [Gerenciar Templates HSM ](/configuracao-administrador/configuracao/integracoes-meta/templates-integracoes-meta.md)— criação, edição e aprovação de templates de mensagem na Meta diretamente pelo painel * [Envio em Massa — Template API Oficial ](/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa/envio-em-massa-template-api-oficial.md)— disparo em massa usando um template fixo para uma lista de contatos * [Envio em Massa — Template com Variáveis](/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa/envio-em-massa-template-variavel-api-oficial.md) — disparo em massa com preenchimento dinâmico de variáveis do template por contato #### Atendimento com canal WABA * [Painel de atendimento — recursos exclusivos WABA](/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimento-waba-api-oficial.md) — funcionalidades disponíveis na tela de atendimento para canais API Oficial: reações, edição de mensagens, templates e ligações #### Ligações de voz * [Ligações de voz na API Oficial (WABA) ](/api-oficial-waba/ligacoes-de-voz-na-api-oficial-waba.md)— como ativar o recebimento de chamadas WebRTC, solicitar permissão de chamada para ligar, e configurar o roteamento entre atendentes #### Rastreamento e integrações avançadas * [Rastreamento de Conversões (Meta Pixel) ](/configuracao-administrador/configuracoes-painel-admin/integracoes/rastreamento-de-conversoes.md)— integração com o Meta Pixel para rastrear eventos de conversão originados em atendimentos via WABA * [Exemplo de fluxo N8N + API Z-PRO + WABA](/api-oficial-waba/exemplo-de-fluxo-no-n8n-+-api-z-pro-+-waba.md) — exemplo prático de automação integrando N8N com a API do Z-PRO em canais WABA #### Cobrança da Meta * [Como funciona a cobrança de mensagens na Meta ](/api-oficial-waba/cobrancas-da-meta-whatsapp-business-platform.md)— modelo de precificação por categorias de conversa, janela de 24 horas e como gerenciar o faturamento na Business Manager *** ### Perguntas frequentes **O Z-PRO cobra taxa por mensagem na API Oficial?** Não. O Z-PRO cobra a licença do software. Os custos de uso do WhatsApp são faturados pela Meta diretamente na Business Manager do número conectado. **A API Oficial elimina completamente o risco de bloqueio?** Elimina bloqueios por uso de software não autorizado. O número permanece sujeito às avaliações de qualidade da Meta: spam, violação de políticas e acúmulo de denúncias podem resultar em penalidades — independentemente da API utilizada. **Posso manter o celular ativo e usar o Z-PRO ao mesmo tempo?** Sim. O modo de coexistência permite que o número opere simultaneamente no app WhatsApp Business e no painel do Z-PRO. **Como oferecer a conexão WABA para os clientes da minha revenda com a minha marca?** É necessário criar e aprovar um App próprio no Facebook Developers. Veja a Opção 2 acima. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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.