Integrações: receber leads por API, avisar o seu CRM por webhook e devolver conversões à Meta
A área Integrações do painel serve para ligar o painel aos outros sistemas da empresa: receber leads por API com primeiro contato automático pelo WhatsApp, avisar o seu CRM por webhook a cada passo do lead, devolver as conversões do funil para os anúncios da Meta e receber os pedidos de venda.
Quando aparece: O item Integrações aparece para o dono e para o administrador da conta. A Entrada de leads, os Webhooks, as Entregas e os Pedidos existem em toda conta; o primeiro contato automático precisa de uma conta do WhatsApp conectada e de um modelo de mensagem aprovado pela Meta. A aba Conversões pode avisar que ainda não está disponível na conta. O atalho para os webhooks de entrada só aparece com o módulo Base avançada ativo.
Quem pode usar
Papel
O que vê e faz
Dono
Faz tudo: cria, edita, pausa, reativa e exclui integrações, gera chaves, envia lead de teste, ajusta e salva o primeiro contato, cria e testa webhooks, vê e reenvia entregas, conecta e liga as conversões da Meta e gera a chave de pedidos.
Admin
Vê as integrações, os números, o registro de entradas, a gaveta de cada entrada e a tela do primeiro contato, mas sem os botões de criar, editar, pausar, gerar chave ou enviar teste, e sem a barra de salvar no primeiro contato. Nas abas Webhooks e Entregas vê o aviso de que elas ficam com o dono da conta. Em Conversões vê a configuração e o registro, mas não liga o envio, não troca o token e não envia teste.
Atendente
Não vê Integrações no menu: os dados desta área ficam fechados para o papel de atendente, e a tela do primeiro contato leva à tela de acesso negado.
Telas
Integrações
A tela Integrações serve para reunir, em cinco abas, tudo o que liga o painel a outros sistemas: Entrada de leads, Webhooks, Entregas, Conversões e Pedidos.
Endereço no painel: /app/integracoes
A tela Integrações na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Pelo item Integrações do grupo CONTA no menu lateral. Cada aba tem endereço próprio: abrir Integrações com a aba no fim do endereço (entrada, webhooks, entregas, conversoes ou pedidos) já mostra a aba certa, e atualizar a página volta na mesma aba. O aviso do sino sobre um webhook pausado também leva direto à aba Webhooks.
Cabeçalho da tela
O título, a frase de apoio e os botões que mudam conforme a aba aberta.
Botões e ações
Documentação da API
Na aba Entrada de leads, abre a documentação da API de entrada de leads para passar a quem programa o seu sistema. Conforme o endereço do painel, abre numa aba nova ou dentro do próprio painel.
Nova integraçãoDono
Na aba Entrada de leads, abre o assistente de quatro passos que cria uma integração e mostra a chave dela uma única vez.
Como receberDono
Na aba Webhooks, rola até o cartão Para quem vai programar o recebimento; sem nenhum webhook criado, abre o guia dos webhooks na Central de ajuda.
Novo webhookDono
Na aba Webhooks, abre o formulário para cadastrar um endereço que vai receber os avisos.
Ver os webhooksDono
Na aba Entregas, volta para a aba Webhooks.
Como funciona
Na aba Conversões, abre o guia das conversões na Central de ajuda.
Título Integrações e a frase Receber leads, avisar seus sistemas e medir anúncios.
Os botões do canto direito dependem da aba: Entrada de leads, Webhooks, Entregas e Conversões têm botões próprios; Pedidos não tem.
Abas da tela
A faixa de abas que troca o conteúdo sem sair da tela.
Botões e ações
Entrada de leads
Mostra as integrações que recebem leads por API, com o número de integrações ao lado do nome.
Webhooks
Mostra os endereços que recebem avisos do painel, com a quantidade de webhooks ao lado do nome (só para o dono).
Entregas
Mostra o registro de tudo o que saiu para os seus sistemas pelos webhooks.
Conversões
Mostra a configuração e o registro das conversões devolvidas aos anúncios da Meta. Leva o selo Novo.
Pedidos
Mostra a chave e o exemplo para o seu sistema enviar os pedidos de venda.
Com o foco numa aba, as setas para a direita e para a esquerda passam para a aba vizinha.
Em tela estreita a faixa de abas rola sozinha até a aba escolhida.
Aba Pedidos
Recebe as vendas do seu ERP, loja virtual ou outro sistema para alimentar o RFV do Monitor de sucesso.
Campos e filtros
URL de ingestão
O endereço para onde o seu sistema manda os pedidos, com o botão de copiar ao lado.
Chave de API (X-Api-Key)
A chave da conta para os pedidos, mostrada mascarada. Sem chave, aparece Nenhuma chave gerada.
Exemplo (curl)
Um exemplo pronto de envio de pedido, com a chave no lugar certo depois de gerada.
Botões e ações
Gerar chave
Cria a primeira chave de pedidos e mostra a chave inteira uma única vez, com o aviso para copiar na hora.
Gerar nova chave
Cria uma chave nova na hora, sem pedir confirmação, e a anterior deixa de funcionar no mesmo instante.
Copiar
Copia o endereço, a chave recém-gerada ou o exemplo.
Ver o guia passo a passo
Abre o guia de integração de pedidos numa aba nova. Só aparece quando o painel está no endereço da plataforma.
Cartão Receber pedidos: seu sistema empurra vendas e alimenta o RFV do Monitor.
O pedido é aceito de novo sem duplicar quando chega com o mesmo identificador externo; ele casa com o contato pelo telefone ou pelo e-mail.
Se a chave não carrega, a tela mostra Não foi possível carregar a sua chave de API e esconde o botão de gerar, para ninguém trocar sem querer a chave que está em uso.
Estados da tela
Carregando
Cada aba mostra blocos cinza no formato do conteúdo enquanto os dados chegam.
Se der erro
Cada aba tem a própria mensagem de falha, sempre com o botão Tentar de novo; os leads, avisos e conversões continuam funcionando, só a tela não carregou.
Entrada de leads
A aba Entrada de leads serve para criar integrações que recebem leads de outros sistemas por API, acompanhar cada lead que chegou e testar o caminho até o primeiro contato pelo WhatsApp.
Endereço no painel: /app/integracoes/entrada
A tela Entrada de leads na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Integrações, aba Entrada de leads (é a aba que abre por padrão). O botão Ver entradas da tela do primeiro contato volta para esta aba já com a integração escolhida e rolando até o registro.
Faixa de abertura
A explicação do caminho do lead, que pode ser escondida.
Botões e ações
Entendi
Esconde a faixa de abertura. O painel lembra a escolha para o seu usuário neste navegador.
Título Receba leads de qualquer sistema e responda em segundos.
O caminho do lead em seis etapas: Seu sistema, Entrada de leads, Primeiro contato, IA qualifica, Rodízio e Atendente.
Suas integrações
A grade com um cartão por integração e os números dos últimos 7 dias.
Botões e ações
Ver entradas
Escolhe a integração e rola até a lista Últimos leads recebidos.
EditarDono
Abre o assistente da integração com os dados atuais para mudar nome, origem, base legal, primeiro contato e destino. Não aparece na integração interna.
MaisDono
Abre o menu da integração. As setas para cima e para baixo andam entre os itens; Esc fecha e devolve o foco ao botão.
PausarDono
No menu Mais, pausa a integração: os envios do seu sistema passam a ser recusados até você reativar. Na integração interna, os pedidos entram no CRM sem primeiro contato.
ReativarDono
No menu Mais, volta a aceitar os leads da integração pausada.
Gerar nova chaveDono
No menu Mais, abre a confirmação para trocar a chave da integração.
ExcluirDono
No menu Mais, abre a confirmação para excluir a integração.
Cada cartão mostra o nome, a origem, a data de criação e o selo Ativa ou Pausada.
A chave aparece mascarada, com quando foi usada pela última vez ou ainda não usada. Integração interna, criada pela própria plataforma para um formulário de site, aparece como Sem chave.
Números dos últimos 7 dias: Recebidos, Novos, Já existiam e Recusados (em vermelho quando há recusa).
Quando o sistema mandou o mesmo lead de novo, aparece quantos reenvios repetidos foram ignorados, sem custo.
A linha do primeiro contato diz se está ligado, com o modelo e quem cobra pelo envio; parado, com o motivo em vermelho; ou desligado, quando a IA só fala depois que o lead escreve.
Clicar em qualquer parte do cartão que não seja botão escolhe a integração e troca o detalhe mostrado abaixo da grade.
Detalhe da integração escolhida
O cabeçalho do detalhe, com o nome da integração e a situação ao vivo.
Acima do nome, a etiqueta Receber leads por API (ou o formulário de origem, na integração interna).
Selo ao vivo: Recebendo, com o horário do último lead ou nenhum lead ainda; ou Pausada, os envios são recusados.
Como conectar
Tudo o que quem cuida do seu sistema precisa para mandar leads.
Campos e filtros
Endereço do envio
O endereço para onde o seu sistema manda cada lead. Ele aparece na tela e na documentação.
Chave da integração
A chave mascarada, só com o começo e o fim. Vai no cabeçalho X-Api-Key de cada envio; a chave completa só aparece quando é criada.
Exemplo de envio
Exemplo pronto em três abas: JSON, cURL e a Resposta que o sistema recebe.
Botões e ações
Copiar endereço do envio
Copia o endereço do envio.
Gerar novaDono
Abre a confirmação para gerar uma chave nova para esta integração.
JSON
Mostra o exemplo do corpo do lead.
cURL
Mostra o exemplo de chamada completa, pronto para testar no terminal.
Resposta
Mostra o que o seu sistema recebe de volta quando o lead entra.
Copiar o exemplo
Copia o exemplo da aba aberta.
Receber no formato do seu sistemaDono
Abre o diálogo para ligar os campos de um formato próprio do seu sistema aos campos do painel.
Documentação completa
Abre a documentação da API de entrada de leads.
Aviso Use a chave só de servidor para servidor: nunca coloque a chave no código do site ou do aplicativo.
Na integração interna, no lugar deste cartão aparece Como os pedidos chegam, com a página de origem, a base legal e o modelo usado, sem chave nem API.
Últimos leads recebidos
O registro de entradas da integração, que se atualiza sozinho.
Campos e filtros
Todos
Filtro por situação, com a contagem de cada grupo: Todos, Novos, Contatados, Responderam e Com problema.
Botões e ações
Novos
Mostra só os leads novos.
Contatados
Mostra os leads que receberam o primeiro contato.
Responderam
Mostra os leads que responderam ao primeiro contato.
Com problema
Mostra as entradas recusadas, bloqueadas, sem saldo ou com falha no envio.
Carregar mais
Traz as entradas mais antigas da lista.
Ver todas
No vazio de um filtro, volta ao filtro Todos.
Reativar integraçãoDono
Aparece quando a integração está pausada e nada chegou nos últimos 7 dias; reativa a integração ali mesmo.
Cada linha mostra o nome do lead (ou Entrada recusada), o telefone, a trilha do que aconteceu, o motivo quando houver, a situação e a hora.
As situações vêm escritas em português e coloridas: novo, agendado, na fila, contatado, respondeu, sem envio, bloqueado, não confirmado, falhou, sem saldo e recusado.
O lead de teste tem o selo Teste.
Linhas que chegam com a tela aberta entram destacadas e são anunciadas ao leitor de tela.
O rodapé diz quantas entradas estão à vista do total dos últimos 7 dias.
Gaveta da entrada
Abre ao clicar no nome de um lead do registro e mostra tudo o que chegou.
Botões e ações
Reenviar primeiro contato
Aparece quando o envio pode ser repetido. Mostra a confirmação com quem cobra o novo envio e, se a mensagem pode já ter chegado, pede para conferir no Inbox antes.
Reenviar agora
Confirma o reenvio: a mensagem sai em segundos para o lead.
Cancelar
Desiste do reenvio.
Abrir conversa
Abre a conversa do lead no Inbox.
Abrir ficha do lead
Abre a ficha do lead no CRM.
Entendi
Fecha a gaveta de uma entrada recusada.
Selos do resultado e da situação; quando há problema, um aviso com o motivo e o que fazer.
Origem: plataforma, campanha, conjunto, anúncio e o ID no seu sistema.
Dados recebidos: os campos extras que o sistema mandou; dado sensível aparece escondido.
Base legal: qual foi, de onde veio e a prova do aceite, quando existe.
Linha do tempo: cada passo do primeiro contato, com a hora.
A entrada recusada mostra só o motivo, a origem e o ID.
Enviar lead de teste
Manda um lead de verdade pela integração, marcado como teste, e mostra cada passo acontecendo.
Campos e filtros
Seu celularobrigatório
Aparece com o interruptor ligado: o número com DDD que recebe a mensagem do jeito que o lead recebe.
Botões e ações
Mandar o primeiro contato para o meu WhatsApp
Liga o envio do primeiro contato do teste para o seu celular. Usa um envio do modelo, com o custo do modelo quando a conta debita do saldo.
Enviar lead de teste
Envia o teste. Depois do primeiro, o botão passa a dizer Enviar outro teste.
Passos acompanhados ao vivo: Requisição recebida, Lead criado e marcado como teste, Primeiro contato enviado e Entregue no seu WhatsApp.
Quando a mensagem não sai, o passo diz Nada foi cobrado e o que falta fazer.
Abaixo dos passos aparece a Resposta da API, linha por linha.
Com a integração pausada, o teste avisa que é preciso reativar antes.
Só aparece para o dono, e não aparece na integração interna sem primeiro contato.
Primeiro contato automático
O resumo do primeiro contato da integração, ao lado do registro.
Botões e ações
Ajustar primeiro contato
Abre a tela Primeiro contato automático desta integração.
Selo Ligado ou Desligado.
Modelo com o nome e a categoria, Custo, Horário, Teto por dia, Teto do mês com modelos pagos e Recontato.
Últimos 7 dias: quantos responderam de quantos receberam a mensagem, com a barra da taxa.
Base legal padrão
Por que você pode falar com os leads desta integração.
Mostra a base escolhida no assistente e o resumo dela; se o sistema mandar a base legal de cada lead, vale a do lead.
Sem base padrão, aparece Sem base legal padrão: cada lead precisa trazer a base no campo legal_basis, ou é recusado.
Diálogo Nova integração
O assistente em quatro passos: Nome e origem, Base legal, Primeiro contato e Destino. O mesmo diálogo abre como Editar integração.
Campos e filtros
Nome da integraçãoobrigatório
Nome para reconhecer a integração depois; só você e o seu time veem. Enter no campo avança.
De onde vêm esses leads?
A origem: Anúncios da Meta, Outra plataforma de anúncios, Formulário do site, Portal ou marketplace ou Outro sistema. Cada escolha mostra uma explicação.
Por que você pode falar com essas pessoas?obrigatório
A base legal: Pediram para eu entrar em contato (Recomendado para anúncio), São meus clientes ou Já coletei o consentimento deles. A declaração fica registrada com o seu nome, a data e a hora em cada lead.
Conta do WhatsApp
A conta do WhatsApp que manda o primeiro contato; só as contas ativas aparecem.
Modelo aprovado
O modelo aprovado pela Meta usado na primeira mensagem. Modelo com mídia no cabeçalho ou sem preço confirmado aparece desabilitado, com o motivo.
Teto por dia
Quantas primeiras mensagens esta integração manda no máximo por dia.
Quadro do Funil
O quadro onde o cartão do lead nasce; o padrão vem marcado.
Coluna de entrada
A coluna do quadro onde o cartão nasce.
Etiquetas automáticas
Etiquetas que todo lead desta integração ganha. Já vem uma sugestão pela origem; Enter adiciona, Backspace no campo vazio tira a última.
Botões e ações
Anúncios da Meta
Escolhe a origem anúncios da Meta (a campanha, o conjunto e o anúncio vêm junto).
Outra plataforma de anúncios
Escolhe a origem de formulários de anúncio de outra plataforma.
Formulário do site
Escolhe a origem formulário do seu site ou página de lançamento.
Portal ou marketplace
Escolhe a origem portais e marketplaces do seu segmento.
Outro sistema
Escolhe qualquer outro sistema que faça uma chamada HTTP.
Mandar a primeira mensagem sozinho pelo WhatsApp
No passo 3, liga ou desliga o primeiro contato automático. Fica travado com a base São meus clientes, sem conta do WhatsApp conectada ou quando não dá para confirmar quem paga o envio.
Este sistema pode atualizar as etapas do funil
No passo 4, deixa a chave da integração mudar a etapa do lead, inclusive venda e perda. A venda marcada pelo sistema também vai para as conversões da Meta.
Receber no formato do seu sistema
No passo 4, abre o diálogo de formato próprio; o formato é salvo junto com a integração.
Voltar
Volta ao passo anterior.
Continuar
Confere o passo e avança. Sem nome, sem base legal ou sem modelo com o primeiro contato ligado, mostra o erro no campo.
Criar integração
No passo 4, cria a integração e mostra a tela Integração criada.
Salvar alterações
Na edição, salva só o que mudou; vale para os próximos leads, e a permissão de etapas vale na hora.
Copiar a chave
Na tela Integração criada, copia a chave, que não aparece de novo.
Copiar o endereço
Na tela Integração criada, copia o endereço do envio.
Enviar lead de teste
Na tela Integração criada, fecha o assistente e já dispara o teste da integração.
Concluir
Fecha o assistente e abre o detalhe da integração criada.
No passo 3, a prévia da mensagem no WhatsApp e a faixa de custo: quem cobra (a plataforma, debitando do saldo antes de cada envio, ou a Meta, direto no cartão da conta do WhatsApp) e o máximo por dia com o teto escolhido.
O horário de envio vem da conta e é ajustado depois, na tela do primeiro contato.
Com a base São meus clientes, o primeiro contato fica desligado: mensagem de marketing para cliente de contrato pede o consentimento dele.
Diálogo Receber no formato do seu sistema
Liga os campos de um exemplo real do seu sistema aos campos do painel.
Campos e filtros
Exemplo do seu sistema
Cole um exemplo completo do JSON que o seu sistema envia; o diálogo já abre com um exemplo e lê os campos.
Campos encontrados
Uma linha por campo do exemplo, com a escolha do destino: Não usar, Nome, Telefone, E-mail, ID no seu sistema, Campanha de anúncio, Conjunto, Anúncio ou Dado recebido.
Botões e ações
Encontrar campos
Lê o exemplo colado e sugere o destino de cada campo.
Salvar formato
Salva o formato: a integração passa a aceitar um lead por envio nesse formato. Exige algum campo ligado ao Telefone.
Cancelar
Fecha sem salvar.
Assim ficaria o lead: a prévia com Nome, Telefone, E-mail, ID no seu sistema, Origem e os dados recebidos.
Sem telefone ligado, aparece o aviso de que o lead seria recusado.
Diálogo Gerar nova chave?
Confirma a troca da chave da integração e mostra a chave nova uma única vez.
Botões e ações
Gerar nova chave
Gera a chave nova; a atual para de funcionar na hora.
Copiar a chave nova
Copia a chave nova para colar no seu sistema.
Já guardei a chave
Fecha o diálogo e lembra de trocar a chave no seu sistema.
Cancelar
Mantém a chave atual.
Até a chave nova ser trocada no sistema, os envios dele são recusados; os leads que já chegaram continuam no painel.
Diálogo Excluir esta integração?
Confirma a exclusão da integração.
Botões e ações
Excluir integração
Exclui: a chave para de funcionar na hora. Os leads e as entradas que já chegaram continuam no painel.
Cancelar
Desiste de excluir.
Estados da tela
Carregando
Três cartões cinza na grade e dois blocos do detalhe enquanto as integrações chegam.
Sem nada ainda
Receba leads de qualquer sistema: a explicação, o botão Nova integração (só para o dono) e o botão Ver a documentação. No registro, Esperando o primeiro lead até chegar o primeiro.
Se der erro
Não conseguimos carregar as integrações agora, com Tentar de novo; os leads continuam chegando normalmente.
Integração pausada sem nada nos últimos 7 dias
Nada chegou nos últimos 7 dias, com o botão Reativar integração.
Filtro do registro sem resultado
Nenhuma entrada com esta situação, com o botão Ver todas.
Primeiro contato parado
O cartão da integração mostra Primeiro contato parado, em vermelho, com o motivo.
Primeiro contato automático
A tela Primeiro contato automático serve para ligar e ajustar a primeira mensagem que sai sozinha pelo WhatsApp quando um lead chega por uma integração: conta, modelo aprovado, variáveis, horário, recontato, teto por dia e custo.
Endereço no painel: /app/integracoes/entrada/‹…›/primeiro-contato · Quem usa: Dono, Admin
A tela Primeiro contato automático na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Em Integrações, aba Entrada de leads, escolha a integração e clique em Ajustar primeiro contato.
Trilha e cabeçalho
Onde você está e o atalho para o registro da integração.
Botões e ações
Integrações
Na trilha, volta para a aba Entrada de leads.
Ver entradas
Volta para a aba Entrada de leads com a integração escolhida e rola até o registro.
Trilha Integrações, Entrada de leads e o nome da integração.
Acima do título, o nome da integração.
Aviso de saldo insuficiente
Aparece quando há leads esperando a primeira mensagem por falta de saldo.
Botões e ações
Recarregar saldo
Abre a Carteira para recarregar.
O primeiro contato parou: saldo insuficiente, com quantos leads estão esperando. Ao recarregar, as mensagens saem sozinhas para quem chegou nas últimas 24 horas.
Números dos últimos 7 dias
Enviados · 7 dias, com a variação contra a semana anterior.
Responderam, com a porcentagem dos contatados que responderam e foram assumidos pela IA.
Até a mensagem: o tempo típico entre o lead chegar e a mensagem sair.
Gasto · 7 dias: o que foi cobrado na semana, ou o aviso de que a Meta cobra na conta do WhatsApp.
Mandar a primeira mensagem sozinho
O interruptor geral do primeiro contato desta integração.
Botões e ações
Mandar a primeira mensagem sozinhoDono
Liga ou desliga o envio automático. Desligado, a IA só fala quando o lead escrever, e os ajustes abaixo ficam apagados.
Na integração interna sem primeiro contato, a frase diz que quem chama é o comercial e o interruptor fica travado.
Sem conta do WhatsApp conectada, aparece o aviso com o link para Conexões.
Conta e modelo
A conta do WhatsApp e os modelos aprovados pela Meta nesta conta.
Campos e filtros
Conta do WhatsApp
A conta que envia; a lista mostra quando é a padrão e quando é conta própria (a Meta cobra direto). Trocar de conta atualiza os modelos dela.
Modelo aprovado
Um cartão por modelo, com título, nome técnico, categoria, o texto e quem cobra. Modelo que não pode sair no primeiro contato aparece apagado, com o motivo.
Botões e ações
Atualizar
Busca de novo a lista de modelos aprovados na Meta.
Criar modelo
Abre a criação de um modelo de mensagem, quando a conta não tem nenhum aprovado.
Atualizar lista
Busca de novo os modelos, no vazio da lista.
Tentar de novo
Repete a atualização dos modelos quando ela falhou; o primeiro contato continua com o modelo escolhido.
Linha Lista atualizada com a Meta, com há quanto tempo.
Quando o modelo escolhido foi pausado ou apagado na Meta, aparece O primeiro contato parou, com o motivo.
Na integração interna, o cartão só mostra a conta, o modelo e o que vai em cada espaço, com o selo de que são definidos pelo formulário: não se troca por esta tela.
O que vai em cada espaço da mensagem
Aparece quando o modelo tem variáveis: cada espaço numerado vira um dado do lead.
Campos e filtros
Preencher ‹n› com
O dado que entra no espaço: Primeiro nome, Nome completo, Nome da empresa, Nome da persona, Nome da campanha de anúncio ou Campo recebido.
Se faltar, usar
O texto usado quando o lead não tem o dado. Em branco, a mensagem não sai para quem não tiver o dado, e o motivo fica no registro.
Nome do campo recebido
Com Campo recebido, a chave que o seu sistema manda dentro de fields.
Com o nome da campanha, um aviso lembra que o lead vê esse texto: use só se ele for apresentável.
Regras de envio
Para a mensagem chegar na hora certa, para a pessoa certa, sem gastar à toa.
Campos e filtros
Das
A hora de início do envio, de 5h a 14h.
às
A hora de fim do envio, de 16h a 23h. O fuso da conta aparece ao lado.
Teto por dia
Mensagens por dia nesta integração, de 1 a 5.000. Passou do teto, o resto sai no dia seguinte e você recebe um aviso.
Botões e ações
‹n› dias
Escolhe por quantos dias a mesma pessoa não recebe outra primeira mensagem: 15, 30, 60 ou 90 dias, por qualquer integração.
Diminuir o teto em 50
Baixa o teto por dia em 50.
Aumentar o teto em 50
Sobe o teto por dia em 50.
Ajustar
Abre a parte de cobrança das Configurações, onde fica o teto do mês.
Só para quem tem base legal e Nunca interrompe o seu time: regras com o selo Sempre ligada.
A barra das 24 horas mostra o horário escolhido e a hora de agora; a frase abaixo diz se quem chegar agora recebe em segundos ou em qual horário.
Teto do mês com modelos pagos: vale para a conta toda, somando primeiros contatos e cadências, com a barra do quanto já foi usado.
Aviso de que mensagens de marketing em volume alto podem reduzir a qualidade do número na Meta.
Como o lead recebe
A prévia da mensagem no WhatsApp com um lead de exemplo.
Botões e ações
Lead sem nome
Troca a prévia para um lead de exemplo sem nome, para ver o texto de quando o dado falta.
Ver a IA assumir a conversa
Simula o lead respondendo e a IA assumindo a conversa. A resposta mostrada é ilustrativa. Depois vira Recomeçar a prévia.
A bolha com os espaços já preenchidos e os botões do modelo.
Com o primeiro contato desligado, a prévia fica coberta pelo aviso Primeiro contato desligado.
Quando a mensagem não sairia para o lead de exemplo, aparece o aviso com o dado que falta.
Custo por envio
O preço do modelo nesta conta e quanto o saldo aguenta.
Campos e filtros
Leads por mês
Régua para simular o volume do mês; abre perto do que chegou no último mês por esta integração.
O valor por lead, debitado antes de cada envio; se a Meta recusar na hora, o valor volta para o saldo.
Estimativa por mês e o máximo por dia com o teto escolhido.
Saldo atual e por cerca de quantos dias ele dura no ritmo estimado, contando a franquia do mês.
Em conta própria do WhatsApp, o cartão diz que não há custo na plataforma: a Meta cobra pela tabela dela.
Barra de alterações não salvas
Aparece presa ao pé da tela quando algo mudou.
Botões e ações
SalvarDono
Salva o primeiro contato; vale para os próximos leads desta integração.
DescartarDono
Volta para o que estava salvo.
Estados da tela
Carregando
Números e cartões cinza com o nome da integração ainda em branco.
Se der erro
Não conseguimos carregar o primeiro contato agora, com Tentar de novo; os leads continuam recebendo a mensagem normalmente.
A integração foi excluída
Esta integração não existe mais, com o botão Ver integrações.
A conta não tem modelo aprovado
Nenhum modelo aprovado nesta conta, com Criar modelo e Atualizar lista.
Quem abre é administrador
Tudo aparece, mas o interruptor e os ajustes ficam travados e a barra de salvar não aparece.
API de entrada de leads
A tela API de entrada de leads é a documentação, dentro do painel, para quem programa o sistema que vai mandar leads: autenticação, campos, origem, base legal, respostas, erros e motivos de recusa.
Endereço no painel: /app/integracoes/documentacao
A tela API de entrada de leads na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Pelos botões Documentação da API, Documentação completa e Ver a documentação da aba Entrada de leads, quando o painel está num endereço de marca própria; no endereço da plataforma, os mesmos botões abrem a página pública numa aba nova.
Topo da documentação
Botões e ações
Enviar o primeiro lead
Pula para a seção Enviar leads.
Ver os campos
Pula para a seção Campos do lead.
Selo Documentação da API · versão 1, a data de atualização e os selos Chave por integração, JSON · UTF-8 e Mensagens em português.
Um exemplo de lead enviado sendo escrito na hora, com a resposta de lead criado.
O endereço da API é o da sua conta e aparece nos exemplos da própria tela.
Nesta página
O índice que acompanha a leitura, com uma barra de progresso no alto.
Botões e ações
Voltar ao topo
Volta ao começo da documentação.
Começando: Visão geral, Autenticação e Enviar leads.
Referência: Campos do lead, Origem do anúncio, Base legal (LGPD), Primeiro contato, Resposta, Erros, Motivos de recusa e Atualizar a etapa.
Boas práticas: Repetidos e reenvio, Limites, Formato do seu sistema e Depois que o lead entra.
Em tela estreita o índice vira uma lista que abre e fecha.
Cada título de seção tem um botão que copia o link direto para ela.
Exemplos de código
Botões e ações
cURL
Mostra o envio em cURL.
JavaScript
Mostra o envio em JavaScript.
Python
Mostra o envio em Python.
PHP
Mostra o envio em PHP.
Tudo certo
Mostra a resposta de quando o lead entrou.
Com recusa
Mostra a resposta com um lead recusado e o motivo.
Chave inválida
Mostra a resposta de chave inválida.
Muitas chamadas
Mostra a resposta de quando o sistema chama demais.
Copiar o endereço
Copia o endereço do envio.
Copiar os cabeçalhos
Copia os cabeçalhos de autenticação.
Copiar o exemplo
Copia o exemplo da linguagem aberta.
Copiar o lead completo
Copia o exemplo de lead com todos os campos.
Copiar a resposta
Copia a resposta aberta.
Copiar o exemplo de atualizar a etapa
Copia o exemplo de mudança de etapa pelo seu sistema.
Esta página ajudou?
Campos e filtros
O que faltou?
Depois de Não, um campo para contar o que você procurava e não achou.
Botões e ações
Sim
Registra que a página ajudou.
Não
Abre o campo O que faltou?.
Enviar
Manda o comentário; a equipe lê cada mensagem.
Abrir Integrações no painel
No fim da página, volta para a aba Entrada de leads.
Webhooks de saída
A tela Webhooks de saída é a documentação, dentro do painel, para quem programa o recebimento dos avisos: como receber, como conferir a assinatura, o envelope, os eventos, os cabeçalhos, as novas tentativas e a pausa automática.
Endereço no painel: /app/integracoes/documentacao/webhooks
A tela Webhooks de saída na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Pelo botão Documentação dos webhooks do cartão Para quem vai programar o recebimento, na aba Webhooks, quando o painel está num endereço de marca própria; no endereço da plataforma, o botão abre a página pública numa aba nova.
Topo da documentação
Botões e ações
Conferir a assinatura
Pula para a seção que explica como conferir a assinatura do aviso.
Ver os eventos
Pula para a lista de eventos.
Selo Documentação dos webhooks · versão 1, a data de atualização e os selos de eventos, JSON · UTF-8 e assinatura.
Um exemplo de aviso de lead qualificado chegando ao seu sistema.
Nesta página
Botões e ações
Voltar ao topo
Volta ao começo da documentação.
Node.js
Mostra a conferência da assinatura em Node.js.
Começando: Visão geral, Receber um aviso e Conferir a assinatura.
Referência: Envelope, Os 13 eventos, Dados pessoais e Cabeçalhos.
Boas práticas: Novas tentativas, Pausa automática, Ordem e duplicidade, Evento de teste e Registro de entregas.
Exemplos de conferência da assinatura em Node.js, Python e PHP.
Final da página
Botões e ações
Sim
Registra que a página ajudou.
Não
Abre o campo O que faltou?.
Abrir Webhooks no painel
Volta para a aba Webhooks de Integrações.
Webhooks
A aba Webhooks serve para cadastrar os endereços do seu CRM ou outro sistema que recebem um aviso assinado na hora em que um lead chega, qualifica, vai para um atendente, muda de etapa ou vira venda, e a aba Entregas mostra cada aviso enviado com a resposta.
Endereço no painel: /app/integracoes/webhooks
A tela Webhooks na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Integrações, aba Webhooks. A aba Entregas fica ao lado; o botão Abrir o registro completo da gaveta de um webhook abre a aba Entregas já filtrada nele.
Atalho para os webhooks de entrada
Aparece só com o módulo Base avançada ativo.
Cartão Webhooks de entrada · na Base avançada: leva aos avisos que o seu sistema manda para o painel, com regras de quando chegar X, faça Y.
Números dos webhooks
Entregues · 7 dias, com a variação sobre a semana passada.
Taxa de entrega das entregas dos últimos 7 dias; quando parte das falhas veio de um endereço já pausado, a frase diz quantas.
Resposta média dos sistemas que recebem.
Tentando de novo, com o horário da próxima tentativa ou nenhuma na fila.
Cartão do webhook
Um cartão por endereço cadastrado.
Botões e ações
Ativo
Interruptor que pausa ou ativa o webhook. Pausado, nada é enviado, e os eventos desse período não ficam na fila.
Reativar
No aviso de pausa automática, volta a enviar os próximos avisos; as falhas se reenviam pelo registro de entregas.
Ver as falhas
No aviso de pausa automática, abre a gaveta de entregas já em Falharam.
Entregas
Abre a gaveta com as entregas deste webhook.
Testar
Abre o diálogo Enviar evento de teste. Com o webhook pausado, fica desabilitado com a dica Ative o webhook para testar.
Editar webhook ‹endereço›
Botão de lápis: abre o formulário de edição do webhook.
Excluir webhook ‹endereço›
Botão de lixeira: abre a confirmação de exclusão.
Ver na lista de entregas
No resultado do teste, abre a gaveta de entregas.
O endereço dividido em domínio e caminho.
Selo Ativo, Pausado ou Pausado automaticamente; selo Com dados pessoais ou Sem dados pessoais; quem criou e quando.
Os eventos que o endereço recebe, em etiquetas; os que passam de cinco ficam num +N com a lista ao passar o mouse.
Saúde dos últimos 7 dias: a porcentagem entregue, as falhas, o último envio com Entregue, Não entregue, Tentando de novo ou Nunca disparado, e a barra (vermelha quando falha mais do que entrega).
O resultado do teste aparece no próprio cartão: Enviando o teste, Entregue com o tempo, Não entregue com o motivo, ou Aguardando.
Para quem vai programar o recebimento
O cartão para mostrar à equipe que cuida do seu CRM.
Botões e ações
Documentação dos webhooks
Abre a documentação completa dos webhooks de saída.
Copiar os cabeçalhos de cada aviso
Copia o exemplo dos cabeçalhos.
Como saber que o aviso é seu: ler os cabeçalhos X-Webhook-Timestamp e X-Webhook-Signature-V2, calcular a assinatura com o segredo e comparar, e usar X-Webhook-Id para não processar o mesmo aviso duas vezes.
Cabeçalhos de cada aviso, em exemplo.
Se o seu sistema não responder: a trilha das novas tentativas, até a plataforma parar; uma resposta de sucesso conta como entregue.
Depois de muitos avisos seguidos sem sucesso, o webhook é pausado e você é avisado por e-mail e no sino; tudo fica no registro com o botão Reenviar.
Diálogo Novo webhook
Diga para onde mandar e o que avisar; o mesmo diálogo abre como Editar webhook.
Campos e filtros
Endereço que vai receberobrigatório
O endereço seguro (https) que o seu sistema reservou para os avisos. Endereço sem https, inválido ou de rede interna é recusado com a explicação.
O que avisarobrigatório
Os eventos em grupos (Leads, Funil, Atendimento e Pedidos), com a contagem de marcados. Num webhook novo já vêm marcados lead criado, qualificado, atribuído, mudou de etapa, venda e perdido.
Segredo de assinatura
Na edição, o segredo mascarado. Ele só aparece inteiro uma vez, quando o webhook é criado.
Botões e ações
Marcar todos
Marca todos os eventos do grupo; com o grupo todo marcado, vira Desmarcar.
Enviar dados pessoais
Quando aparece, liga o envio de nome, telefone, e-mail e resumo da conversa para este endereço, depois de uma confirmação. Desligar é direto.
Gerar segredo novo
Na edição, pede confirmação e gera um segredo novo; o atual para de valer na hora.
Manter o atual
Desiste de gerar o segredo novo.
Excluir
Na edição, abre a confirmação de exclusão.
Cancelar
Fecha sem salvar.
Criar webhook
Cria o webhook e mostra a tela Webhook criado, com o segredo de assinatura.
Salvar alterações
Salva; as mudanças valem a partir do próximo aviso.
Copiar o segredo de assinatura
Na tela Webhook criado, copia o segredo, que não aparece de novo.
Enviar evento de teste
Na tela Webhook criado, abre o teste do webhook.
Concluir
Fecha e leva o foco ao botão Testar do cartão novo.
Cada evento tem o nome em português e uma descrição: Lead criado, Lead qualificado, Lead quente, Pediu para não receber mensagens, Dados apagados (LGPD), Mudou de etapa, Venda (ganho), Perdido, Negócio reaberto, Atribuído a um atendente, Transbordo para humano, Primeiro contato e Pedidos importados.
Sem o interruptor de dados pessoais, o formulário avisa que o sistema recebe só identificadores: ID do lead, etapa, nota, valores e campos do negócio que não são sensíveis.
Cada aviso sai assinado no cabeçalho X-Webhook-Signature-V2.
Diálogo Ligar dados pessoais?
A confirmação antes de ligar dados pessoais num webhook.
Botões e ações
Manter desligado
Fecha sem ligar.
Ligar dados pessoais
Liga só para este webhook; a mudança fica na auditoria com quem ligou e quando.
Mostra o que passa a sair no aviso Lead qualificado, com as linhas novas destacadas.
Diálogo Enviar evento de teste
Manda um exemplo com dados fictícios para o endereço.
Campos e filtros
Evento
Só os eventos que o webhook recebe, em grupos, com a descrição do escolhido.
Botões e ações
Copiar corpo
Copia o corpo do exemplo que vai sair.
Enviar teste
Envia o exemplo; o resultado aparece no cartão em alguns segundos.
Cancelar
Fecha sem enviar.
Diálogo Excluir este webhook?
Botões e ações
Excluir webhook
Exclui: o endereço para de receber avisos na hora e o registro de entregas dele é apagado junto.
Cancelar
Desiste de excluir; o foco abre neste botão.
Gaveta Entregas do webhook
As entregas de um webhook, sem sair da aba.
Botões e ações
Todas
Mostra todas as entregas do webhook.
Entregues
Mostra só as entregues.
Falharam
Mostra só as que falharam.
Reenviar
Reenvia a entrega aberta com o mesmo ID de evento, para o seu sistema não duplicar.
Abrir o registro completo
Abre a aba Entregas já filtrada neste webhook.
Cada entrega abre com a resposta, o erro e o corpo enviado, com o botão Copiar corpo.
Selo Atualiza sozinho enquanto a lista acompanha os envios.
Aba Entregas: Registro de entregas
Tudo o que saiu para os seus sistemas nos últimos 30 dias.
Campos e filtros
Filtrar por webhook
Todos os webhooks ou um endereço.
Filtrar por evento
Todos os eventos ou um evento, em grupos.
Buscar por lead ou ID do evento
Busca pelo nome do lead ou pelo ID do evento.
Botões e ações
Todas
Mostra todas as entregas, com o total.
Entregues
Mostra as entregues.
Falharam
Mostra as que falharam.
Ver só esse endereço
Filtra a lista no endereço pausado que causou as falhas.
Corpo enviado
Mostra o corpo que saiu.
Resposta
Mostra o começo da resposta do seu sistema.
Cabeçalhos
Mostra os cabeçalhos enviados.
Reenviar
Reenvia com o mesmo ID de evento. Num webhook pausado, pede antes Reativar e reenviar.
Reativar e reenviar
Reativa o webhook pausado e reenvia a entrega.
Copiar corpo
Copia o corpo enviado para testar no seu sistema.
Limpar filtros
No vazio de um filtro, tira todos os filtros.
Carregar mais antigas
Traz mais entregas antigas.
Ir para os webhooks
No registro vazio, volta para a aba Webhooks.
Saúde · últimos 7 dias: a taxa em destaque, Entregues, Falharam, Tentando de novo e Resposta média.
Gráfico de entregas por dia: cada barra é um botão que mostra o dia, as entregas, as falhas com o motivo e as pausas.
Lista agrupada por dia, mais recentes primeiro, no horário de Brasília. Cada linha mostra o evento, o lead, a hora, o resumo, o endereço, a tentativa e a situação: Entregue, Tentando de novo, Não entregue ou Na fila.
Ao abrir uma entrega: o aviso, cada tentativa com o código e o tempo, e as abas Corpo enviado, Resposta e Cabeçalhos.
Estados da tela
Carregando
Números e cartões cinza enquanto os webhooks e o registro chegam.
Sem nada ainda
Nenhum webhook ainda, com Novo webhook e Ver como funciona. No registro, Nenhuma entrega ainda, com Ir para os webhooks.
Se der erro
Não conseguimos carregar os seus webhooks agora (ou o registro), com Tentar de novo; os avisos continuam saindo normalmente.
Quem abre não é o dono da conta
Os webhooks ficam com o dono da conta: só o dono cria, muda e acompanha os avisos. Vale para as abas Webhooks e Entregas.
O webhook foi pausado automaticamente
O cartão fica com o selo Pausado automaticamente e o aviso com Reativar e Ver as falhas.
Filtro do registro sem resultado
Nenhuma entrega com estes filtros, com Limpar filtros.
Conversões
A aba Conversões serve para devolver à Meta, pela API de Conversões, cada lead qualificado, etapa do funil e venda, para as campanhas procurarem pessoas parecidas com quem compra e não só com quem clica.
Endereço no painel: /app/integracoes/conversoes
A tela Conversões na conta de demonstração, com dados fictícios e os valores desfocados.
Como chegar: Integrações, aba Conversões. O aviso do sino de token recusado também leva para esta aba.
Abertura e Enviar conversões
A explicação, o caminho do anúncio à venda e o controle geral do envio.
Botões e ações
Enviar conversõesDono
Interruptor que liga ou desliga o envio de todas as etapas para a Meta. Só liga depois da conexão conferida.
Título Ensine seus anúncios a trazer quem compra, não só quem clica.
O caminho Anúncio, Lead qualificado, Etapas do quadro e Venda, com o laço de volta para a campanha.
Enviadas · 7 dias e Casadas (a porcentagem casada pelo ID do formulário do anúncio).
A frase de situação: ligado desde quando e por quem, desligado, pronto para ligar, ou parado até trocar o token, com quantas conversões aguardam.
Selo Enviando em tempo real, Envio desligado ou Parado até trocar o token.
Faixa de token recusado
Aparece no alto quando a Meta recusou o token ou quando é preciso colar o token de novo.
Botões e ações
Trocar tokenDono
Leva ao passo 1 e abre o campo do token.
Diz quantas conversões estão aguardando; elas saem sozinhas quando o token é trocado. Para quem não é dono, pede para o dono trocar.
Passo 1: Conectar ao seu conjunto de dados
Você gera o token na sua conta da Meta e cola aqui, junto com o código de teste; não é pedida senha nem acesso à conta de anúncios.
Campos e filtros
ID do conjunto de dadosobrigatório
Só números; no Gerenciador de Eventos, o número em Identificação, abaixo do nome do conjunto.
Token de acessoobrigatório
Cole o token; depois de salvo, ele não aparece inteiro de novo.
Código de testeobrigatório
O código TEST da aba Eventos de teste, canal Site; a conferência manda um evento de teste com ele.
Botões e ações
Mostrar tokenDono
Mostra o token digitado; vira Ocultar token.
Conferir conexãoDono
Manda um evento de teste para a Meta e guarda a conexão quando ela é aceita.
Trocar tokenDono
Abre o formulário para colar um token novo.
Conferir de novoDono
Confere de novo a conexão já salva.
CancelarDono
Fecha a troca de token sem mudar nada.
Selo do passo: Conectado, Falta conectar, Token recusado ou Cole o token de novo.
Conectado, mostra o Conjunto de dados, o Token de acesso guardado com segurança e a Última conferência.
Onde gerar o token: três passos ilustrados no Gerenciador de Eventos.
Passo 2: Escolher o que enviar
Cada etapa do quadro vira um evento na Meta; o ganho vai com o valor do negócio. Liberado depois da conexão conferida.
Campos e filtros
Quadro
O quadro do Funil cujas etapas viram eventos; cada coluna declara o seu papel no funil.
Botões e ações
Evento na Meta:Dono
Cada linha tem a etapa, o papel, o evento na Meta e um interruptor que liga ou desliga aquela etapa; a mudança grava na hora e mostra Salvo.
Abrir o Funil
Quando não há quadro, abre o Funil para criar um.
Selo com quantas etapas estão ligadas das disponíveis.
A coluna de entrada e a de perdido não viram evento; o ganho sai como Compra, com o valor do negócio.
Em segmento de saúde, as conversões ainda não saem, e as linhas aparecem com Não sai neste segmento.
Passo 3: Testar
Mande um evento de teste e confira na aba de testes do Gerenciador de Eventos que ele chegou.
Campos e filtros
Código de teste
O código da aba de testes; sem ele, o evento contaria como real.
Evento
Qual etapa ligada vai no teste.
Botões e ações
Enviar evento de testeDono
Manda o evento de teste com um identificador inventado, que não casa com nenhum cliente seu.
Ver o que sai no evento de teste
Mostra o corpo enviado à Meta.
Qualidade do casamento
Como cada conversão foi ligada a uma pessoa na Meta.
Botões e ações
7 dias
Mostra o período de 7 dias.
30 dias
Mostra o período de 30 dias.
Enviadas, Aguardando, Recusadas e Puladas.
A barra dividida entre ID do formulário e Telefone e e-mail criptografados.
Por etapa: quantas de cada etapa foram enviadas.
A nota de qualidade que a Meta calcula fica no Gerenciador de Eventos; a tela não inventa esse número.
Registro de envios
Cada conversão que saiu, está na fila ou foi pulada, com o motivo.
Botões e ações
Todos
Mostra todos os envios.
Enviados
Mostra os enviados.
Aguardando
Mostra os que aguardam.
Recusados
Mostra os recusados pela Meta.
Pulados
Mostra os pulados, com o motivo.
ReenviarDono
Reenvia a conversão recusada com o mesmo ID, sem duplicar.
Mostrar mais
Traz mais linhas do registro.
Colunas Quando, Lead, Evento, Casamento, Situação, Tentativas e Ação, no horário de Brasília.
A venda marcada pelo seu sistema aparece como Marcada pelo seu sistema.
O que vai para a Meta, e o que nunca vai
Botões e ações
Política de privacidade
Abre a política de privacidade.
Vai: a etapa alcançada e a hora, o valor da venda, o ID do formulário do anúncio e, sem ele, telefone e e-mail criptografados.
Nunca vai: o nome do lead, a conversa e o resumo da IA, telefone ou e-mail em texto aberto, os campos do negócio e nada de quem pediu para não receber mensagens ou teve os dados apagados.
A Meta não cobra por estes envios, e o seu saldo não é tocado.
Estados da tela
Carregando
Blocos cinza da abertura e dos três passos.
Sem nada ainda
Nenhuma conversão enviada ainda: aparece no lugar do registro até conectar e ligar o envio.
Se der erro
Não conseguimos carregar as conversões agora, com Tentar de novo; o envio para a Meta continua funcionando.
Primeira vez, sem conexão
Os passos 2 e 3 ficam travados com Liberado depois que a conexão for conferida.
Quem abre não é o dono
Só o dono da conta conecta, liga o envio e envia o teste; os campos e interruptores aparecem travados.
A conta ainda não tem a função
As conversões ainda não estão disponíveis nesta conta.
Passo a passo
Como criar uma integração para receber leads de outro sistema
Abra Integrações no menu e fique na aba Entrada de leads.
Clique em Nova integração.
Em Nome da integração, dê um nome fácil de reconhecer e escolha a origem em De onde vêm esses leads?. Clique em Continuar.
Escolha a base legal em Por que você pode falar com essas pessoas? e clique em Continuar.
Decida se o primeiro contato sai sozinho: com Mandar a primeira mensagem sozinho pelo WhatsApp ligado, escolha a Conta do WhatsApp, o Modelo aprovado e o Teto por dia. Clique em Continuar.
Escolha o Quadro do Funil, a Coluna de entrada e as Etiquetas automáticas e clique em Criar integração.
Na tela Integração criada, clique em Copiar a chave e em Copiar o endereço e passe os dois para quem cuida do seu sistema. A chave não aparece de novo.
Clique em Enviar lead de teste para ver o caminho funcionando, ou em Concluir.
Como receber no próprio WhatsApp o primeiro contato de um lead de teste
Em Integrações, aba Entrada de leads, clique no cartão da integração.
No cartão Enviar lead de teste, ligue Mandar o primeiro contato para o meu WhatsApp.
Preencha Seu celular com DDD.
Clique em Enviar lead de teste e acompanhe os quatro passos até Entregue no seu WhatsApp.
Responda a mensagem no seu celular para ver a IA assumir a conversa. O lead aparece no topo de Últimos leads recebidos com o selo Teste.
Como ajustar o horário, o recontato e o teto do primeiro contato automático
Em Integrações, aba Entrada de leads, escolha a integração e clique em Ajustar primeiro contato.
Confira se Mandar a primeira mensagem sozinho está ligado.
Em Conta e modelo, escolha o modelo aprovado e, se o modelo tiver espaços, diga o que vai em cada um e o texto de Se faltar, usar.
Em Regras de envio, escolha o horário em Das e às, quantos dias esperar para não mandar de novo à mesma pessoa e o Teto por dia.
Confira a prévia em Como o lead recebe e o custo em Custo por envio.
Clique em Salvar na barra do pé da tela.
Como gerar uma nova chave de integração quando a antiga vazou ou se perdeu
Combine com quem cuida do seu sistema: a chave antiga para de funcionar na hora.
Em Integrações, aba Entrada de leads, clique em Mais no cartão da integração e escolha Gerar nova chave (ou clique em Gerar nova no cartão Como conectar).
Confirme em Gerar nova chave.
Clique em Copiar a chave nova, troque a chave no seu sistema e clique em Já guardei a chave.
Como receber leads de um sistema que manda um formato próprio
No cartão Como conectar da integração, clique em Receber no formato do seu sistema.
Cole em Exemplo do seu sistema um exemplo real do que o sistema envia e clique em Encontrar campos.
Em Campos encontrados, escolha o destino de cada campo e ligue pelo menos um ao Telefone.
Confira a prévia em Assim ficaria o lead e clique em Salvar formato.
Como criar um webhook para avisar o CRM quando um lead qualifica ou vira venda
Em Integrações, abra a aba Webhooks e clique em Novo webhook.
Preencha Endereço que vai receber com o endereço https do seu sistema.
Em O que avisar, marque os eventos; Marcar todos marca um grupo inteiro.
Clique em Criar webhook e depois em Copiar o segredo de assinatura: ele aparece uma vez só.
Clique em Enviar evento de teste, escolha o Evento e clique em Enviar teste. O resultado aparece no cartão.
Como reenviar um aviso de webhook que não foi entregue
Corrija antes o problema no sistema que recebe.
Em Integrações, abra a aba Entregas e clique em Falharam.
Abra a entrega e confira a aba Resposta.
Clique em Reenviar. Se o webhook estiver pausado, confirme em Reativar e reenviar. O aviso sai com o mesmo ID de evento, sem duplicar no seu sistema.
Como ligar as conversões da Meta para os anúncios aprenderem com as vendas
No Gerenciador de Eventos da Meta, gere o token de acesso do conjunto de dados e copie o código de teste.
Em Integrações, abra a aba Conversões.
No passo 1, preencha ID do conjunto de dados, Token de acesso e Código de teste e clique em Conferir conexão.
No passo 2, escolha o Quadro e ligue as etapas que devem virar evento.
No passo 3, clique em Enviar evento de teste e confira a chegada no Gerenciador de Eventos.
Ligue Enviar conversões no alto da aba.
Perguntas frequentes
Onde encontro o endereço para o meu sistema mandar os leads?
No cartão Como conectar da integração, no campo Endereço do envio, com o botão de copiar. O mesmo endereço aparece nos exemplos da tela de documentação da API.
O lead de teste entra nos números e nos relatórios?
Não. Ele aparece no topo de Últimos leads recebidos com o selo Teste, mas não entra nos números da integração, nos relatórios nem nos webhooks.
O que acontece se o meu sistema mandar o mesmo lead duas vezes?
O reenvio repetido é ignorado, sem custo e sem mensagem nova. O cartão da integração e o registro mostram quantos reenvios repetidos foram ignorados nos últimos 7 dias.
Por que não consigo ligar o primeiro contato numa integração?
O interruptor fica travado quando a base legal é São meus clientes, quando não há conta do WhatsApp conectada, quando não dá para confirmar quem paga o envio do modelo ou quando quem abre não é o dono da conta.
O saldo acabou. Os leads perdem o primeiro contato?
Não de imediato. A tela do primeiro contato mostra quantos leads estão esperando e, ao recarregar o saldo, as mensagens saem sozinhas para quem chegou nas últimas 24 horas.
Pausei um webhook. Os avisos do período ficam guardados?
Não. Pausado, nada é enviado e os eventos desse período não ficam na fila. O que falhou antes da pausa continua no registro de entregas e pode ser reenviado depois de reativar.
Excluir um webhook apaga o histórico de entregas?
Sim. O endereço para de receber avisos na hora e o registro de entregas dele é apagado junto.
O administrador da conta pode criar integrações e webhooks?
Não. O administrador vê as integrações, o registro e a tela do primeiro contato sem os botões de mudança. Webhooks, Entregas e o envio de conversões ficam com o dono da conta.
O meu sistema pode mudar a etapa do lead no Funil?
Pode, se o interruptor Este sistema pode atualizar as etapas do funil estiver ligado na integração. Desligado, a chave só envia leads. A venda marcada pelo sistema também vai para as conversões da Meta.
Guia da Central de ajuda
Integrações
Quatro abas: receber leads de outros sistemas, avisar o seu sistema quando algo acontece aqui, acompanhar cada aviso entregue e receber os pedidos das suas vendas.
Integrações é a tela que conversa com os outros sistemas da sua empresa. Ela tem quatro abas: Entrada de leads traz leads de outros sistemas para cá, Webhooks avisa o seu sistema quando algo acontece aqui, Entregas mostra cada aviso que saiu e a resposta do seu sistema, e Pedidos recebe as vendas que alimentam o Monitor de sucesso. Dá para usar só uma, e a maioria começa pela entrada de leads.
Cada aba tem endereço próprio, então dá para mandar o link direto de uma delas para quem cuida do seu sistema. Os webhooks, que antes ficavam em Configurações, agora moram aqui, do mesmo jeito que você deixou.
Entrada de leads
Cada sistema que manda leads (o distribuidor dos seus anúncios, o formulário do site, um portal, o seu CRM) ganha uma integração com chave própria. O lead entra com a origem completa, vai direto para a coluna do Funil que você escolheu e, se você ligar, recebe a primeira mensagem pelo WhatsApp em segundos. O passo a passo completo, com base legal, custo e o lead de teste, está em Receber leads de outros sistemas.
O botão Documentação da API, no alto da aba, abre a página para quem programa: endereço, formato, exemplos prontos em várias linguagens e o significado de cada resposta.
Na tela: Tela de Integrações na aba Entrada de leads, com as abas Webhooks, Entregas e Pedidos ao lado e os cartões das integrações. As quatro abas no alto; a Entrada de leads abre primeiro.
Webhooks e Entregas: avisar o seu sistema
Na aba Webhooks você cadastra o endereço do seu sistema e escolhe, entre 13 eventos, o que avisar: lead criado, qualificado, atribuído a um atendente, transbordo para humano, mudou de etapa, venda, perdido e outros. Cada aviso sai assinado, é tentado até 6 vezes e fica na aba Entregas por 30 dias, com o botão Reenviar. Os avisos levam identificadores e os campos do negócio que não são sensíveis: nome, telefone e e-mail do lead não saem.
O passo a passo, os eventos, os dados pessoais e o que fazer quando uma entrega falha estão em Webhooks: avise o seu CRM a cada passo. Lead de teste, criado pelo botão Enviar lead de teste da entrada de leads, nunca sai em webhook: o seu sistema só é avisado de lead de verdade.
Pedidos: receber as vendas do seu sistema
Gere a chave: Gerar chave cria a credencial que o seu sistema vai usar. Ela aparece por inteiro uma única vez: copie na hora e guarde onde você guarda senha.
Mande o exemplo para quem programa: O bloco de exemplo já vem com o endereço de ingestão preenchido. Copiar o exemplo e a chave é tudo o que a outra ponta precisa para a primeira chamada.
Empurre os pedidos: Cada pedido leva um identificador do lado de vocês (external_id). Mandar o mesmo pedido de novo não duplica: ele é reconhecido e atualizado.
Confira no Monitor: Pedido que entrou vira histórico de compra do contato e aparece no Monitor de sucesso. Se não apareceu, o problema é o casamento com o contato, o próximo aviso.
Quem consegue mexer
Como é quando está bem
Cada sistema que manda leads com a sua própria integração, e os Últimos leads recebidos sem nada em Com problema.
Os webhooks com a saúde dos 7 dias perto de 100%, nenhum Pausado automaticamente e o Último envio batendo com o movimento do dia.
As chaves guardadas fora do painel, junto das outras credenciais do seu sistema.
O aviso Pediu para não receber mensagens integrado com qualquer outra ferramenta sua que dispare mensagem.
Pedidos entrando sozinhos e o Monitor de sucesso com dado do mês inteiro, e não do dia em que alguém lembrou de subir planilha.
Webhooks, pedidos e chaves não debitam saldo. O que custa é o primeiro contato automático da entrada de leads, quando você o liga numa conta do WhatsApp da plataforma: o valor aparece antes de ligar, e as regras estão em Receber leads de outros sistemas.
No painel: Abrir Integrações. Abra junto com quem cuida do seu sistema: as chaves aparecem uma vez só.
Receber leads de outros sistemas
O seu distribuidor de leads, o formulário do site ou o seu CRM mandam o lead para cá, e a IA manda a primeira mensagem pelo WhatsApp em segundos.
A Entrada de leads é a primeira aba de Integrações. Cada sistema que manda leads para cá ganha a sua integração: um nome, uma chave própria, a base legal declarada, o primeiro contato pelo WhatsApp e o lugar do Funil onde o cartão nasce. Todo lead que entra fica registrado, com a origem completa: campanha, conjunto, anúncio e UTM. O ID do anúncio liga o lead ao gasto da planilha em Investimento → Venda.
Quem programa encontra o endereço, os exemplos de código e as respostas da API no botão Documentação da API, no alto da tela. Este guia é para quem configura e acompanha.
Na tela: Aba Entrada de leads com a apresentação no alto e os cartões de três integrações ativas, cada um com os números dos últimos 7 dias. Cada cartão mostra a chave mascarada, os números da semana e se o primeiro contato está ligado.
Criar uma integração
Nome e origem: Nova integração abre um assistente de quatro passos. Dê um nome que você reconheça depois ("Distribuidor — anúncios Meta") e diga de onde vêm os leads. A origem só muda o ícone e a ajuda do passo.
Base legal: Diga por que você pode falar com essas pessoas. Nenhuma opção vem marcada: é uma declaração sua, e ela fica registrada com o seu nome. As regras de cada base estão logo abaixo.
Primeiro contato: Escolha a conta do WhatsApp e o modelo aprovado que sai sozinho para cada lead novo. A prévia mostra a mensagem com um lead de exemplo, e a faixa de custo mostra quanto cada envio custa antes de você ligar.
Destino: O quadro e a coluna do Funil onde o cartão nasce, e as etiquetas que cada lead ganha ao entrar. O assistente já sugere uma etiqueta pela origem ("anúncio meta", por exemplo): tire no X se não quiser.
Guarde a chave: Ao criar, a chave aparece uma única vez. Copie e entregue a quem cuida do seu sistema, junto com o endereço. Depois disso, a tela mostra só o começo e o fim dela.
Envie um lead de teste: Antes de ligar o seu sistema, use Enviar lead de teste e acompanhe cada passo acontecendo. O teste está explicado mais abaixo.
Na tela: Passo 3 do assistente de nova integração: a conta do WhatsApp, o modelo aprovado, a prévia da mensagem com um lead de exemplo e a faixa de custo. No passo 3, a prévia mostra a mensagem com um lead de exemplo e a faixa diz quanto cada envio custa.
A base legal de cada lead
Sem base legal, o lead é recusado na entrada e nenhum dado dele fica guardado. A base pode vir no próprio lead, mandada pelo seu sistema, ou ser a base padrão da integração, a que você escolheu no passo 2. Quando as duas existem, vale a do lead, e o registro diz que ela veio do seu sistema.
Pediram para eu entrar em contato
A pessoa preencheu um formulário ou um anúncio pedindo contato. É a base certa para lead de anúncio, e a que libera o primeiro contato automático.
Já coletei o consentimento deles
A pessoa autorizou receber mensagens da sua empresa. Também libera o primeiro contato automático.
São meus clientes
Pessoas com quem você já tem contrato. O lead entra normalmente, mas o primeiro contato automático não sai: mensagem de marketing para cliente de contrato precisa do consentimento dele.
Na ficha do lead, a base aparece como uma frase: "Pediram para entrar em contato · declarada por Marcelo Antunes pela integração Distribuidor em 22/09/2026". Trocar a base padrão depois não apaga quem declarou na época.
O primeiro contato automático
Ligado, todo lead novo com base legal recebe um modelo aprovado pela conta do WhatsApp que você escolheu, assinado pela persona daquela conta. No Inbox, a mensagem aparece com a etiqueta Primeiro contato automático e o nome do modelo. Se o lead responder, a IA assume a conversa como sempre.
Ao abrir a integração, Ajustar primeiro contato leva à tela completa: conta e modelo, o que vai em cada espaço da mensagem, as regras de envio, a prévia de como o lead recebe e o custo por envio. Nada muda até você clicar em Salvar, na barra que aparece embaixo.
Na tela: Tela do primeiro contato automático: os números da semana, o interruptor, a conta e o modelo escolhido, e a prévia de como o lead recebe a mensagem. Se o modelo escolhido for pausado ou apagado na Meta, a tela e o cartão da integração avisam que o primeiro contato parou.
Horário de envio
Das 8h às 21h, no fuso da sua conta (horário de Brasília, se nenhum foi configurado). Lead que chegar fora desse horário recebe a mensagem no começo do próximo horário, e o mesmo vale para a mensagem que ficou esperando recarga, respeitando o teto por dia. A IA continua respondendo 24 horas se o lead escrever.
Variáveis da mensagem
Cada espaço do modelo recebe um dado do lead: primeiro nome, nome completo, nome da empresa, da persona, da campanha ou um campo que o seu sistema mandou. Ao criar a integração, o primeiro espaço já vem com o primeiro nome e o segundo com o nome da persona. Espaço sem valor usa o texto padrão que você escrever ao lado. Sem texto padrão, a mensagem não sai.
Não mandar de novo para a mesma pessoa
Quem se cadastrar de novo dentro do prazo escolhido, por qualquer integração, não recebe outra primeira mensagem.
Mesmo ligado, o primeiro contato não sai, e o registro diz o motivo, quando:
a pessoa pediu para não receber mensagens, mesmo que se cadastre de novo;
o contato está marcado para não receber campanha;
o número não é um celular do Brasil (o lead entra, e a IA responde se ele escrever);
um atendente está na conversa: a mensagem fica de fora e o histórico do lead anota;
o lead já está conversando com você: a IA segue sem gastar modelo;
já houve um primeiro contato para essa pessoa dentro do prazo.
Quanto custa e quando é cobrado
O custo aparece no passo 3 e na tela do primeiro contato, antes de você ligar. Ele depende da conta do WhatsApp escolhida e da categoria do modelo.
Conta da plataforma
Cada envio é debitado do seu saldo antes de sair, primeiro da franquia do plano e depois do saldo. Consulte o valor por categoria em Saldo & Recargas.
Conta própria do WhatsApp
Sem custo na plataforma. A Meta cobra direto no cartão da sua conta, pela tabela dela. No seletor Conta do WhatsApp, ela aparece com conta própria ao lado do número.
Não enviado
A Meta recusou o envio na hora, ou a conta caiu antes de ele sair: há certeza de que a mensagem não saiu. O valor volta para o saldo e o extrato mostra a devolução.
Falhou depois de sair
A Meta aceitou o envio e avisou depois que não conseguiu entregar (um número sem WhatsApp, por exemplo). A tarifa já correu, então o valor não volta. A mensagem aparece como Falhou no Inbox.
Envio não confirmado
O WhatsApp não confirmou se a mensagem saiu. O valor fica debitado, porque ela pode ter chegado. Confira a conversa no Inbox antes de clicar em Reenviar: reenviar cria um envio novo e cobra de novo.
Sem saldo
A mensagem espera a recarga por até 24 horas e sai sozinha quando o saldo volta. Depois disso, é dispensada.
Quando o primeiro contato de uma integração para (saldo insuficiente, modelo pausado ou apagado na Meta, conta do WhatsApp desconectada, teto do mês atingido), o sino mostra o aviso enquanto o problema durar, e o cartão da integração diz o que parou. No celular chega no máximo um aviso por integração por dia.
Onde o lead aparece
Com destino escolhido, o cartão nasce direto na coluna do quadro que você indicou. O destino da integração manda no quadro escolhido; os outros quadros seguem as regras deles. Sem destino, o cartão nasce em cada quadro que tem regra para lead novo, como já acontece hoje.
Quando o telefone já é de um lead seu, nada é duplicado: só o que está vazio é preenchido, as etiquetas são somadas, e a ficha ganha a linha "Entrou de novo pela campanha X". Nada que o seu time digitou é apagado, e quem já tem cartão no quadro de destino não ganha outro.
Na ficha, no Inbox e no cartão do Funil, o lead ganha o selo Veio da integração, com a campanha e o conjunto. A ficha mostra também os Dados recebidos: cada campo que o seu sistema mandou, com nome legível.
Um campo em fields com o Nome na API de um campo do negócio (em Funil → Configurar quadro → Campos do cartão) preenche esse campo no cartão. Campo de moeda vai em reais (450000 ou "450.000,00"); os webhooks devolvem em centavos. Valor que não serve para o campo (uma data que não existe, uma opção fora da lista) fica em Dados recebidos, e o registro da entrada diz qual campo foi ignorado e por quê.
Atualizar a etapa pelo seu sistema
Com a permissão Atualizar etapas ligada (ao abrir a integração, em Editar), a mesma chave move o cartão do lead no quadro de destino (ou no quadro padrão, sem destino) pela rota stage da API, usando o Nome na API de cada coluna, que fica em Configurar quadro → Colunas e etapas. A permissão vem desligada, vale só para esta integração e cada mudança fica na auditoria. Com ela desligada, a chave só envia leads.
Quando o seu sistema manda um formato próprio
Se o seu sistema não consegue mandar no nosso formato, use Receber no formato do seu sistema, no passo 4 do assistente ou em Como conectar, ao abrir a integração. Cole um exemplo do que ele manda: os campos aparecem sozinhos, e você diz qual é o telefone, o nome, o e-mail e a campanha. O telefone é obrigatório. O que você não ligar a nada chega em Dados recebidos. Ao abrir de novo, o diálogo mostra as ligações que você salvou. O Enviar lead de teste não passa pelo formato do seu sistema: ele funciona igual, e a mensagem de teste chega com o seu nome.
Os últimos leads recebidos
Ao abrir uma integração, a lista Últimos leads recebidos se atualiza sozinha. Os filtros separam Novos, Contatados, Responderam e Com problema. Clique numa linha para ver tudo o que entrou, a base legal, a linha do tempo e os atalhos para a conversa e a ficha.
Na tela: Lista de últimos leads recebidos com os filtros no alto e linhas na fila, respondidas, contatadas e uma entrada recusada por telefone inválido. Cada linha traz a origem do anúncio, a situação do primeiro contato e, quando houver, o motivo.
Na fila e Agendado
A mensagem vai sair em segundos, ou no começo do próximo horário de envio.
Contatado
O primeiro contato saiu. Vira Respondeu quando o lead escreve de volta.
Sem envio
O lead entrou, mas a mensagem não saiu, por um dos motivos de cima. O motivo aparece na linha.
Bloqueado
A pessoa pediu para não receber mensagens. A entrada fica registrada só com a origem, e a ficha dela avisa que ela se cadastrou de novo e que nenhuma mensagem automática é enviada.
Não confirmado, Falhou e Sem saldo
Veja o que cada um quer dizer no custo.
Recusado
O lead não entrou (sem base legal ou sem telefone, por exemplo). A linha mostra só o telefone mascarado e o motivo, com o detalhe quando o telefone é inválido ("veio sem DDD"), e some depois de 7 dias.
O mesmo lead reenviado pelo seu sistema não vira linha nova nem custa nada: o cartão da integração conta esses reenvios repetidos à parte.
O lead de teste
Enviar lead de teste manda um lead de verdade pela integração, marcado como teste. Ele aparece no topo da lista com o selo Teste e fica fora dos números de leads, dos relatórios de leads e dos webhooks. Na ficha, o botão Apagar lead de teste tira o lead e a conversa do painel.
Chave, pausa e exclusão
Gerar nova chave
Pede confirmação. Confirmada, a chave atual para de funcionar na hora, e o sistema que usa esta integração precisa receber a nova.
Pausar
A integração passa a recusar os envios até você reativar. As primeiras mensagens que ainda esperavam para sair (fora do horário ou sem saldo) também não saem. Nada é apagado.
Excluir
Pede confirmação. A chave para na hora. Os leads e as entradas que já chegaram continuam no painel.
No painel: Abrir Integrações. Crie a primeira integração e mande um lead de teste antes de ligar o seu sistema.
Webhooks: avise o seu CRM a cada passo
O seu CRM fica sabendo na hora quando um lead chega, qualifica, vai para um atendente, muda de etapa ou vira venda, com cada entrega registrada e o botão Reenviar.
Os Webhooks são a segunda aba de Integrações. Cada webhook é um endereço do seu sistema que recebe um aviso a cada evento que você escolheu, assinado com um segredo próprio. Tudo o que sai fica na aba Entregas por 30 dias, com o corpo enviado, a resposta e cada tentativa.
Quem programa encontra os exemplos de cada evento, a conferência da assinatura e as regras das novas tentativas no botão Documentação dos webhooks, no cartão Para quem vai programar o recebimento. Este guia é para quem configura e acompanha.
Criar um webhook
Abra o formulário: Abra Integrações → Webhooks → Novo webhook.
Endereço e eventos: Cole o endereço do seu sistema (HTTPS) e escolha os eventos, em grupos: lead, atendimento, funil e pedidos.
Guarde o segredo: Guarde o segredo de assinatura: ele aparece uma vez.
Teste: Clique em Testar: o resultado aparece no próprio cartão.
Na tela: Aba Webhooks: os números dos últimos 7 dias e os cartões de três endereços, um deles pausado automaticamente. A aba Webhooks, com a saúde de cada endereço.
O interruptor Ativo pausa o webhook: nada é enviado até você reativar, e os eventos desse período não ficam na fila. Editar muda o endereço e os eventos, e é lá também que fica o Gerar segredo novo: o segredo atual para de valer na hora, então atualize o seu sistema logo depois.
Os 13 eventos
Lead criado, lead qualificado, lead quente, atribuído a um atendente, transbordo para humano, primeiro contato, mudou de etapa, venda, perdido, negócio reaberto, pediu para não receber mensagens, dados apagados e pedidos importados. O “lead qualificado” sai uma vez por lead. O aviso de mudança de etapa traz o papel da coluna no campo role (entrada, qualificado, atendimento, intermediária, ganho ou perdido), para o seu sistema entender qualquer quadro (pode vir vazio enquanto as colunas do quadro não tiverem papel).
Dados pessoais: não saem
Os avisos levam identificadores: o ID do lead, o ID no seu sistema, a etapa, a nota e os valores. A mudança de etapa e a venda levam também os campos do negócio que não são sensíveis; campo de texto livre leva o que o time escreveu nele. Nome, telefone, e-mail e o resumo da conversa não saem, e campo marcado como sensível nunca sai.
Quando um titular pede para apagar os dados, o aviso Dados apagados (LGPD) sai para o seu sistema apagar o que guardou sobre ele, e o começo da resposta do seu sistema é apagado do registro de entregas.
Entregas, tentativas e reenvio
Cada aviso é tentado até 6 vezes: na hora, depois de 1 min, 5 min, 30 min, 2 h e 6 h. Na aba Entregas você vê cada tentativa; ao abrir uma entrega, aparecem a resposta do seu sistema e o corpo enviado. Reenviar manda com o mesmo ID de evento, para o seu sistema não duplicar. Depois de 50 avisos seguidos sem sucesso, o webhook é pausado e você recebe um aviso.
Na tela: Aba Entregas: a saúde dos últimos 7 dias com o gráfico por dia e a lista de entregas com os filtros. O registro de entregas: a saúde dos 7 dias, o gráfico por dia e cada entrega, com o Reenviar nas que falharam.
O aviso de pausa aparece no cartão, no sino e por e-mail. Corrija o endereço no sistema que recebe e clique em Reativar; as entregas que ficaram de fora continuam no registro, com o botão Reenviar. Os avisos do período em que ele ficou pausado sozinho também estão lá, como Não entregue: nada se perde. Reenviar uma entrega de um webhook pausado pede Reativar e reenviar.
Ordem e duplicidade
Os avisos podem chegar fora de ordem quando há novas tentativas. Ordene pelo campo occurred_at e ignore um event_id que já chegou. No transbordo automático com rodízio chegam dois avisos de transbordo, um da IA e outro da atribuição.
Endereços que não são aceitos
A recusa vem com o motivo específico, embaixo do campo do endereço. As regras:
https, sempre. http não passa.
Porta padrão. Endereço com porta alternativa é recusado.
Sem usuário e senha embutidos no endereço.
Endereço público. Endereço da rede interna da sua empresa é bloqueado.
Se o sistema que precisa ser avisado só existe dentro da rede da empresa, o caminho é publicar um endereço na internet que converse com ele, e não insistir em cadastrar o interno aqui.
Quem consegue mexer
Webhooks e entregas são do dono da conta. Para os outros papéis, as duas abas mostram que ficam com o dono, sem os endereços e sem o registro. Webhooks e entregas não debitam saldo.
No painel: Abrir Webhooks. Abra junto com quem cuida do seu CRM: o segredo aparece uma vez só.
Conversões para os seus anúncios
Devolva à Meta quem qualificou e comprou
O que é
Quando um lead qualifica, avança nas etapas do seu quadro ou fecha negócio, o painel avisa a Meta. As campanhas aprendem a procurar pessoas parecidas com quem avançou no seu funil, e não só com quem clicou.
No passo Escolher o que enviar, escolha o quadro: cada coluna entre a entrada e o ganho pode virar um evento, e o ganho sai como Compra, com o valor.
Na tela: A aba Conversões de Integrações com a conexão conferida: o controle Enviar conversões ligado, com as enviadas da semana e as casadas, e os três passos da configuração — o conjunto de dados conectado, as etapas do quadro Imobiliária com o evento de cada uma e o teste. A aba Conversões, com o quadro Imobiliária.
Antes de começar: o conjunto de dados, o token e o código de teste
Tudo acontece no Gerenciador de Eventos da Meta, com a conta que administra os seus anúncios. Não precisa de revisão nem de aprovação da Meta, e você não passa senha nem acesso para o painel.
Crie ou escolha o conjunto de dados: Se o seu site já tem o Pixel da Meta, use o conjunto de dados dele. Se não tem, clique em Conectar dados, escolha Web, depois Criar novo conjunto de dados, dê um nome e ligue à conta de anúncios que roda as campanhas. Não use um conjunto com ícone de celular: ele é de um aplicativo.
Anote o ID: Em Conjuntos de dados, abra o conjunto. O ID é o número que aparece abaixo do nome, como Identificação.
Gere o token: Na aba Configurações do conjunto, desça até API de Conversões e, em Configurar integração direta, clique em Gerar token de acesso. Copie o token na hora: a Meta mostra uma vez só. Se escolher a opção com a Dataset Quality API, deixe marcado só este conjunto, porque a Meta não deixa desfazer essa escolha.
Copie o código de teste: Na aba Eventos de teste, escolha o canal Site e abra Confirme se os eventos do seu servidor estão configurados corretamente. O código começa com TEST.
Cole e confira: Em Integrações → Conversões, cole o ID, o token e o código de teste e clique em Conferir conexão. A conferência manda à Meta um evento de teste de Lead qualificado, com um identificador inventado que não casa com nenhum cliente seu. Os três campos são obrigatórios.
Escolha, teste e ligue: Escolha as etapas no passo 2, mande um evento de teste no passo 3 e ligue Enviar conversões no topo.
O que vai e o que nunca vai
Sim: A etapa que o lead alcançou e a hora em que aconteceu.
Sim: O valor da venda, em reais.
Sim: O ID do formulário do anúncio; sem ele, telefone e e-mail criptografados.
Não: Nome, conversa, resumo da IA e dados do negócio.
Não: Nada de quem pediu para não receber mensagens, foi tirado das campanhas ou teve os dados apagados.
Como ler o registro
Cada linha mostra a etapa, o lead, como foi casado e a situação: Enviado, Aguardando (nova tentativa agendada, ou um token novo quando a Meta recusou o token), Recusado (com o motivo e o botão Reenviar) ou Pulado (sem dado para casar, pedido do titular, prazo que a Meta aceita, venda sem valor, sem base legal registrada, etapa desligada ou quadro trocado antes de o evento sair ou dado de saúde, que por enquanto não sai).
Na tela: O Registro de envios da aba Conversões: o filtro por situação com as contagens e a tabela com a hora, o lead, o evento, o casamento, a situação com o motivo e as tentativas. O registro. O Reenviar aparece só nos recusados e manda o mesmo evento, sem duplicar.
Casadas
As conversões que foram com o ID do formulário do anúncio, o casamento mais preciso.
Telefone e e-mail
Sem o ID do formulário, vão o telefone e o e-mail criptografados. A Meta compara sem receber o número em texto.
Qualidade na Meta
A nota que a Meta calcula fica no Gerenciador de Eventos. O painel não inventa esse número.
Quem responde pela base legal
A sua empresa é a responsável pelos dados dos leads, e o painel trata esses dados em nome dela. Ligar as conversões é uma decisão sua, registrada com o seu nome; a seção O que vai para a Meta, na própria aba, mostra o que é enviado e o que nunca vai.
Perguntas frequentes
Por que o clique do anúncio de WhatsApp não casa?
Esse casamento depende de uma permissão da Meta que ainda não está liberada. Hoje a conversão casa pelo ID do formulário do anúncio ou pelo telefone e o e-mail criptografados.
A venda de meses atrás vai?
Não. A Meta só aceita eventos dos últimos 7 dias. O que passou disso aparece no registro como Pulado, com a data do fato.
Reabri o negócio e ganhei de novo. Duplica?
Não. Cada lead tem um ID de evento fixo para o ganho, e a Meta ignora o segundo envio com o mesmo ID.
Marquei a venda sem valor. Dá para corrigir?
Dá. Reabra o negócio e marque o ganho de novo com o valor: a mesma conversão, que estava como Pulado por venda sem valor, volta a aguardar e sai com o valor, sem duplicar.
Dá para reenviar com o envio desligado?
Não. Com Enviar conversões desligado, nada vai para a Meta, nem pelo Reenviar. Ligue o envio no topo da aba e reenvie a conversão recusada.
A Meta recusou o meu token. Perdi as conversões?
Não. Elas ficam aguardando e saem sozinhas quando você cola um token novo no passo 1, desde que o fato tenha acontecido nos últimos 7 dias.