Pular para o conteúdo principal
Quem usa: Administrador. O Perfil Personalizado também acessa quando o menu Integrações Meta está liberado para ele (as ações exigem também a permissão Gerenciar sessões). O que é: a página Integrações Meta é o centro de comando para todos os canais oficiais do ecossistema Meta: WhatsApp Business API (WABA), Instagram Business e Facebook Messenger. É aqui que o Administrador conecta contas pela autorização da Meta (OAuth), gerencia os números/contas conectados, configura webhooks técnicos e administra os modelos de mensagens (Templates) usados por esses canais oficiais. Como acessar: no menu lateral, no grupo Configuração, clique em Integrações Meta (a tela abre com o título Contas META). A mesma tela também fica em Configurações, aba Integrações, item Meta.
Os canais oficiais podem ser conectados tanto pela tela de Canais (tipos WhatsApp Oficial, Instagram Oficial e Facebook Oficial) quanto pela sub-aba Login / OAuth desta tela. As demais sub-abas servem para gerenciar as contas já conectadas, seus templates e parâmetros técnicos.
A tela se organiza em três grandes abas superiores, cada uma detalhada em uma seção própria abaixo: Benefícios e quando usar: use esta tela sempre que a empresa operar WhatsApp, Instagram ou Messenger pelos canais oficiais da Meta (em vez de soluções não oficiais via QR Code). Usar os canais oficiais traz maior estabilidade, menor risco de bloqueio do número e acesso a recursos exclusivos, como Templates aprovados para iniciar conversas fora da janela de 24 horas.
O fluxo lógico de configuração é: (1) conectar as contas em Login / OAuth (ou pela tela de Canais), (2) verificar e ajustar cada canal (WhatsApp, Instagram e/ou Facebook) na aba Contas Meta, (3) conferir os parâmetros técnicos em Configurações caso use um aplicativo próprio, e (4) criar/gerenciar os Templates de mensagem. As seções a seguir seguem essa ordem.

Contas Meta: Login / OAuth

Quem usa: Administrador. O que é: é o ponto de entrada de toda a integração com a Meta: a sub-aba onde o PanÐá Zap recebe autorização para gerenciar os canais oficiais (WhatsApp, Instagram e Facebook) em nome da sua empresa, por meio de autenticação OAuth. Como configurar / usar:
1

Acesse Login / OAuth

Em Integrações Meta, aba Contas Meta, abra a sub-aba Login / OAuth.
2

Escolha o Aplicativo

No quadro Aplicativo Meta, campo Aplicativo, mantenha a opção OAuth Proxy (oauth.pandazap.com): é o aplicativo de integração da plataforma, com as credenciais gerenciadas automaticamente, sem nenhuma configuração local. Se a sua empresa tiver um aplicativo Meta próprio cadastrado na plataforma, ele também aparece na lista; ao escolhê-lo, a tela mostra, somente para conferência, o App ID, a Versão da API e o ID de Configuração desse aplicativo.
3

Conecte as contas

Abaixo do campo, clique no botão do canal que deseja conectar: WhatsApp OAuth, Instagram OAuth ou Facebook OAuth. Na janela da Meta que se abre, faça login, escolha as contas (número do WhatsApp, perfil do Instagram ou Página do Facebook) e autorize as permissões. Ao concluir, o canal é criado automaticamente e a tela confirma, por exemplo, WABA conectado com sucesso ou Instagram conectado com sucesso; ao conectar pelo Facebook OAuth, os perfis do Instagram concedidos na mesma janela também viram canais, e a Página e a conta do Instagram que já têm canal recebem o novo acesso, sem criar outro canal (o canal do Instagram conectado pelo login do Instagram não é alterado).
4

Aplicativo próprio: Login com Facebook (opcional)

Com um aplicativo próprio selecionado, aparecem também os botões Login com Facebook e Verificar Status (o status fica Conectado depois do login). Com o login feito, o quadro Gerenciar WABAs permite clicar em Carregar WABAs, usar Verificar Telefone em cada conta e clicar em Criar Canal no número desejado (números que já têm canal mostram Canal criado com sucesso!).
Benefícios e quando usar: é o ponto de partida para conectar canais oficiais Meta sem sair desta tela. Sem uma conta conectada, as sub-abas WhatsApp, Instagram e Facebook ficam sem contas para gerenciar.
Se a opção OAuth Proxy não aparecer no campo Aplicativo (e não houver aplicativo próprio na lista), a conexão oficial Meta por autorização ainda não está liberada para a sua empresa: solicite a liberação ao suporte do PanÐá Zap.
Para o passo a passo completo de como conectar um número de WhatsApp Oficial (incluindo o fluxo de coexistência com um app já usado no WhatsApp Business), consulte Canais oficiais da Meta.

Contas Meta: WhatsApp

Quem usa: Administrador (e o Perfil Personalizado com acesso à tela). O que é: a sub-aba WhatsApp centraliza o gerenciamento dos números oficiais (WABA) conectados ao sistema: registro de telefones, configuração de webhooks, perfil do número, uso, limites e custos de envio e diagnóstico da conexão. Como configurar / usar:
1

Acesse a sub-aba WhatsApp

Em Integrações Meta, aba Contas Meta, abra a sub-aba WhatsApp (quadro Gerenciamento de Telefones WABA).
2

Selecione a Conexão WABA

No seletor Conexão WABA, escolha qual número gerenciar (o seletor mostra o nome de cada conexão, com o status entre parênteses).
3

Verifique o telefone

Clique em Verificar Telefone. O quadro Status do Telefone mostra Número, Nome Verificado, Plataforma, Qualidade (Alta, Média ou Baixa), o status do número, a Verificação do código e a configuração de webhook do número; ao lado, a Prévia do Perfil simula como o perfil aparece no WhatsApp.
4

Confira as Informações da Conexão

Na aba Operação, o painel Informações da Conexão mostra Nome, Status, WABA ID, Versão da API e a origem dos webhooks (aplicativo próprio ou aplicativo de integração da plataforma), com os botões Revalidar Webhook WABA, Alterar origem e Diagnosticar conexão. Na mesma aba ficam os painéis recolhidos Dicas e Dados WABA (botão Carregar WABAs: nome, moeda, país, verificação e empresa da conta). Se a Meta estiver recusando mensagens por falha no pagamento, ou bloqueando ou limitando os envios do número, o painel Informações da Conexão começa com o aviso Falha no pagamento na Meta, Envio bloqueado pela Meta ou Envio limitado pela Meta, com o Motivo informado pela Meta (e, na falha de pagamento, a Última falha) e os botões para resolver: Adicionar forma de pagamento, Como fazer e Já resolvi, ou Abrir WhatsApp Manager no bloqueio e na limitação. Veja a seção “Avisos da Meta: falha no pagamento e envio bloqueado” em Canais oficiais da Meta. Quando a conta ainda pode aceitar os termos da Marketing Messages API, o painel mostra também um bloco azul Termos da Marketing Messages API pendentes, com o botão Abrir o WhatsApp Manager (visível só para o Administrador e para o Perfil Personalizado com Gerenciar sessões); veja a seção “Marketing Messages API: termos e templates de marketing” em Canais oficiais da Meta.
5

Registre um número (se necessário)

No menu Telefone, use Registrar Telefone para registrar o número na API oficial (campos Phone Number ID, WABA ID, Versão da API, Token WABA e PIN (opcional), com o botão Gerar PIN aleatório) e Verificar Código para pedir o código de verificação por SMS ou VOICE (ligação) e depois confirmá-lo. Na janela do código, o Phone Number ID vem do canal e não pode ser editado (“ID do número salvo no canal. Para trocar, edite o canal em Sessões.”, ou seja, em Administração → Canais), e um quadro de aviso lembra: peça o código uma vez só e aguarde (se a Meta pedir para aguardar ou disser que os servidores estão indisponíveis, costuma ser limite de tentativas, e novos pedidos mantêm o bloqueio); número que está no WhatsApp Business de um celular pode ser conectado sem apagar nada pela conexão oficial da Meta (coexistência), mas, fora disso, um número em uso no WhatsApp só é ativado aqui depois que a conta for apagada no aplicativo, e as conversas do aparelho se perdem; e, se os envios falham porque o número não está registrado, use antes Registrar Telefone com um PIN de 6 dígitos (o código só é necessário quando a Meta pedir a verificação do número). O selo Pendente no menu indica que o número ainda precisa ser registrado, inclusive quando a Meta ainda mostra o número na antiga plataforma On-Premises e ele não está no app WhatsApp Business.
6

Configure o webhook

Clique em Configurar Webhook: uma janela segura configura, de uma só vez, o webhook principal e o secundário (nível do número).
7

Ajuste Perfil & SIP

No menu Perfil & SIP, use Atualizar Perfil para editar os dados do perfil comercial do número (como Sobre, Endereço, Email do Perfil e Site), Configurar SIP para informar o Hostname e o Domínio SIP das chamadas de voz via SIP, e Ativar Chamadas WebRTC para permitir chamadas de voz pelo navegador. A janela Configurar SIP lembra: Cada número aceita um servidor SIP só. Com o SIP ligado, as ligações do número saem e chegam por esse servidor, e não pelas chamadas WebRTC do navegador. Se o número já usa um servidor SIP (por exemplo, o do WaVoIP), a tela pede confirmação na janela Este número já usa SIP, que mostra o Servidor SIP atual: em Configurar SIP com outro servidor, gravar o novo pode derrubar as ligações do atual; em Ativar Chamadas WebRTC, o SIP é desligado e as ligações por aquele servidor param até ele ser configurado de novo. Clique em Continuar mesmo assim para seguir ou em Cancelar para deixar como está.
8

Diagnostique a conexão sempre que precisar confirmar que está tudo funcionando

Clique em Diagnosticar conexão: a janela Diagnóstico do canal testa itens como Token de acesso, Webhook subscrito e Ticket de ativação (a lista varia conforme o tipo de canal) e resume o resultado em Tudo certo, Atenção necessária ou Conexão com problemas. Se houver falhas, use Refazer teste ou Reconectar canal. O botão Revalidar webhook só aparece na janela dos canais Instagram e Facebook Messenger (no WhatsApp oficial, use Revalidar Webhook WABA, no painel Informações da Conexão). O botão Reconectar canal só aparece quando algum teste falha; o item Envio liberado pela Meta e a linha Marketing Messages API não contam para isso. Quando o item Envio liberado pela Meta acusa erro (como falha de pagamento ou bloqueio de envio na conta), aparece o botão Abrir WhatsApp Manager, porque a solução é na Meta. Nos canais WhatsApp oficial a janela traz ainda a linha Marketing Messages API e a seção Avisos da conta (Meta), explicadas mais abaixo, em “Diagnóstico do canal: linha Marketing Messages API e Avisos da conta (Meta)”.

Uso avançado (aba “Uso & Limites”)

  • Faturamento: defina a data de início e fim e clique em Carregar WABAs para ver, direto da Meta, as tabelas Conversas por tipo e Preços por categoria do período (volume e custo aproximado em dólares; os valores podem diferir da fatura).
  • Análises: clique em Carregar WABAs para listar os templates, marque até 10, defina o período e clique em Carregar Métricas para ver, por dia, enviadas, entregues, lidas e cliques desses templates.
  • Limites de Envio (Tiers): tabela com quantos clientes únicos podem ser contatados a cada 24 horas, conforme o nível (tier) da conta:
O acompanhamento detalhado de gastos com mensagens fica na aba Custos desta mesma sub-aba (Contas Meta > WhatsApp, com a conexão selecionada). Informe o período, ajuste se quiser a Tarifa (R$/msg) (já vem com R$ 0,035, o valor no Brasil) e clique em Calcular custo: a tela estima o custo com as regras de cobrança por mensagem da Meta e mostra Mensagens enviadas, Sem cobrança (o ícone (i) ao lado explica o que entra), Cobradas, Custo estimado, Custo por dia (com a coluna Sem cobrança), Custo por tipo de mensagem e Custo por origem (com a coluna Custo (proporcional)), além da Economia realizada (modo híbrido) e do Custo evitável com modo híbrido quando há conexão híbrida. As regras aplicadas: a resposta dentro da conversa (mensagem de serviço) foi grátis até 30/09/2026; desde 01/10/2026, as 1.000 primeiras respostas do mês, por número, são grátis (a franquia não acumula e recomeça todo dia 1º; num período que começa no meio do mês, as respostas anteriores daquele mês já contam) e as seguintes pagam a tarifa. O template é sempre cobrado e não entra na franquia (o de marketing custa mais: ajuste a tarifa para simular). Não são cobradas nem gastam a franquia as mensagens que saíram pelo canal vinculado do modo híbrido, as digitadas no app do celular (coexistência) e o histórico importado. Mensagens com falha de envio, notas internas e divisórias ficam fora do cálculo. É uma estimativa: o valor cobrado de fato, com os dados da própria Meta, fica em Uso & Limites › Faturamento. Um template de utilidade enviado com a conversa aberta antes de 01/10/2026, que era grátis, aparece aqui como cobrado.

Alterar origem dos webhooks

No painel Informações da Conexão, o botão Alterar origem define para onde os webhooks Meta deste canal são direcionados: App Meta (App Próprio), com os webhooks entregues direto pelo aplicativo próprio, ou o aplicativo de integração da plataforma (OAuth), com os webhooks entregues pelo proxy de integração. Após salvar, sempre revalide o webhook (Revalidar Webhook WABA) para que a Meta reconheça o novo destino. Nos canais do Instagram conectados pelo login do Instagram com o aplicativo da plataforma, a troca para o aplicativo próprio é recusada, sem mudar nada, com o aviso Este canal foi conectado pelo login do Instagram com o aplicativo da plataforma. Para usar o aplicativo próprio, conecte esta conta de novo em Adicionar canal > Instagram > aplicativo próprio.: siga a orientação do aviso.

Diagnóstico do canal: linha Marketing Messages API e Avisos da conta (Meta)

A janela Diagnóstico do canal abre pelo botão Diagnosticar conexão (aqui ou em Administração → Canais, no menu de três pontos do canal). Nos canais WhatsApp oficial ela traz, além dos testes, duas informações que são só informativas:
  • Linha Marketing Messages API: mostra a situação dos termos da Meta. Com os termos aceitos: Termos aceitos: os templates de marketing saem pela Marketing Messages API, com a otimização de entrega da Meta. Sem os termos aceitos: Termos ainda não aceitos: os templates de marketing saem pelo envio comum, sem a otimização. O dono do portfólio aceita no WhatsApp Manager. Se a conta ainda não está liberada: A conta ainda não está liberada para a Marketing Messages API; os templates de marketing seguem pelo envio comum. Nesses dois últimos casos a linha ganha um ícone azul de informação, no lugar do alerta. Ela nunca acende Reconectar canal: conta que ainda não aceitou os termos não é falha do canal.
  • Seção Avisos da conta (Meta): lista os avisos recentes que a Meta mandou sobre a conta do WhatsApp e os números dela. O ícone de ajuda Sobre os avisos da conta explica: Avisos que a Meta manda sobre a conta do WhatsApp e os números dela: restrições, violações, revisão da conta, alertas e mudanças de limite, de qualidade e de nome. São só informativos: não mudam nem desligam o canal. Avisos de modelos de mensagem (templates) ficam de fora. Mostra os 20 mais recentes; cada aviso fica guardado por 90 dias. Sem avisos, a seção diz Nenhum aviso da Meta sobre esta conta nos últimos 90 dias. Cada aviso mostra o título da categoria, a data e a hora, um resumo em português e até 6 linhas de detalhe (como número, país, categoria, faixa, mês de início, limite atual e anterior ou motivo da recusa). Detalhe sem tradução fica de fora, e um aviso sem tradução aparece como A Meta informou: seguido do texto enviado pela Meta. Se a seção não aparecer, o recurso ainda não está disponível na sua plataforma: fale com o suporte do PanÐá Zap.
As 11 categorias de aviso:
Revisão antes de achar que é erro (Diagnosticar conexão):
  1. A linha Marketing Messages API diz que os termos não foram aceitos, mas o resultado geral é Tudo certo: a linha é só informativa. Conta que ainda não aceitou os termos não é falha do canal; o dono do portfólio aceita no WhatsApp Manager.
  2. A seção Avisos da conta (Meta) não aparece: ela só aparece quando o sistema traz a lista de avisos. Com a lista vazia, a seção mostra Nenhum aviso da Meta sobre esta conta nos últimos 90 dias.
  3. Um aviso que a Meta mandou não aparece na lista: avisos de modelos de mensagem (templates) ficam de fora, a lista mostra só os 20 mais recentes e cada aviso fica guardado por 90 dias.
  4. Há um aviso de restrição, qualidade ou limite, mas o canal continua conectado: os avisos são só informativos e não mudam nem desligam o canal.
  5. O item Envio liberado pela Meta está em erro e o botão Reconectar canal não aparece: quando só esse item falha, é o esperado. Pagamento e bloqueio da conta se resolvem no WhatsApp Manager (botão Abrir WhatsApp Manager), não reconectando o canal.
Benefícios e quando usar: esta tela é o painel operacional do dia a dia de qualquer número WhatsApp oficial: use-a para registrar novos números, diagnosticar problemas de entrega, acompanhar quanto está sendo gasto com conversas e entender se o número está perto do limite de envio diário.
A qualidade do número aparece no campo Qualidade (Alta, Média ou Baixa) do quadro Status do Telefone, depois de clicar em Verificar Telefone. O nível (tier) atual de limite de envio não é exibido nesta tela: consulte-o no WhatsApp Manager da Meta. A qualidade é calculada com base em como as mensagens são recebidas (bloqueios, denúncias etc.) e afeta a elegibilidade para aumento de limite de envio.
Certifique-se de que o número está verificado antes de registrar, mantenha o webhook acessível publicamente via HTTPS e o token de acesso sempre atualizado: essas são as três causas mais comuns de interrupção de conexão.

Contas Meta: Instagram

Quem usa: Administrador para configurar; toda a equipe de atendimento se beneficia, já que é essa conexão que faz as DMs e menções em Stories chegarem como tickets. O que é: sub-aba que vincula e verifica a conexão com perfis profissionais do Instagram Business associados a uma Página do Facebook. Com a conexão ativa, mensagens diretas (DM) e menções em Stories passam a ser capturadas automaticamente como tickets no PanÐá Zap. Como configurar / usar:
1

Confirme os pré-requisitos

O perfil do Instagram precisa ser uma conta profissional (Business), vinculada a uma Página do Facebook, e a conta já deve estar conectada ao PanÐá Zap (pelo botão Instagram OAuth na sub-aba Login/OAuth, ou em Administração → Canais, tipo Instagram Oficial).
2

Acesse a sub-aba Instagram

Em Integrações Meta, aba Contas Meta, abra a sub-aba Instagram.
3

Selecione o perfil

No quadro Contas do Instagram, selecione o perfil no menu suspenso.
4

Verifique a conta

Clique em Verificar Conta para carregar os dados do perfil.
5

Confira o status da conexão

Confira o painel Informações da Conexão (Nome, Status, ID e a origem dos webhooks). O status precisa constar como Conectado.
6

Ajuste a conexão se necessário

Se necessário, use Revalidar webhook, Alterar origem (aplicativo próprio ou aplicativo de integração da plataforma) ou Diagnosticar conexão.
Benefícios e quando usar: essencial para empresas que recebem contato via Direct do Instagram ou usam o perfil comercial para campanhas: todas as mensagens privadas e menções passam a ser tratadas como qualquer outro ticket, com fila, atribuição e histórico unificado.
Sem o status Conectado, nenhuma mensagem direta ou menção em Stories chega ao sistema.
Quando o canal usa o aplicativo de integração da plataforma, o webhook do Instagram e a respectiva chave secreta são gerenciados automaticamente: não é necessário (nem recomendado) copiá-los manualmente em outro lugar.

Contas Meta: Facebook

Quem usa: Administrador para configurar; Atendentes se beneficiam da identidade personalizada (Personas) ao conversar pelo Messenger. O que é: sub-aba que gerencia a recepção de mensagens do Facebook Messenger e personaliza como a empresa se apresenta no chat oficial: configurando mensagem de boas-vindas automática e “Personas” (remetentes alternativos). Como configurar / usar:
1

Confirme os pré-requisitos

Precisa existir uma Página do Facebook associada à conta, o usuário deve ter permissão de administrador da Página, e a Página já deve estar conectada ao PanÐá Zap (pelo botão Facebook OAuth na sub-aba Login/OAuth, ou em Administração → Canais, tipo Facebook Oficial).
2

Acesse a sub-aba Facebook

Em Integrações Meta, aba Contas Meta, abra a sub-aba Facebook.
3

Selecione e verifique a Página

No quadro Páginas do Facebook, selecione a Página no menu suspenso e clique em Verificar Página.
4

Confira o status da conexão

Confira o painel Informações da Conexão (Nome, Status, Page ID e a origem dos webhooks).
5

Configure a Mensagem de Boas-vindas

Texto exibido antes do usuário enviar a primeira mensagem: clique em Carregar para buscar o texto atual, edite-o (limite de 160 caracteres), clique em Salvar, ou em Remover para excluí-la.
6

Crie uma Persona

Uma Persona é um remetente alternativo que exibe nome e foto de um atendente específico em vez da identidade genérica da Página: clique em Carregar lista para ver as personas existentes e, em Adicionar nova persona, preencha o Nome (ex.: “Atendente Ana”), informe opcionalmente a URL da foto e clique em Criar.
7

Ajuste a conexão se necessário

Use Revalidar webhook, Alterar origem ou Diagnosticar conexão conforme necessário, da mesma forma que nas demais sub-abas.
Benefícios e quando usar: a Mensagem de Boas-vindas melhora a primeira impressão de quem inicia contato pelo Messenger. As Personas humanizam o atendimento: em vez do cliente ver apenas o nome genérico da Página, ele vê o nome e a foto do atendente específico, o que costuma aumentar a confiança e a proximidade na conversa.
Assim como no Instagram, quando o canal usa o aplicativo de integração da plataforma, o webhook do Messenger e a respectiva chave secreta são gerenciados automaticamente: não precisam ser copiados manualmente.
Personas são apenas identidades de exibição: a régua de permissões, filas e relatórios do PanÐá Zap continua sendo a mesma do agente real por trás da persona.

Integrações Meta: Configurações

Quem usa: Administrador (é a camada mais técnica das Integrações Meta, tipicamente usada junto com um desenvolvedor quando a empresa opera com App próprio). O que é: aba que concentra os parâmetros técnicos da integração com a Meta: URLs de webhook, links públicos de política de privacidade e termos de uso, modo BSUID estrito, token de verificação do webhook (Token Meta) e verificação da conta WABA. Como configurar / usar:
1

Acesse a aba Configurações

Em Integrações Meta, abra a aba Configurações.
2

Confira as URLs de Webhook

No quadro URLs de Webhook, veja os endereços que recebem notificações da Meta para cada canal: WABA (WhatsApp Business API), Instagram e Messenger (Facebook). Use o ícone de copiar ao lado de cada URL.
Essas URLs só precisam ser cadastradas manualmente no painel de desenvolvedores da Meta quando o canal usa um aplicativo próprio (ou uma conta WABA conectada manualmente). Com o aplicativo de integração da plataforma (OAuth Proxy), os webhooks são configurados automaticamente.
3

Links de Política de Privacidade e Termos de Uso

O quadro Política de Privacidade e Termos de Uso traz os links públicos da plataforma, prontos para informar na aprovação de um aplicativo na Meta (App Review): Política de Privacidade (URL pública), Termos de Uso (URL pública) e Exclusão de dados (URL de Data Deletion). Escolha o Idioma do documento e use os ícones para copiar ou Visualizar cada página.
4

Decida sobre o BSUID estrito

No quadro BSUID estrito (compliance WABA 2026), a chave Ativar modo estrito BSUID vem desativada por padrão. Contatos que conversam pelo nome de usuário do WhatsApp, sem telefone, já usam automaticamente o campo próprio da Meta; ativar a chave aplica o modo estrito também às demais verificações de envio. A opção não muda o envio para contatos com telefone.
5

Configure o Token Meta

O Token Meta é o token de verificação que a Meta pede ao cadastrar a URL de webhook em um aplicativo próprio ou em uma conta WABA conectada manualmente. Clique em Gerar Novo Token para criar um valor aleatório, ou cole um valor no campo e clique em Salvar Token. Use os ícones de olho/copiar para visualizar e copiar o token salvo e informe o mesmo valor no painel da Meta.
6

Faça a Verificação WABA

No quadro Verificação WABA, preencha WABA ID, Versão da API e WABA Token e clique em Verificar BM: a tela lista os números encontrados na conta, com número, nome, qualidade, status e verificação de cada um.
Benefícios e quando usar: use a Verificação WABA sempre que suspeitar de problemas de autenticação ou logo após atualizar credenciais: se a consulta falhar ou não listar os números esperados, revise o WABA ID e o token informados.
Ao gerar um novo Token Meta, use o novo valor sempre que cadastrar ou revalidar o webhook no painel da Meta: o token salvo aqui e o informado na Meta precisam ser iguais.

Integrações Meta: Templates

Quem usa: Administrador (criação/gestão); toda a equipe de atendimento e marketing se beneficia, pois os Templates aprovados são o que permite iniciar conversas fora da janela de 24 horas. O que é: central de modelos de mensagens pré-aprovados pela Meta, usados para iniciar conversas fora da janela de 24 horas ou em campanhas de marketing e utilidade, tanto para WhatsApp (WABA) quanto para Facebook Messenger.
Templates geram custos: o envio de templates WABA é cobrado diretamente pela Meta, com valores que variam conforme a categoria (Marketing, Utilidade, Autenticação) e o país do destinatário. Com o modelo de cobrança por mensagem da Meta, vigente desde 1º de outubro de 2026, o template é sempre cobrado e não entra na franquia de 1.000 respostas grátis por mês e por número, que vale só para as respostas dentro da conversa; veja Canais oficiais da Meta e a aba Custos da sub-aba WhatsApp.
Como configurar / usar:
1

Acesse a aba Templates

Em Integrações Meta, abra a aba Templates.
2

Sincronize os templates existentes

Na sub-aba Templates WABA (aba Lista de Templates), selecione a Conexão WABA desejada e clique em Carregar WABAs para sincronizar os templates já cadastrados na Meta.
3

Localize templates específicos

Use os filtros de Status (Aprovado/Pendente/Rejeitado), Categoria (Marketing/Utilidade/Autenticação) e Idioma, a busca por nome ou ID e as opções Ordenar por e Agrupar por. Cada card mostra nome, idioma, ID, status e categoria, com ações para Ver (preview completo, incluindo visualização no celular), editar ou excluir.
4

Crie um novo template

Abra a aba Criar Template e preencha as Informações Básicas: Conexão WABA, App ID, Nome do Template (apenas letras minúsculas, números e underscores), Idioma e Categoria.
5

Monte a mensagem

Em Componentes, clique em Adicionar Componente para montar a mensagem: Corpo (obrigatório, aceita variáveis {{1}}, {{2}}…), Cabeçalho (texto, imagem, vídeo ou documento; a mídia pode vir de Selecionar da galeria), Rodapé e Botões (Resposta Rápida, URL, Telefone, OTP, Cobrança (Pix, boleto ou link) ou Formulário (Flow)). A Prévia ao lado atualiza em tempo real.No botão Formulário (Flow), escreva o texto do botão (até 25 caracteres) e, em Formulário que o botão abre, escolha um dos formulários do WhatsApp (Flows) da conta da Conexão WABA escolhida. O botão abre o formulário no WhatsApp do cliente, sem sair da conversa. Segundo a ajuda Como funciona o botão de formulário, só dá para usar formulário publicado na Meta e da mesma conta do WhatsApp do canal: o rascunho aparece desativado (Rascunho: publique na Meta para usar), assim como o formulário que usa servidor próprio (Usa servidor próprio: não suportado aqui). Se o formulário não estiver na lista, use Digitar o ID e informe o ID do formulário (Escolher da lista volta para a lista). Com o formulário escolhido, o campo Tela de destino (opcional) define em que tela ele abre; sem escolha, abre na Tela inicial do formulário (padrão). Em Gerar com IA, o tipo Formulário (Flow) também pode ser marcado em Incluir Botões; depois de gerar, a tela avisa A IA criou um botão de formulário: escolha o formulário (Flow) dele antes de criar o template.
6

Use IA para gerar o conteúdo (opcional)

Use Gerar com IA para que o sistema crie o conteúdo a partir de uma descrição, ou Assistente IA para montar o template em etapas guiadas (segmento do negócio, tipo de campanha, opções e detalhes).
7

Submeta para aprovação

Clique em Criar Template para submeter à aprovação da Meta.
8

Se a tela recusar o template, corrija o que o aviso indica

Se faltar algo, o template não é enviado à Meta e a tela mostra o motivo no lugar de um erro genérico: Informe o nome do template., Escolha a categoria do template (Marketing, Utilidade ou Autenticação)., Escolha o idioma do template., O template precisa de um corpo (o texto da mensagem)., O bloco de botões está vazio: adicione ao menos um botão ou remova o bloco., Botão de link sem endereço: informe a URL., Botão de ligação sem número: informe o telefone., Há botão sem texto: informe o texto de cada botão., Botão de formulário sem texto ou com mais de 25 caracteres: informe o texto do botão., Botão de formulário sem formulário: escolha o formulário (Flow) na lista ou digite o ID. ou Cabeçalho de imagem, vídeo ou documento sem arquivo: escolha o arquivo de exemplo. Corrija o que o aviso indica e clique de novo em Criar Template (na edição, Salvar Template). Se aparecer Não foi possível enviar o arquivo do cabeçalho à Meta. Tente de novo ou escolha outro arquivo., tente de novo ou troque o arquivo do cabeçalho. Quando é a própria Meta que recusa, a tela mostra o motivo informado por ela.
Benefícios e quando usar: use Templates sempre que precisar contatar um cliente proativamente (confirmação de agendamento, cobrança, aviso de pedido) fora da janela de 24 horas de conversa gratuita, ou para campanhas de marketing autorizadas via WhatsApp oficial.
Os templates da categoria Marketing saem sozinhos pela Marketing Messages API da Meta quando a conta aceitou os termos; os demais seguem pelo envio comum. Veja a seção “Marketing Messages API: termos e templates de marketing” em Canais oficiais da Meta.
Ao enviar um template aprovado com cabeçalho de imagem, vídeo ou documento (no atendimento, em Nova Conversa, nos Comunicados, nas Campanhas, no Funil e no Kanban, na Agenda Sistema, na Agenda Mensagens, no Chat Flow, no Agendamento Público e nos templates de despedida e de aniversário do canal), informe o endereço da mídia do cabeçalho ou, quando a tela oferece, escolha um arquivo da galeria. Abaixo do campo, a tela mostra o que é aceito: Imagem JPG ou PNG, até 5 MB., Vídeo MP4, até 16 MB. ou Documento PDF ou do Office, até 100 MB., seguido de Prefira um arquivo da galeria ou um endereço público que abra rápido.
Se, ao carregar a lista de templates (botão Carregar WABAs, na sub-aba Templates WABA, ou na lista de templates das Análises da aba Uso & Limites), aparecer o aviso do erro 80008 (A Meta limitou temporariamente as consultas desta conta do WhatsApp…), a Meta limitou as consultas da conta: aguarde o horário informado no aviso e tente de novo. Veja a seção “Consultas pausadas pela Meta (erro 80008)” em Canais oficiais da Meta.
Templates ficam com status Pending após a criação e precisam de aprovação da Meta antes de poderem ser usados: a aprovação costuma levar minutos para categorias de utilidade e até algumas horas para marketing.
O nome do template não pode ser alterado depois de criado. Se precisar mudar o nome, é necessário excluir e criar um novo.
Templates do Facebook Messenger devem ter conteúdo utility/transacional: conteúdo promocional não é aceito nessa categoria. Embora seja possível criar templates de Utilidade simples diretamente pelo PanÐá Zap via Graph API, para necessidades mais avançadas ou outras categorias de template do Facebook/Messenger, a Meta recomenda o gerenciamento direto pelo Gerenciador de Negócios da Meta.