Skip to main content
Quem usa: Administrador. 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 realiza a autenticação via 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, clique em Configurações e selecione a aba Integrações Meta (também acessível pelo caminho Configurações → Integrações → Meta).
Esta tela é diferente da tela de Canais, que é onde um número, perfil ou página é conectado pela primeira vez. A tela Integrações Meta serve para gerenciar as contas e aplicativos Meta que já foram conectados, além de 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: esta é a porta de entrada obrigatória sempre que a empresa quiser 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 é sempre: (1) autenticar em Login/OAuth, (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 exatamente 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

Acesse Configurações → Integrações Meta → Contas Meta → Login / OAuth.
2

Escolha o Aplicativo

No campo Aplicativo, escolha entre as duas opções disponíveis:
  • OAuth TechProvider: selecione o aplicativo nativo do PanÐá Zap na lista. O sistema gerencia as credenciais automaticamente via proxy OAuth, sem necessidade de nenhuma configuração manual. É a opção padrão e mais simples para a grande maioria das empresas.
  • App próprio: use apenas se sua empresa for um Tech Provider aprovado pela Meta e já possuir um aplicativo próprio cadastrado no Meta Developers. Nesse caso, preencha manualmente o App ID (ID do aplicativo no Meta Developers), a Versão da API (versão da Graph API a ser usada, por exemplo v19.0) e o ID de Configuração (ID de configuração do Embedded Signup).
3

Faça login com o Facebook

Com o aplicativo selecionado, clique em Login com Facebook.
4

Autorize as permissões

Na janela pop-up da Meta que se abre, autorize as permissões solicitadas para WhatsApp, Instagram e Facebook.
5

Verifique o status

Após o retorno, clique em Verificar Status para confirmar que o token foi gerado com sucesso (o status deve indicar “Success”).
Benefícios e quando usar: é sempre o primeiro passo antes de configurar qualquer canal oficial Meta. Sem essa autenticação concluída, as sub-abas WhatsApp, Instagram e Facebook não conseguem operar.
O OAuth precisa estar habilitado no nível Super Admin antes de esta tela funcionar para o seu tenant. Se o botão “Login com Facebook” não responder, ou se os canais não aparecerem depois da autenticação, isso normalmente indica que o OAuth ainda não foi habilitado para o seu tenant pela equipe que administra a plataforma (é preciso solicitar a habilitação, já que essa etapa fica em uma tela de nível Super Admin, fora do alcance do Administrador do tenant).
Para o passo a passo completo de como conectar um número de WhatsApp Oficial via OAuth (incluindo o fluxo de coexistência com um app já usado no WhatsApp Business), consulte o tutorial dedicado sobre WhatsApp Oficial/OAuth Login na central de ajuda.

​
Contas Meta: WhatsApp

Quem usa: Administrador. Os dados de faturamento e limites de envio aqui exibidos também são úteis para o Supervisor acompanhar a saúde da operação (por exemplo, antes de disparar uma campanha grande). O que é: a sub-aba WhatsApp centraliza o gerenciamento completo dos números oficiais (WABA) conectados ao sistema: registro de telefones, configuração de webhooks, perfil do número, limites de envio e diagnóstico da conexão. Como configurar / usar:
1

Acesse a sub-aba WhatsApp

Acesse Configurações → Integrações Meta → Contas Meta → WhatsApp.
2

Selecione a Conexão WABA

No seletor Conexão WABA no topo da tela, escolha qual número gerenciar (o seletor mostra o WABA ID e o telefone de cada conexão cadastrada).
3

Confira as Informações da Conexão

Na aba Operação, confira o painel Informações da Conexão, que mostra Nome, Status (CONNECTED/DISCONNECTED), WABA ID, Versão da API e o tipo de autenticação (App próprio ou OAuth TechProvider).
4

Registre um número novo (se necessário)

Expanda a seção Telefone e use Registrar Telefone (inicia a verificação via código SMS ou chamada de voz) seguido de Verificar Código.
5

Configure os Webhooks

Expanda Webhooks e use Configurar Webhook (define URL e token de verificação do webhook principal) e, se necessário, Webhook Secundário (para redundância ou integrações específicas).
6

Ajuste Perfil & SIP

Use Atualizar Perfil para editar nome, foto e descrição do número no WhatsApp Business, Configurar SIP para habilitar chamadas de voz via protocolo SIP, e Ativar chamadas WebRTC para permitir chamadas de voz pelo navegador.
7

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

Clique em Diagnosticar conexão: o painel de diagnóstico verifica o Token de acesso (validade e permissões) e o Ticket de ativação (confirma se o número está ativado no sistema). Se houver falhas, use os botões Refazer teste, Revalidar webhook ou Reconectar canal conforme indicado.

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

  • Faturamento: defina a data de início e fim e clique em Carregar WABAs para ver o custo das conversas WABA no período, direto da Business Manager.
  • Análises: selecione até 10 templates, defina o período e clique em Carregar Métricas para ver entrega e leitura 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 (incluindo a economia gerada pelo Modo Híbrido e a projeção de custos do novo modelo de cobrança da Meta, em vigor a partir de outubro de 2026) fica na sub-aba Custos, em Configurações → Integrações Meta → WhatsApp → selecione a conta → Custos. Essa tela mostra o histórico de mensagens enviadas no período, quantas saíram por uma eventual conexão híbrida (com a simulação do custo equivalente caso tivessem saído pela API oficial) e projeta quanto custaria no novo modelo de cobrança, útil para estimar o impacto financeiro sem depender de planilhas externas.

​
Alterar origem dos webhooks

Use o botão Alterar origem para escolher entre App Meta (App Próprio) (webhooks entregues diretamente pelo app do licenciado) e App Meta Oauth (App TechProvider) (webhooks entregues via proxy do PanÐá Zap). Após salvar, sempre revalide o webhook (Revalidar Webhook WABA) para que a Meta reconheça o novo destino. 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.
O tier e o “quality rating” (qualidade) atuais não são retornados pela Graph API; para consultá-los é necessário acessar o Meta Business Suite ou o WhatsApp Manager diretamente. 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 autenticação OAuth já deve estar concluída na sub-aba Login/OAuth.
2

Acesse a sub-aba Instagram

Acesse Configurações → Integrações Meta → Contas Meta → Instagram.
3

Selecione o perfil

Selecione o perfil no menu suspenso Contas do Instagram.
4

Verifique a conta

Clique em Verificar Conta.
5

Confira o status da conexão

Confira o painel Informações da Conexão (Nome, Status, ID, tipo de autenticação). O status precisa constar como CONNECTED.
6

Ajuste a conexão se necessário

Se necessário, use Revalidar webhook, Alterar origem (App Próprio ou TechProvider) ou Diagnosticar conexão (verifica token e ticket de ativaçã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 CONNECTED, nenhuma mensagem direta ou menção em Stories chega ao sistema.
O webhook do Instagram usado pelo modo TechProvider aponta para um endpoint dedicado do proxy oficial da integração (https://oauth.techprovider.com.br/instagram-webhook); a chave secreta desse webhook é gerenciada automaticamente pela plataforma quando você usa a opção TechProvider. Não é necessário (nem recomendado) copiá-la 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 autenticação OAuth já deve estar concluída em Login/OAuth.
2

Acesse a sub-aba Facebook

Acesse Configurações → Integrações Meta → Contas Meta → Facebook.
3

Selecione e verifique a Página

Selecione a Página no menu suspenso Páginas do Facebook 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, tipo de autenticação).
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, 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, o webhook do Messenger no modo TechProvider aponta para um endpoint dedicado (https://oauth.techprovider.com.br/messenger-webhook) com chave secreta gerenciada automaticamente pela plataforma; não precisa ser copiada 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 de backend da integração com a Meta: URLs de webhook, conformidade BSUID, token de acesso permanente à API e verificação da conta WABA. Como configurar / usar:
1

Acesse a aba Configurações

Acesse Configurações → Integrações Meta → Configurações.
2

Confira as URLs de Webhook

Veja os endereços que recebem notificações da Meta para cada canal (WABA, Instagram e Messenger). Use o ícone de copiar ao lado de cada URL.
Essas URLs só precisam ser cadastradas manualmente no Meta Developers se você usa um App próprio. Se você usa o App TechProvider (OAuth PanÐá Zap), as URLs já são configuradas automaticamente pelo proxy, sem necessidade de nenhum cadastro manual.
3

Decida sobre o BSUID Estrito

Em BSUID Estrito, decida se ativa o “modo estrito BSUID”: configuração de conformidade com a especificação Meta de 2026, que faz o sistema usar o campo dedicado recipient (BSUID) para mensagens endereçadas a destinatários com username privado.
4

Configure o Token Meta

Cole e salve o token de acesso permanente da API (botão Salvar Token) ou gere um novo (Gerar Novo Token). Use os ícones de olho/copiar para visualizar e copiar o token salvo.
5

Faça a Verificação WABA

Preencha WABA ID, Versão da API e WABA Token e clique em Verificar BM para confirmar que a Business Manager está corretamente configurada.
Benefícios e quando usar: use a Verificação WABA sempre que suspeitar de problemas de autenticação ou logo após atualizar credenciais: o resultado indica se a Business Manager está verificada e se a versão da API é compatível.
Mantenha o BSUID Estrito desativado até que a Meta libere oficialmente (GA, ou General Availability) o envio por BSUID no seu portfólio. Ativar antes do prazo não muda o comportamento atual de envio e pode causar inconsistências.
Um token expirado ou inválido interrompe o recebimento e envio de mensagens em todos os canais oficiais conectados. Por isso, mantenha o Token Meta sempre atualizado. É uma das causas mais comuns de “canal parou de funcionar do nada”.

​
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 por conversa iniciada, com valores que variam conforme a categoria (Marketing, Utilidade, Autenticação) e o país do destinatário.
Como configurar / usar:
1

Acesse a aba Templates

Acesse Configurações → Integrações Meta → Templates.
2

Sincronize os templates existentes

Na sub-aba Templates WABA, 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 (Approved/Pending/Rejected), Categoria (Marketing/Utility/Authentication), Idioma, Busca e Ordenação/Agrupamento. 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

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

Monte a mensagem

Clique em + Adicionar Componente para montar a mensagem: Corpo (obrigatório, aceita variáveis {{1}}, {{2}}…), Cabeçalho (texto, imagem, vídeo ou documento), Rodapé e Botões (resposta rápida, URL ou ligação telefônica). A Prévia ao lado atualiza em tempo real.
6

Use IA para gerar o conteúdo (opcional)

Use o botão Gerar com IA se quiser que o sistema crie o conteúdo do template a partir de uma descrição.
7

Submeta para aprovação

Clique em Criar Template para submeter à aprovação da Meta.
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.
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 UTILITY 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.