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
Acesse Canais
Adicione um canal
Selecione o tipo WhatsApp Oficial
Selecione o Aplicativo Meta
Clique em Conectar via WhatsApp OAuth
Continue e faça login
Selecione a conta WhatsApp Business
Digite o número de telefone
Aceite a notificação no celular
Confirme no celular
- Histórico do app: até 6 meses de conversas do app (sem grupos). Fotos, vídeos, áudios e documentos chegam só das 2 semanas antes da conexão; os mais antigos ficam como [Midia importada].
- Contatos do app: os contatos da agenda do app WhatsApp Business. Quem ainda não existe é criado, e o nome segue a opção Não atualizar nome ao receber mensagens (Configurações → Geral). Remover um contato no celular não apaga nada no PanÐá Zap. Depois do pedido, os contatos adicionados ou editados no celular também chegam sozinhos.
Etapa complementar: configuração de pagamento na Meta
A conexão já funciona para receber e responder mensagens dentro da janela de 24 horas, mas há um passo final recomendado pela própria Meta: depois de conectar o número, a Meta faz uma análise da empresa; para poder enviar mensagens ativas (templates e campanhas em massa) fora da janela de 24 horas, é obrigatório cadastrar uma forma de pagamento.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
Conta apta para disparos
Registro automático do número e mensagens ao conectar
Ao concluir a conexão, o PanÐá Zap tenta registrar o número na API oficial sozinho, sem pedir PIN, e mostra o resultado na tela:Avisos da Meta: falha no pagamento e envio bloqueado
Quem usa: Administrador e Perfil Personalizado com a permissão Gerenciar sessões, que recebem a faixa de aviso e usam o botão Já resolvi. Os demais perfis veem o selo ao escolher o canal, a linha de aviso no cartão do canal (quando acessam Canais) e o motivo da falha na própria mensagem. O que é: nos canais do WhatsApp oficial (WABA), o PanÐá Zap avisa quando a Meta recusa mensagens por falha na forma de pagamento da conta, ou quando bloqueia ou limita os envios do número, da conta do WhatsApp Business ou do portfólio empresarial. Enquanto a falha de pagamento não for resolvida, mensagens cobradas, como templates e campanhas, não saem.Como resolver o aviso
Resolva no WhatsApp Manager
Clique em Já resolvi
Consultas pausadas pela Meta (erro 80008)
De vez em quando a Meta limita as consultas de gerenciamento de uma conta do WhatsApp oficial (erro 80008), como a lista de números e a lista de templates. Para não prolongar o bloqueio, o PanÐá Zap pausa essas consultas até um horário e avisa na tela, em vez de o selo de qualidade do número simplesmente sumir. Segundo o próprio aviso, o envio e o recebimento de mensagens continuam normais. O aviso não depende de permissão própria: todos os perfis que acessam as telas abaixo o veem.Mensagem com falha: o que o motivo significa
Quando uma mensagem enviada não sai, ela mostra no atendimento o ícone vermelho de falha; ao passar o mouse, aparece Falha no envio com o código da Meta (quando há) e o motivo. Nestes casos, o motivo já diz o que fazer (nesses textos, Sessões é a tela Administração → Canais):Canal oficial desconectado: as mensagens continuam entrando
Quem usa: quem acessa Canais vê o selo no cartão do canal; quem atende vê a faixa no atendimento. A opção que liga ou desliga a gravação fica em Configurações Gerais (Administrador e Perfil Personalizado com o módulo Configurações e a permissão Configurações gerais). O que é: nos canais WhatsApp oficial (WABA), Instagram e Messenger, desconectar o canal no sistema não avisa a Meta, que continua entregando as mensagens dos clientes. Com a opção Gravar mensagens com o canal desconectado (WABA, Instagram e Messenger) ligada (padrão; em Configurações Gerais, grupo Janela de 24h e WABA), essas mensagens entram nos atendimentos sem robôs: sem fluxo, IA, ausência nem avaliação. Elas ficam com a equipe até o atendimento ser fechado, e o encerramento automático espera o canal voltar. Para responder, conecte o canal de novo.Marketing Messages API: termos e templates de marketing
Quem usa: Administrador e Perfil Personalizado com a permissão Gerenciar sessões veem o aviso dos termos; Supervisor e Atendente não veem. Quem aceita os termos na Meta é o dono do portfólio da empresa. O que é: a Marketing Messages API é um caminho de envio da Meta para os templates da categoria Marketing no WhatsApp oficial. Segundo o painel, com os termos aceitos a Meta entrega os templates de marketing a quem tem mais chance de ler e mostra cliques e conversões no WhatsApp Manager, pelo mesmo preço. O caminho é escolhido sozinho: segundo a ajuda das abas Template e Template Variável dos Comunicados, os templates de marketing saem pela Marketing Messages API quando a conta aceitou os termos, e os demais saem pelo envio comum. Sem os termos aceitos, o marketing continua saindo pelo envio comum, sem a otimização de entrega. A explicação do aviso informa ainda que, a partir de abril de 2027, contas novas só mandam marketing por esse caminho e, em outubro de 2027, todas.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. Contexto (por que o Modo Híbrido existe): desde 1º de outubro de 2026, só as 1.000 primeiras respostas do mês, por número, são grátis: a partir da seguinte, a Meta cobra cada resposta do atendente e do bot dentro da janela de 24 horas (mensagem de serviço), e o template é sempre cobrado (detalhes completos na seção “Cobranças da Meta a partir de outubro de 2026” logo abaixo). O Modo Híbrido existe justamente para reduzir esse custo: o que sai pela conexão vinculada não é cobrado pela Meta e não gasta a franquia.Como cada tipo de mensagem é roteado
Pré-requisitos
- Um canal WABA (API oficial) já ativo e conectado.
- Para a coexistência: um canal não oficial conectado por QR Code ao mesmo número (Baileys, Zapo, WWEBJS, Wuzapi, Evolution, Evolution Go, Z-API ou Uazapi).
- Para dois números: um segundo número já conectado na plataforma.
Forma 1: mesmo número (coexistência)
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
Edite o canal WABA
Abra a seção Modo híbrido
Escolha o modo
Escolha o canal vinculado
Defina botões e listas
Salve
Forma 2: dois números (handoff)
O número oficial funciona como porta de entrada; quando a conversa vira um atendimento mais longo, o cliente é transferido para um segundo número conectado por QR Code, onde o restante da conversa não tem cobrança por mensagem.Conecte um segundo número por QR Code
Edite o canal WABA
Abra a seção Modo híbrido
Selecione Dois números (handoff)
Escolha o segundo número
Salve
Como identificar mensagens híbridas
- Na lista de canais, o canal WABA em modo híbrido mostra o selo Híbrido e o canal vinculado mostra o selo Transporte; a visualização Híbrido (seletor Visualizar:) reúne esses pares. No cartão do WABA, Desvincular desliga o modo híbrido.
- Cada mensagem enviada indica por qual conexão foi roteada: pela conexão vinculada ou pelo canal oficial, quando houve fallback porque o transporte falhou.
- 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 Integrações Meta (menu Configuração), abra Contas Meta > WhatsApp, selecione a conexão e abra a aba Custos; informe o período e clique em Calcular custo. A tela mostra quanto custariam pela API oficial as mensagens que saíram pela conexão vinculada (Economia realizada (modo híbrido), com a quantidade delas) e quanto ainda poderia sair por ela (Custo evitável com modo híbrido, no fim da tabela Custo por origem: as mensagens de conversa, de atendimento, chatbot e agendamentos). As regras da estimativa estão na aba Custos da página Integrações Meta. Benefícios e quando usar: indicado para operações com alto volume de mensagens de conversa (respostas de atendente e bot), principalmente quando as respostas do número passam das 1.000 grátis do mês. Pode ser desativado a qualquer momento em Administração > Canais > editar canal WABA > Modo Híbrido > Desativado, sem impacto no funcionamento normal.Economia de mensagens (WhatsApp oficial)
Quem usa: Administrador e os perfis que editam canais (veja Canais). O efeito aparece na conversa de todos os atendentes do canal. O que é: como a API oficial cobra cada mensagem enviada (veja a seção “Cobranças da Meta a partir de outubro de 2026” abaixo), o canal WhatsApp oficial pode juntar textos seguidos numa mensagem só. São dois ajustes independentes, os dois desligados por padrão. Onde fica: Administração → Canais, menu de três pontos do canal WhatsApp oficial, Editar, seção recolhível Economia de mensagens (ela abre sozinha quando algum dos dois ajustes está ligado). Salve o canal depois de mexer, em Salvar alterações.- O texto fica na conversa num balão que mostra Juntando com o próximo texto…, um ícone de informação (Este texto espera alguns segundos para sair junto com os próximos, numa mensagem só. O tempo de 1ª resposta conta quando ele sai.) e o botão Enviar agora.
- Cada texto novo reinicia a contagem, mas a espera nunca passa de 30 segundos desde o primeiro texto.
- Os textos saem separados por uma linha em branco. Se a assinatura do atendente se repete, ela aparece uma vez só, no começo.
- O limite é de 4.096 caracteres por mensagem juntada: se o próximo texto não cabe, o que esperava sai e o novo abre outro balão. Texto que responde a uma mensagem (citação) também solta o que esperava e abre outro balão.
- Se o atendente enviar uma imagem, um vídeo ou um documento logo depois, o texto que esperava vira a legenda do arquivo (até 1.024 caracteres) e o balão do texto some. Com figurinha, áudio, nota de voz, vários arquivos, mensagem rápida ou legenda que não caberia, o texto sai antes, separado.
Cobranças da Meta a partir de outubro de 2026
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: as respostas enviadas pelo atendente ou pelo bot dentro da conversa que não sejam um template aprovado (texto, imagem, áudio, vídeo, documento, botões, listas, localização, figurinha). As 1.000 primeiras do mês, por número, são grátis; as seguintes pagam a tarifa (R$ 0,035 no Brasil). A franquia não acumula e recomeça todo dia 1º.
- Templates de utilidade e autenticação: passam a ser cobrados (com desconto por volume disponível) e, como todo template, não entram na franquia das 1.000 respostas grátis. 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.
Como se preparar
Calcule o impacto agora
Enxugue os fluxos do bot
Migre a cobrança para reais
Avalie o Modo Híbrido

