Canais “oficiais” são aqueles conectados através da infraestrutura aprovada diretamente pela Meta, seja por um caminho direto (OAuth ou API Cloud com aplicativo próprio) seja por um BSP (Business Solution Provider) certificado, como o Dialog360 ou o Gupshup. A diferença central em relação às conexões não oficiais (Baileys, WebJS, Evolution e semelhantes) é que aqui a comunicação passa pelos servidores da própria Meta: não há risco de banimento do número por uso de biblioteca de terceiros, e a estabilidade é garantida pelo suporte oficial da plataforma de mensagens.
Esta página reúne todos os caminhos oficiais disponíveis no PanÐá Zap para conectar WhatsApp, Instagram Direct e Facebook Messenger, além do Modo Híbrido (uma estratégia de roteamento de mensagens que reduz o custo por mensagem de canais WABA) e um resumo completo das novas cobranças da Meta que entram em vigor a partir de outubro de 2026.
Todos os caminhos que usam login incorporado (OAuth) exigem uma liberação prévia, feita uma única vez pela equipe da plataforma para o tenant da sua empresa. Se a opção de OAuth ainda não aparecer disponível no seu painel, solicite a liberação ao suporte antes de seguir os passos abaixo.
Qual caminho escolher
Como conectar cada canal oficial
WhatsApp OAuth (Coexistência)
WABA Cloud API (Aplicativo Próprio)
Instagram e Messenger (OAuth)
BSP: Dialog360 e Gupshup
Quem usa: AdministradorO que é: o passo a passo para conectar um número WhatsApp Business à API oficial da Meta usando o aplicativo de integração nativo da plataforma (modo “Tech Provider” compartilhado), em modo de coexistência: o número passa a funcionar simultaneamente no aplicativo WhatsApp Business do celular e no painel do PanÐá Zap. É a união da estabilidade da API oficial com a praticidade de manter o celular ativo, considerada a conexão mais prática e segura disponível.A liberação do recurso de OAuth precisa ser feita, uma única vez, pela equipe da plataforma para a sua empresa (tenant). Se essa opção ainda não aparecer disponível no seu painel, solicite a liberação ao suporte antes de seguir os passos abaixo.
Acesse Canais
No menu lateral, acesse Administração > Canais.
Adicione um canal
Clique em Adicionar Canal.
Selecione o tipo WhatsApp OAuth
No campo “Tipo de Canal”, selecione WhatsApp OAuth.
Selecione o Aplicativo Meta
Escolha, no menu suspenso, o aplicativo nativo fornecido pela plataforma. Se a sua empresa for, ela própria, um Tech Provider aprovado pela Meta, é possível selecionar um aplicativo próprio, já configurado previamente.
Clique em Conectar via WhatsApp OAuth
Uma janela pop-up oficial do Facebook/Meta é aberta. Tenha o celular com o WhatsApp Business em mãos.
Continue e faça login
Na janela da Meta, clique em Continuar e faça login com o Facebook.
Selecione a conta WhatsApp Business
Siga as instruções da tela para selecionar (ou criar) a conta WhatsApp Business e o Gerenciador de Negócios da empresa.
Digite o número de telefone
Digite o número de telefone exato que está no WhatsApp Business.
Aceite a notificação no celular
Abra o aplicativo WhatsApp Business no celular: uma notificação da Meta solicitará a conexão. Aceite a notificação e faça a leitura do QR Code (ou aprove o compartilhamento de conversas) diretamente na tela do computador.
Confirme no celular
Após confirmar no celular, a janela da Meta se fecha e o canal aparece como Conectado no painel.
Acesse o Gerenciador de Negócios da Meta
Vá até as configurações de conta do WhatsApp Business
Adicione um cartão de crédito
Encontre a conta conectada e adicione um cartão de crédito.
Conta apta para disparos
A partir daí, a conta está apta a receber, responder e iniciar novas conversas (disparos) através do PanÐá Zap.
Para testar, envie uma mensagem de outro número para o WhatsApp Business conectado: ela deve chegar instantaneamente no celular e na aba “Pendentes” da tela de atendimento.
Em modo de coexistência não é possível fazer ligações pelo número; para ligações pela API oficial, é necessário usar a Cloud API nativa (canal WABA, veja a aba “WABA Cloud API”).
Como o número passa a integrar o aplicativo compartilhado da plataforma, a qualidade do canal é monitorada continuamente para proteger todos os demais clientes que usam o mesmo aplicativo. Números com alto índice de denúncias ou bloqueios por spam na Meta caem para um status de reputação baixa; se isso persistir, o número pode ser desconectado do aplicativo compartilhado, e o acúmulo de números nessa situação pode bloquear a liberação de novas conexões pelo mesmo caminho. Se o seu modelo de negócio gera denúncias com frequência (por exemplo, disparos de marketing agressivos), configure um aplicativo próprio no Facebook Developers (aba “WABA Cloud API”), o que isola a reputação da sua operação da de outras empresas.
Quem usa: Administrador (ou a equipe técnica/de marketing digital da empresa, já que parte da configuração acontece no Facebook Developers, fora do painel do PanÐá Zap)O que é: o processo completo para configurar um aplicativo próprio no Facebook Developers e conectá-lo à API oficial do WhatsApp (também chamada de WABA ou Cloud API). É o caminho indicado para quem quer isolar a própria reputação (em vez de depender do aplicativo compartilhado da conexão OAuth com coexistência) ou para operações de médio/grande porte que preferem um número dedicado sem depender de celular ligado.Etapa 1: pré-requisitos
Você vai precisar de uma conta no Facebook e de um número de telefone (pode ser virtual ou um chip físico).Não é possível usar o mesmo número simultaneamente no aplicativo comum do WhatsApp e na API oficial. Se o número escolhido já tiver uma conta de WhatsApp ativa, é obrigatório excluir permanentemente essa conta antes de continuar (apenas desinstalar o aplicativo não é suficiente). Para testes, a recomendação é comprar um número virtual.
Acesse o Facebook for Developers
Faça login com sua conta do Facebook.
Crie o aplicativo
Clique em “Criar Aplicativo”, selecione “Outros” e depois o tipo Business.
Nomeie e associe ao Gerenciador de Negócios
Dê um nome ao aplicativo (ex: “WABA Cloud API”) e associe-o à conta do Gerenciador de Negócios (BM) da empresa.
Adicione o produto WhatsApp
No painel do aplicativo, adicione o produto WhatsApp.
Preencha URLs obrigatórias
Em “Configurações do app > Básico”, preencha os campos “URL da Política de Privacidade” e “URL dos Termos de Serviço”.
Publique o aplicativo
No topo da página, mude o status do aplicativo de “Em desenvolvimento” para Ao vivo.
Etapa 3: cadastro e verificação do número de telefone
Acesse a Configuração da API
No menu do aplicativo, vá em WhatsApp > Configuração da API.
Adicione um número
Clique para adicionar um novo número de telefone.
Preencha os dados
Preencha os dados da empresa e o número de telefone preparado na Etapa 1.
Verifique o número
Verifique o número recebendo o código por SMS ou ligação telefônica.
Adicione forma de pagamento
Registre o número com PIN de 6 dígitos
Esse é um passo de segurança obrigatório exigido pela Meta, realizado através de uma chamada de API (por exemplo, usando o Postman com o endpoint oficial de registro de telefone disponibilizado pela própria Meta). Esse passo é crucial para que o número seja ativado com sucesso.
Etapa 4: geração de um token de acesso permanente
O token exibido no painel do desenvolvedor é temporário e expira em 24 horas; para uma conexão estável, é necessário um token permanente.Acesse Usuários do Sistema
No Gerenciador de Negócios, vá em Usuários > Usuários do sistema.
Crie um usuário do sistema Admin
Crie um novo usuário do sistema com a função Admin.
Atribua o aplicativo ao usuário
Com o usuário selecionado, clique em Atribuir Ativos, selecione Aplicativos, escolha o aplicativo criado na Etapa 2 e conceda a permissão Gerenciar App.
Gere o token permanente
Ainda com o usuário selecionado, clique em Gerar novo token: selecione o aplicativo, defina a expiração como Nunca, marque pelo menos as permissões whatsapp_business_management e whatsapp_business_messaging, e clique em “Gerar Token”.
Copie e guarde o token
Copie o token gerado e guarde-o em um local seguro: ele não será exibido novamente pela Meta.
Etapa 5: conectando a API no PanÐá Zap e ativando os webhooks
Adicione o canal WABA
No painel Admin, acesse Canais e adicione um novo canal do tipo WABA.
Preencha as credenciais
Preencha os campos com as informações obtidas na Configuração da API da Meta: ID do número de telefone, ID da conta do WhatsApp Business e o Token Permanente gerado na Etapa 4. Ao salvar, o canal já está apto a enviar mensagens.
Copie os dados do webhook no PanÐá Zap
No painel Admin, vá em Configurações > Integração Meta e copie a URL do Webhook e o Token de Verificação exibidos ali.
Cole os dados no painel da Meta
Volte ao painel do aplicativo na Meta, em WhatsApp > Configuração da API, clique em “Editar” na seção de Webhooks, cole a URL e o Token copiados do PanÐá Zap e clique em “Verificar e Salvar”.
Assine os eventos de webhook
Depois de verificado, clique em “Gerenciar” e assine (subscribe) todos os eventos de webhook disponíveis, especialmente o evento messages.
Guarde o Token Permanente com o mesmo cuidado que uma senha: ele não é exibido novamente após a geração e dá acesso de envio de mensagens pelo número.
Caso o recebimento de mensagens apresente falhas intermitentes de comunicação com o webhook da Meta, isso costuma estar relacionado a instabilidades de rede no servidor que hospeda a plataforma; nesse caso, o diagnóstico e o ajuste são de responsabilidade da equipe técnica de infraestrutura, não algo que se resolve pela tela do painel.
Existem tutoriais em vídeo produzidos pela equipe da plataforma cobrindo cada uma destas etapas com mais detalhe visual; consulte o suporte para acesso a esse material complementar.
Quem usa: AdministradorO que é: a forma mais rápida e recomendada de conectar Instagram Direct e Facebook Messenger ao PanÐá Zap, usando o login incorporado (OAuth) com o aplicativo nativo da plataforma. Dispensa a necessidade de criar e aprovar um aplicativo próprio no painel de desenvolvedores da Meta.Funcionalidade em beta. A liberação do login incorporado para a sua empresa (tenant) precisa ser feita previamente pela equipe da plataforma. Se a opção ainda não aparecer no seu painel, solicite a liberação ao suporte.
Pré-requisito específico do Facebook Messenger (não se aplica ao Instagram): para conectar o Messenger, é obrigatório que o seu perfil pessoal do Facebook esteja cadastrado como Administrador Direto da Página (e não apenas com acesso via Gerenciador de Negócios / Portfólio Empresarial). Ter apenas “Acesso Total” pelo Gerenciador de Negócios não é suficiente e resultará em erro na hora de conectar. Caso vá conectar apenas o Instagram, esta etapa pode ser ignorada.
Como corrigir e se adicionar como Administrador da Página do Facebook
Mude para o perfil da Página
No Facebook, mude para o perfil da Página (logue como a própria página).
Acesse Configurações
Acesse as Configurações da página.
Abra Acesso à Página
No menu lateral, clique em Acesso à Página.
Adicione novo acesso
Na seção “Pessoas com acesso do Facebook”, clique em Adicionar novo.
Conceda Controle Total
Pesquise pelo seu perfil pessoal (o mesmo que você usa para logar no Facebook) e conceda Controle Total.
Aceite o convite
Volte ao seu perfil pessoal, abra as notificações e aceite o convite.
Selecione o tipo Instagram
No tipo de canal, selecione Instagram.
Selecione o Aplicativo Meta
No campo “Aplicativo Meta”, selecione, no menu suspenso, a integração OAuth nativa liberada para o seu tenant.
Clique em Conectar via Instagram OAuth
Vincule a conta do Instagram Business
Na janela pop-up da Meta, siga as etapas na tela para vincular a conta do Instagram Business.Fique logado na conta do Instagram Business em outra aba do mesmo navegador, para que o pop-up reconheça e faça a vinculação automaticamente.
Selecione o tipo Facebook
No tipo de canal, selecione Facebook.
Selecione o Aplicativo Meta
No campo “Aplicativo Meta”, selecione a integração OAuth liberada para o tenant.
Clique em Conectar via Facebook OAuth
Faça login e selecione a página
Na janela pop-up da Meta, faça login com o seu perfil pessoal (o mesmo cadastrado como administrador da página, na etapa anterior), clique em “Continuar como [seu nome]” e selecione a página que deseja conectar, concedendo as permissões solicitadas.
O erro mais comum ao conectar o Messenger é confundir “acesso via Gerenciador de Negócios” com “Administrador da Página”: são coisas diferentes, e apenas a segunda libera a conexão.
Um BSP (Business Solution Provider) é um provedor certificado pela Meta que permite conectar canais WhatsApp Business API (WABA) ao PanÐá Zap através de uma parceria comercial, como alternativa às conexões OAuth e WABA com aplicativo próprio já descritas nas outras abas.Funcionalidade em beta, lançada recentemente. Os canais BSP (Dialog360 e Gupshup) ainda estão em fase de testes e ajustes, sem previsão de homologação completa no momento; a equipe da plataforma segue trabalhando nas correções. Encontrou algum problema? Entre em contato com o suporte.
Canal Dialog360 (BSP)
Quem usa: AdministradorO que é: o 360dialog é um BSP certificado pela Meta, que permite conectar canais WABA ao PanÐá Zap através de uma parceria comercial com esse provedor.A conexão pode ser feita em dois modos.Modo Manual (Customer Account)
Use este modo se você já tem uma conta 360dialog comum (Customer Account), com a chave de API (D360-API-KEY) emitida pelo painel 360dialog na seção WABA Manager (não pelo Hub de parceiros).Selecione o tipo Dialog360, aba Manual
Em Canais > Adicionar Canal, selecione o tipo Dialog360 e a aba Manual.
Popup seguro abre automaticamente
Cole a chave de API
Cole a sua chave de API do 360dialog: os campos Phone Number ID e WABA ID são preenchidos automaticamente.
Salve
Aguarde a validação de licença e clique em Salvar.
Modo Onboarding (Partner Account)
Use este modo apenas se a sua empresa tiver uma relação de parceria (Partner) ativa com o 360dialog, com as credenciais de Partner já configuradas previamente em Configurações > Integrações > BSP > Dialog360 > Credenciais. Sem essa relação ativa, utilize o Modo Manual.Selecione a aba Onboarding
Em Canais > Adicionar Canal, selecione a aba Onboarding.
Clique em Conectar via Dialog360
Autorize o fluxo oficial
O fluxo oficial do 360dialog abre para autorizar a conexão; as credenciais são recebidas automaticamente, sem necessidade de preencher nenhum campo manualmente.
running quando ativo) e Qualidade (a pontuação de reputação do número segundo a Meta).Benefícios e quando usar: vale considerar um BSP quando a sua operação (ou a de um cliente que você atende) já possui uma relação comercial com o 360dialog, ou quando esse provedor específico oferece condições comerciais mais vantajosas do que o caminho OAuth/WABA direto.Por ser uma integração em beta, trate-a com cautela em operações críticas e reporte qualquer instabilidade ao suporte. Configurações adicionais de credenciais de Partner e templates ficam disponíveis em uma tela própria de Configurações.
Canal Gupshup (BSP)
Quem usa: AdministradorO que é: assim como o 360dialog, o Gupshup é um BSP certificado pela Meta, que permite conectar canais WABA ao PanÐá Zap por meio de uma parceria comercial com esse provedor.A conexão também pode ser feita em dois modos.Modo Manual (Customer Account)
Use este modo se você já tem uma conta Gupshup comum (Customer Account), com o App ID e o App Token gerados no painel Gupshup, na área de gerenciamento do app.Selecione o tipo Gupshup, aba Manual
Em Canais > Adicionar Canal, selecione o tipo Gupshup e a aba Manual.
Popup seguro abre automaticamente
Cole o App ID e o App Token
Cole o App ID e o App Token disponíveis no painel Gupshup: os demais campos (API Key, Phone Number ID, WABA ID) são preenchidos automaticamente.
Crie o canal
Aguarde a validação de licença e clique em Criar canal.
Modo Embedded Signup (Partner Account)
Use este modo apenas se a sua empresa estiver configurada como Tech Provider/Partner ativo na Gupshup, com um Solution ID aprovado, e com as credenciais de Partner já configuradas previamente em Configurações > Integrações > BSP > Gupshup > Credenciais. Sem essa relação ativa, utilize o Modo Manual.Selecione a aba Embedded Signup
Em Canais > Adicionar Canal, selecione a aba Embedded Signup.
Preencha Nome do canal e App ID
Preencha o Nome do canal (se deixado em branco, usa o nome do App retornado pela Gupshup) e o App ID (criado no painel de parceiros da Gupshup através do Solution ID aprovado).
Inicie o Embedded Signup
Clique em Iniciar Embedded Signup: o fluxo oficial da Gupshup recebe as credenciais automaticamente.
running quando ativo) e Qualidade (pontuação de reputação segundo a Meta).Benefícios e quando usar: mesmo raciocínio do Dialog360: vale a pena quando já existe relação comercial com a Gupshup ou quando as condições desse BSP forem mais vantajosas.Também em beta; reporte instabilidades ao suporte. É possível manter Dialog360 e Gupshup como alternativas entre si, escolhendo o provedor conforme a conveniência comercial de cada caso.
Modo Híbrido: reduza o custo por mensagem
Quem usa: Administrador
O que é: uma estratégia para reduzir o custo por mensagem da API oficial do WhatsApp, roteando as mensagens de conversa do dia a dia (respostas do atendente, menus de bot, confirmações) por uma conexão não oficial (sem cobrança por mensagem), enquanto o número oficial continua responsável pelo que só ele faz bem: templates, campanhas em massa e o recebimento de mensagens.
Funcionalidade em beta desde a versão 4.0.2.1. Avalie o comportamento na sua operação antes de aplicar em produção.
Como cada tipo de mensagem é roteado
O cliente final não percebe diferença: para ele, é sempre o mesmo número.
Pré-requisitos
- Um canal WABA (API oficial) já ativo e conectado.
- Um canal não oficial conectado por QR Code (Baileys, Meow/WhatsMeow, UAZAPI, Z-API, Evolution ou wwebjs).
- Versão do sistema 4.0.2.1 ou superior.
O número oficial recebe as mensagens e responde pela conexão não oficial, sem que o cliente perceba diferença. São duas leituras de QR Code feitas pelo mesmo celular que tem o WhatsApp da empresa.
Conecte o canal não oficial com o mesmo número
Crie e conecte um canal não oficial por QR Code (Baileys, UAZAPI etc.) usando o mesmo número da conta WABA.
Edite o canal WABA
Em Administração > Canais, edite o seu canal WABA.
Abra a seção Modo Híbrido
Selecione Coexistência (mesmo número)
Escolha a conexão não oficial
Escolha a conexão não oficial criada no passo 1.
Conecte um segundo número por QR Code
Edite o canal WABA
Em Administração > Canais, edite o seu canal WABA.
Abra a seção Modo Híbrido
Use o passo Trocar de Canal como o último do bloco: a partir dele, a conversa segue no outro número e os passos seguintes não são executados no canal original.
Como identificar mensagens híbridas
- Canais em modo híbrido exibem um ícone específico na lista de canais.
- Cada mensagem enviada indica por qual conexão foi roteada.
- Quando a conexão híbrida cai e o fallback entra em ação, a equipe recebe uma notificação automática.
Onde acompanhar a economia
Em Configurações > Integrações Meta > WhatsApp > Custos. A tela mostra quantas mensagens saíram pela conexão híbrida e simula o custo equivalente caso tivessem saído pela API oficial.
Benefícios e quando usar: indicado para operações com alto volume de mensagens de conversa (respostas de atendente e bot), especialmente depois da mudança de cobrança da Meta em outubro de 2026. Pode ser desativado a qualquer momento em Administração > Canais > editar canal WABA > Modo Híbrido > Desativado, sem impacto no funcionamento normal.
Mensagens recebidas do cliente nunca são cobradas pela Meta, com ou sem Modo Híbrido. Se a conexão não oficial cair, a mensagem nunca deixa de ser entregue (fallback automático para o canal oficial). Qualquer canal não oficial conectado na plataforma pode servir como rota híbrida. Reativar o Modo Híbrido depois de desligado é tão simples quanto selecionar novamente a conexão desejada.
Quem usa: Administrador (conteúdo de referência para planejamento financeiro da operação)
O que é: um resumo das mudanças no modelo de cobrança da API oficial do WhatsApp anunciadas pela Meta, o que passa a ser cobrado, o que continua gratuito e como a plataforma ajuda a monitorar e reduzir esse custo.
Linha do tempo
O que passa a ser cobrado a partir de outubro de 2026
- Mensagens de serviço: R$ 0,035 por mensagem entregue, sem desconto por volume. Vale para toda mensagem enviada pelo atendente ou pelo bot que não seja um template aprovado (texto, imagem, áudio, vídeo, documento, botões, listas, localização, figurinha), esteja ou não dentro da janela de 24 horas.
- Templates de utilidade e autenticação: passam a ser cobrados (com desconto por volume disponível). Exemplos: confirmação de pedido, atualização de entrega, lembrete de pagamento, código de verificação (OTP). Até então, esses templates eram gratuitos dentro da janela de 24 horas.
- Meta Business Agent: US$ 2,00 por 1 milhão de tokens processados (a partir de agosto de 2026), cobrado por cada interação do agente de IA da própria Meta, sem isenção mesmo dentro da janela de 24 horas.
O que continua gratuito: mensagens recebidas do cliente (sempre gratuitas) e a janela de 72 horas de conversas iniciadas por anúncios “Clique para o WhatsApp” (Click-to-WhatsApp Ads), exceto quando envolvem o Meta Business Agent.
Como acompanhar o impacto dentro do PanÐá Zap: em Configurações > Integrações Meta > WhatsApp > selecione a conta > Custos. A tela mostra o histórico de mensagens enviadas no período e projeta quanto custaria no novo modelo, útil para estimar o impacto financeiro antes de outubro sem depender de planilhas externas.
Como se preparar
Calcule o impacto agora
Use a tela de Custos dentro do painel.
Enxugue os fluxos do bot
Cada mensagem enviada é uma cobrança; em vez de mandar saudação, menu e confirmação em três mensagens separadas, consolide em uma só, preferencialmente com botões ou listas, para reduzir o vaivém de respostas.
Migre a cobrança para reais
Faça isso o quanto antes, caso a conta WABA ainda fature em dólares (a migração já está disponível no painel da Meta; o prazo final é junho de 2027, mas quem não migrar para de conseguir entregar mensagens).
Reprecifique, se você for uma agência ou revenda
Não é viável manter o mesmo preço para clientes que usavam a API oficial com a janela de 24 horas gratuita; revise contratos e considere repassar o custo das mensagens de serviço.
Avalie o Modo Híbrido
Para operações com alto volume de mensagens de conversa, veja a seção “Modo Híbrido: reduza o custo por mensagem” acima.
Resumo comparativo
Benefícios e quando usar: use esta tabela como referência rápida para explicar a mudança de cobrança para a diretoria ou para clientes da sua própria operação, caso você revenda o acesso à plataforma.
O preço de R$ 0,035 é o valor inicial anunciado pela Meta e pode ser reajustado; sempre confira a tela de Custos dentro do painel para números atualizados da sua própria operação, em vez de basear decisões apenas nesta tabela de referência.
