Growth & Marketing Studio
Por Conversa Labs
Por Conversa Labs
Page/Form Builder, AI Studio, publicação social, Ads/CTWA/leadgen, lançamentos, turmas de lançamento, automação social e Rede de Colaboração.
Visão geral do Growth & Marketing Studio
Visão geral O Growth & Marketing Studio é o conjunto de módulos da Conversa Labs voltados à frente do funil: publicar conteúdo nas redes, atrair tráfego pago e capturar leads do Meta, distribuir audiências em grupos de WhatsApp e crescer organicamente — tudo conectado ao mesmo motor de conversas, CRM, follow-ups e pagamentos que você já usa no atendimento. Em vez de combinar ferramentas separadas de agendamento de posts, anúncios e engajamento, você concentra a operação de marketing dentro da própria plataforma. Cada lead capturado vira Contato, Conversa, negócio no CRM e/ou inscrição em uma cadência de follow-up, sem integrações manuais. O Studio reúne os seguintes módulos: - Publicação social — agendamento e aprovação de posts no Instagram, TikTok e mais. - Ads, CTWA e leadgen — atribuição de tráfego pago e captura de leads do Meta (anúncios de conversas por mensagem — WhatsApp, Messenger e/ou Instagram — e formulários de lead). - Turmas de Lançamento — distribuição automática em grupos de WhatsApp por capacidade. - Growth Social Automation — monitoramento e engajamento em redes via serviço dedicado. - Rede de Colaboração / Matriz — pods de engajamento orgânico e afiliação. Pré-requisitos - Uma conta Conversa Labs ativa e um usuário com perfil de administrador para configurar os módulos. - Cada módulo do Studio é opt-in: precisa ser habilitado para a sua conta (feature flag) e costuma exigir permissão de administrador. Alguns dependem de integrações externas (Meta, TikTok) ou de um serviço auxiliar. - Para o melhor proveito, tenha os módulos de base já configurados: Caixas de Entrada, CRM, Follow-ups e, quando for cobrar, Pagamentos. Passo a passo 1. Confirme com um administrador quais módulos do Studio estão habilitados na sua conta. 2. Capte leads com Ads, CTWA e leadgen do Meta (anúncios de conversas por mensagem — WhatsApp, Messenger e/ou Instagram — e formulários de lead). 3. Defina o destino dos leads (Conversa, CRM, Follow-up, Agenda ou checkout de Pagamentos). 4. Produza e distribua conteúdo: agende posts na publicação social com aprovação. 5. Distribua audiências em grupos de WhatsApp com as Turmas de Lançamento. 6. Amplie o alcance orgânico com o Growth Social Automation e a Rede de Colaboração / Matriz. 7. Acompanhe os resultados nos relatórios de funil de cada módulo. Configurações & opções - Habilitação por módulo: cada item do Studio tem sua própria flag e área de configuração. - Conexões externas: publicação social, Ads e automações usam conexões de marketing (OAuth) com tokens guardados de forma criptografada e nunca expostos. - Destinos de lead: configure para onde cada lead capturado deve fluir (CRM, Follow-up, Agenda etc.). - Serviço auxiliar: a automação social usa um serviço dedicado conectado à sua conta. Casos de uso - Escalar a captação por anúncios click-to-WhatsApp com atribuição ponta a ponta. - Manter um calendário de publicação nas redes com aprovação antes de postar. - Distribuir uma audiência grande em vários grupos de WhatsApp automaticamente (Turmas). - Crescer o alcance orgânico com pods de engajamento e afiliação. Dicas, limites e boas práticas - Ative os módulos de forma incremental — comece pela captação (Ads/CTWA) e pela publicação social. - Cada rede social tem regras e limites próprios; respeite-os para evitar bloqueios. - Em grupos de WhatsApp, respeite os limites de envio para evitar bloqueios (anti-ban). - Mantenha os destinos de lead consistentes para não duplicar contatos. Solução de problemas - Não vejo um módulo do Studio: ele pode não estar habilitado para a sua conta ou seu perfil — fale com um administrador. - Os leads não aparecem no CRM/Follow-up: revise o destino configurado no anúncio/leadgen. - A publicação social falha: verifique a conexão (OAuth) e os limites/aprovações da rede. Veja também - Publicação social - Ads, CTWA e leadgen - Turmas de Lançamento (distribuição em grupos de WhatsApp) - Growth Social Automation - Rede de Colaboração / Matriz
Publicação social: agendamento e aprovação de posts
Visão geral A publicação social é a camada de saída do Growth Studio: além de receber DMs e comentários nas conversas, você passa a publicar conteúdo nas redes — posts de feed, reels e stories — em vários perfis, com agendamento, calendário de conteúdo, fluxo de aprovação e sincronização de métricas de volta para os relatórios. É uma camada adicionada sobre os canais existentes (não cria um novo tipo de canal). Você conecta a conta de marketing (Meta/TikTok), vincula um perfil que pode publicar e cria os posts. Criativos gerados no AI Studio podem chegar aqui como rascunho aguardando aprovação. Pré-requisitos - Módulo opt-in: precisa estar habilitado para a sua conta e a gestão exige permissão de administrador. - Uma conexão de marketing (OAuth) com a rede correspondente e um perfil habilitado para publicar (página do Facebook / conta business do Instagram / conta do TikTok). - Publicar conteúdo nas redes exige escopos e revisão de app da plataforma (Meta/TikTok); por isso o módulo costuma ser liberado quando essa habilitação externa está concluída. - Os tokens ficam guardados de forma criptografada e nunca são expostos. Passo a passo 1. Em Growth → Social, conecte a rede via a conexão de marketing (OAuth). 2. Vincule um perfil que poderá publicar (feed/reels/stories conforme a rede). 3. Crie um post: escreva a legenda, anexe as mídias e escolha o tipo (feed, reel ou story). 4. Selecione um ou mais perfis de destino. 5. Agende (defina data/hora) ou envie para aprovação, conforme o seu fluxo. 6. Após aprovado/agendado, o post é publicado automaticamente na hora marcada. 7. Acompanhe o calendário de conteúdo e as métricas nos relatórios do Growth. Configurações & opções - Tipos de post: feed, reel e story (variam por rede). - Estados do post: rascunho → agendado → publicando → publicado | falhou, com novas tentativas automáticas em caso de erro temporário. - Aprovação: criativos (inclusive os do AI Studio) podem exigir aprovação antes de agendar. - Calendário: visão consolidada de todos os perfis conectados. - Métricas: insights de cada post sincronizados para a aba de relatórios. Casos de uso - Programar a semana de conteúdo de vários perfis em um único calendário. - Levar um criativo gerado por IA do rascunho à publicação, passando por aprovação. - Publicar teasers de um lançamento de forma coordenada nas redes. - Medir o engajamento dos posts junto com o restante do funil. Dicas, limites e boas práticas - Cada rede tem regras de formato, duração e limites de publicação — respeite-as. - Use a aprovação para manter consistência de marca antes de o post ir ao ar. - Agende com antecedência e revise as mídias (proporção, tamanho) antes de publicar. - Reaproveite criativos do AI Studio para acelerar a produção. Solução de problemas - A publicação falhou: confira a conexão (OAuth) e se o token/perfil ainda tem permissão. - O post ficou preso em "aguardando aprovação": peça a um administrador para aprová-lo. - As métricas não aparecem: a sincronização pode levar algum tempo após a publicação. - Não consigo conectar a rede: a habilitação externa (revisão de app/escopos) pode estar pendente. Veja também - Visão geral do Growth & Marketing Studio - Growth Social Automation - Ads, CTWA e leadgen
Ads, CTWA e leadgen com atribuição
Visão geral O módulo de Ads conecta o tráfego pago do Meta à sua operação de conversas. Ele cobre dois caminhos principais: - CTWA (Click-to-WhatsApp) — quando alguém clica em um anúncio que abre o WhatsApp, a conversa chega com a referência do anúncio (origem). A plataforma usa esse dado para atribuir a conversa à campanha, sem que você precise montar nada manualmente. - Lead Ads (leadgen) — leads enviados pelos formulários de anúncio do Meta são ingeridos e viram Contatos, podendo entrar em cadências de follow-up e no CRM. Com isso, você sabe de qual anúncio veio cada conversa/lead e mede o funil de ponta a ponta. Pré-requisitos - Módulo opt-in: precisa estar habilitado para a sua conta (feature flag growth_ads) e a gestão exige permissão de administrador. - Para CTWA: o canal de WhatsApp já recebendo conversas (a referência do anúncio chega junto da conversa). - Para leadgen: a integração com o Meta configurada para receber os eventos dos formulários de anúncio (Lead Ads). Passo a passo 1. Habilite o módulo Ads em Growth e confirme as permissões de administrador. 2. CTWA: rode anúncios click-to-WhatsApp normalmente no Meta. Ao chegar uma conversa originada de anúncio, a plataforma registra a atribuição automaticamente. 3. Leadgen: conecte os formulários de anúncio (Lead Ads) para que os leads sejam ingeridos. 4. Verifique que os leads/conversas estão virando Contatos e, se desejar, entrando em CRM e Follow-ups. 5. Acompanhe a atribuição e o desempenho das campanhas nos relatórios. Configurações & opções - Atribuição CTWA: lê a referência do anúncio que acompanha a conversa para vincular à campanha. - Ingestão de leadgen: recebe os leads dos formulários de anúncio e os transforma em Contatos. - Destinos: leads/conversas atribuídos podem alimentar CRM e cadências de follow-up. - Conversões: o evento de conversão pode ser propagado de volta ao Meta quando a integração de conversões estiver configurada. Casos de uso - Saber exatamente qual campanha gerou cada conversa de WhatsApp. - Capturar leads de Lead Ads e iniciar automaticamente uma cadência de recuperação. - Medir o caminho anúncio → conversa → negócio → venda em um único funil. - Comparar o desempenho de campanhas para realocar verba. Dicas, limites e boas práticas - Mantenha o WhatsApp e a integração com o Meta saudáveis para não perder atribuição. - Combine CTWA com Follow-ups para responder rápido e aumentar a conversão. - Use lançamentos para coordenar campanhas com data marcada. - Respeite as políticas de anúncios e de dados das plataformas. Solução de problemas - A conversa não foi atribuída: confirme que o anúncio é click-to-WhatsApp e que a referência chegou junto da conversa. - Os leads do anúncio não aparecem: revise a configuração da ingestão de leadgen com o Meta. - Não vejo o módulo: ele pode não estar habilitado para sua conta ou seu perfil. Veja também - Visão geral do Growth & Marketing Studio - Publicação social - Turmas de Lançamento
Gerenciador de Anúncios Meta
Visão geral O Gerenciador de Anúncios integra a plataforma à API de Marketing da Meta com foco em campanhas de Conversas por mensagem: o anúncio leva o cliente direto para uma conversa no WhatsApp, no Messenger e/ou no Instagram, conforme os destinos escolhidos. Nas conversas do WhatsApp, a conversa vira lead atribuído ao anúncio, a venda volta para a Meta como conversão e o desempenho aparece em métricas nativas. Ele completa os dois módulos de anúncios já existentes: - Leads de anúncios (CTWA) — captura e atribuição de quem chega por anúncio; - Rastreamento de conversões — envio de eventos de conversão de volta à Meta (CAPI). Com o Gerenciador, a conta de anúncios (act_<id>) fica conectada a uma caixa de entrada do WhatsApp e a plataforma mantém um espelho somente leitura das suas campanhas, conjuntos de anúncios, anúncios e criativos, sincronizado periodicamente. Pré-requisitos - O módulo Ads Manager habilitado na conta (ele é entregue desativado por padrão e é liberado pelo operador da instalação). - Uma conta de anúncios da Meta (act_<id>) com permissão de gerenciamento. - Uma Página do Facebook e um número do WhatsApp Cloud vinculados à conta de anúncios. - Um token de acesso com os escopos de anúncios da Meta (ads_management, ads_read, business_management, pages_show_list, whatsapp_business_management). - Perfil de administrador na conta. Passo a passo 1. Habilite o módulo na conta (operador) e confirme que a caixa de entrada do WhatsApp desejada está ativa. 2. Conecte a conta de anúncios (fluxo automático): escolha a caixa de entrada do WhatsApp Cloud e a plataforma reutiliza o token da própria caixa para listar automaticamente as contas de anúncios — basta selecionar uma (você nunca digita o act_<id> à mão). Se esse token não tiver escopo de anúncios, cole um token de usuário do sistema do Business Manager e a lista é carregada da mesma forma. Cada conta de anúncios se conecta a uma caixa de entrada (relação 1:1). 3. A conexão nasce como pendente e passa a conectada após a validação do token junto à Meta. 4. A partir daí a plataforma sincroniza periodicamente o espelho de campanhas, conjuntos, anúncios e criativos da conta (intervalo padrão de 60 minutos, ajustável por conexão), e você pode forçar uma atualização com a ação Atualizar da conexão. 5. Acompanhe os leads e conversões gerados pelos anúncios nos módulos Leads de anúncios e Rastreamento de conversões — a atribuição do anúncio aparece na própria conversa. Configurações & opções - Tipo de token: usuário do sistema (recomendado — não expira) ou usuário (renovado automaticamente antes do vencimento por um job de manutenção). - Intervalo de sincronização: minutos entre as leituras da estrutura de anúncios (padrão 60). - Status da conexão: pendente, conectada, erro ou revogada — o último erro fica registrado na conexão para diagnóstico. - Token mascarado: por segurança, o token nunca é exibido depois de salvo; a interface mostra apenas os últimos 4 caracteres. Casos de uso - Central única de anúncios de conversa: acompanhar campanhas de conversas por mensagem (WhatsApp, Messenger e Instagram) e as conversas que elas geram no mesmo lugar em que o time atende. - Atribuição ponta a ponta: saber qual anúncio originou cada conversa/lead e devolver a conversão à Meta para otimizar a entrega. - Custo por conversa: medir o desempenho real dos anúncios pelo que importa — conversas e vendas, não cliques. Dicas, limites e boas práticas - Prefira token de usuário do sistema do Business Manager: não expira e sobrevive a trocas de senha do usuário. - Uma caixa de entrada aceita uma conta de anúncios conectada (e vice-versa dentro da conta). - O Gerenciador cobre o ciclo completo dentro da caixa de entrada: conexão da conta, espelho de campanhas/conjuntos/anúncios, criação e ativação/pausa de campanhas de conversas por mensagem, ajuste de orçamento, públicos, o acompanhamento da janela gratuita de 72h e os painéis de métricas (gasto, conversas, ROAS). - A janela de entrada gratuita de 72h do CTWA é contada a partir do clique no anúncio — priorize responder dentro dela. Solução de problemas - Conexão em erro: o token foi rejeitado pela Meta (expirado, senha trocada, permissão removida). Gere um novo token e reconecte; o motivo fica registrado no campo de último erro. - Conexão revogada: o acesso foi revogado no Business Manager — reconecte com um token válido. - Espelho vazio: confirme que a conexão está conectada e aguarde o próximo ciclo de sincronização (ou use Atualizar). - Permissão negada ao conectar: confira se o token carrega todos os escopos de anúncios listados nos pré-requisitos. Referências oficiais da Meta - Usuários do sistema — gerar tokens de acesso para a API de Marketing - Autorização e escopos da API de Marketing (ads_management, ads_read) Veja também - Criar uma campanha de conversas por mensagem ou formulário de cadastro no Gerenciador de Anúncios - Janela de 72h e painéis de métricas do Gerenciador de Anúncios - Automação e Flow Builder com ações de anúncio - Leads de anúncios (CTWA): captura e atribuição de leads vindos de anúncios - Rastreamento de conversões: eventos de conversão de volta para a Meta (CAPI) - Caixa de entrada WhatsApp Cloud: conexão do número oficial
Criar uma campanha (Conversas por mensagem ou Formulário de cadastro)
Visão geral O assistente de campanhas da Conversa Labs cria toda a estrutura no Meta (campanha → conjunto → criativo → anúncio) de uma vez, sempre pausada, para você revisar antes de publicar. Ele cobre dois objetivos: - Conversas por mensagem — o botão do anúncio abre uma conversa no WhatsApp, no Messenger (a caixa da sua Página) e/ou no Instagram, conforme os destinos que você escolher; os leads chegam atribuídos na sua caixa de entrada. - Formulário de cadastro (Lead Ads) — um formulário instantâneo abre dentro do Facebook/Instagram e cada envio vira contato e lead na Conversa Labs automaticamente. Pré-requisitos - Uma Conta de Anúncios conectada com Página do Facebook vinculada (veja "Gerenciador de Anúncios: visão geral e conexão"). O Instagram é detectado automaticamente quando a Página tem uma conta profissional vinculada. - Para o destino WhatsApp: a Página precisa ter um WhatsApp vinculado — siga o guia oficial da Meta em Conectar sua Página do Facebook ao WhatsApp. - Para o destino Instagram: a Página precisa ter uma conta profissional do Instagram vinculada (como vincular). O destino Messenger só exige a Página. - Para Formulário de cadastro: um administrador da Página precisa aceitar uma única vez os Termos de Serviço de anúncios de cadastro da Meta — veja o artigo "Anúncios de cadastro (Lead Ads)". - Uma forma de pagamento ativa na conta de anúncios (Configurações de pagamento da Meta). O passo Objetivo do assistente mostra um checklist de prontidão em tempo real: cada pendência externa aparece com o link do guia oficial da Meta para você resolver no lugar certo. Passo a passo 1. Em Gerenciador de Anúncios, abra a aba Campanhas e clique em Nova campanha. 2. Objetivo — escolha a conta de anúncios e o objetivo (Conversas por mensagem ou Formulário de cadastro). Em conversas por mensagem, marque os destinos: WhatsApp, Messenger e/ou Instagram — cada cartão mostra a identidade conectada (número, Página ou @usuário). Com dois ou mais destinos, a Meta usa o destino automático e direciona cada pessoa para o app onde ela tem mais chance de responder. Pendências de configuração aparecem aqui com os guias oficiais. 3. Público — busque localizações (país, estado ou cidade) com autocompletar, defina idade e gênero. Selecione públicos personalizados e semelhantes (Lookalike) da conta — ou crie um Lookalike na hora a partir de qualquer público existente (1% a 10% de semelhança, no país do seu alvo). Para semear com os SEUS dados, crie um público a partir dos leads convertidos (ou de todos os leads dos anúncios): a plataforma hasheia telefone/e-mail e envia à Meta — exige aceitar uma única vez os Termos de Público Personalizado, e o público vira origem de Lookalike ao casar 100+ pessoas (~1h) — o selo "Preparando" some quando a Meta conclui. Passe o mouse sobre um público para excluí-lo (remove também na Meta). Ative o público Advantage+ para deixar a Meta expandir além do desenhado, e escolha os posicionamentos: Automático (Advantage+), recomendado, ou manual por plataforma — Facebook, Instagram, Messenger, Audience Network e Status do WhatsApp, cada uma com suas posições (feed, stories, reels, busca, apps e sites). O Status do WhatsApp exige o story do Instagram junto; o assistente pareia automaticamente. A estimativa de público atualiza ao vivo. 4. Criativo — escreva o texto principal, título e descrição, ou toque no ✨ do copiloto Maestro em cada campo para gerar/melhorar o texto com IA (ele usa o objetivo, o público e a Página como contexto). Na mídia, escolha Imagem ou Vídeo: envie um arquivo, escolha da Biblioteca de Mídia ou use Criar com IA para gerar o criativo com o Maestro — adicione até 3 imagens de referência (da Biblioteca de Mídia ou por upload) para a IA seguir o estilo do seu produto/marca, e você pré-visualiza, refaz e ajusta antes de usar. Os campos de texto também aceitam ditado por voz (ícone de microfone): fale e a transcrição entra no campo, no idioma da conta. Vídeos (MP4/MOV até 50MB) são processados pela Meta; aguarde o selo Vídeo pronto. Em campanhas de conversas, configure a conversa de boas-vindas (vale para WhatsApp, Messenger e Instagram): a mensagem que a pessoa vê ao abrir o chat, mais uma mensagem pronta para enviar ou até 4 perguntas frequentes (cada uma com resposta automática opcional). Em campanhas só de WhatsApp, você ainda pode usar um formulário no WhatsApp (um WhatsApp Flow publicado da sua caixa de entrada) e uma chamada para ação opcional (Ligar agora, Ver catálogo ou Acessar o site). Campos em branco mantêm os padrões da Meta. Para formulário de cadastro, selecione (ou crie na hora) o formulário instantâneo. A pré-visualização ao vivo mostra o anúncio no feed do Facebook, feed do Instagram e Stories — renderizada pela própria Meta. 5. Orçamento — dê um nome à campanha, escolha orçamento diário ou vitalício (vitalício exige data de término) e, se quiser, agende início e fim. O orçamento mínimo diário da sua conta aparece como dica. Se quiser mais controle, defina um limite de lance por resultado — em branco, a Meta usa a estratégia de maior volume. 6. Revisão — confira o resumo e clique em Criar (pausada). A campanha nasce pausada no Meta com a cadeia completa. Para ir ao ar, use Ativar na lista de campanhas ou no detalhe da campanha. Configurações & opções - Detalhe da campanha — clique em Detalhes na lista para ver KPIs, a estrutura espelhada (conjuntos → anúncios → criativos), editar o orçamento e ver os leads atribuídos. - Posicionamentos manuais — o Instagram só fica disponível quando a Página tem uma conta profissional vinculada (como vincular). - Imagem — recomendado 1080×1080 (feed) ou 1080×1920 (stories); JPG/PNG até 8MB. - Vídeo — MP4 ou MOV até 50MB; a miniatura é gerada automaticamente pela Meta (ou use uma imagem sua como capa). - Copiloto Maestro — os botões ✨ e Criar com IA aparecem para administradores quando o Maestro está ativo na conta. A geração de imagem/vídeo usa as ferramentas generativas do agente Maestro — ative-as nas configurações do agente. Com imagens de referência, a IA edita/guia a partir do seu material (no vídeo, a referência vira imagem-para-vídeo); o ditado por voz usa a transcrição nativa do Maestro. - Rascunho automático — o assistente salva tudo enquanto você preenche; se fechar sem concluir, ao reabrir você volta exatamente de onde parou (ou descarta o rascunho para começar do zero). - Biblioteca de Mídia — criativos enviados ou gerados por IA são arquivados automaticamente na pasta Anúncios → sua conta de anúncios, prontos para reutilizar. - Várias contas de anúncios — conecte quantas contas quiser; com 2+ conectadas, um seletor no topo escolhe qual conta alimenta todas as abas (campanhas, KPIs e insights), e a escolha fica salva. - Filtros e período — na aba Campanhas, busque por nome e filtre por status (Todas/Ativas/Pausadas); na Visão geral e nos Insights, alterne o período entre 7, 30 e 90 dias. - Ações rápidas e em massa — cada linha tem ícones para ver detalhes, ativar/pausar, abrir a campanha no Gerenciador da Meta e excluir (com confirmação em duas etapas). Selecione várias campanhas (ou Selecionar tudo) para ativar, pausar ou excluir em lote. Casos de uso - Campanha CTWA regional com posicionamento só em stories do Instagram para uma promoção relâmpago. - Campanha de formulário para captar leads de orçamento, com pergunta personalizada, caindo direto nos follow-ups. Dicas, limites e boas práticas - Tudo nasce pausado — revise a pré-visualização antes de ativar; nada é gasto até lá. - A Meta valida a campanha na criação: se algo externo faltar (WhatsApp na Página, termos de cadastro), o erro aparece com a instrução exata e o link do guia. - Orçamentos são na moeda da conta; respeite o mínimo diário mostrado no assistente. - Com criativo de vídeo, o botão Avançar fica bloqueado até a Meta terminar o processamento (selo Vídeo pronto) — publicar antes falharia na própria Meta. Solução de problemas - "Conta não está pronta para ctwa" — a Página não tem WhatsApp vinculado. Siga o guia oficial e tente de novo (ou crie a campanha só com Messenger/Instagram nos destinos). - Cartão do Instagram desabilitado nos destinos — a Página não tem conta profissional do Instagram vinculada. Use o link do guia no próprio cartão. - "Conta não está pronta para lead_form" — aceite os Termos de anúncios de cadastro com um administrador da Página. - Prévia do Instagram não renderiza — vincule uma conta profissional do Instagram à Página. - Conta de anúncios desativada — verifique o status em Qualidade da conta. Veja também - Gerenciador de Anúncios: visão geral e conexão - Anúncios de cadastro (Lead Ads) - Janela de 72h e insights - Automação com anúncios
Janela de 72h, insights e automação de anúncios
Visão geral Quando um cliente chega por um anúncio Click-to-WhatsApp, o Meta abre uma janela gratuita de 72 horas para a conversa (as mensagens de serviço dentro dela não são tarifadas). A Conversa Labs registra essa janela por conversa e mostra o gasto e as conversas dos anúncios nos Insights, além de permitir automações a partir de anúncios. Pré-requisitos - Recurso Gerenciador de Anúncios (para insights) e/ou Anúncios (CTWA) ativos. - Uma conversa originada por um anúncio CTWA (o cartão do anúncio aparece na conversa). A janela de 72h - O relógio começa na primeira mensagem do cliente após o clique no anúncio. - Estados: aberta, expirando (menos de 6h restantes) e expirada. - Use o estado da janela como condição em Automações e no Flow Builder (ex.: responder só enquanto a janela estiver aberta). Insights Na aba Insights/Painel você acompanha, por período: - Gasto, impressões, cliques, alcance. - Conversas iniciadas pelos anúncios. - Custo por conversa e ROAS (usando o valor das conversões atribuídas). Os números são atualizados periodicamente a partir do Meta (snapshot diário, sem contagem duplicada). Automação de anúncios No construtor de Automações (e no Flow Builder) você pode: - Condições: "conversa é de anúncio", "estado da janela de 72h". - Ações: marcar contato como lead, enviar conversão ao Meta (CAPI), pausar campanha, ajustar orçamento. Dicas, limites e boas práticas - Priorize responder dentro da janela de 72h para aproveitar o período gratuito. - Use "enviar conversão ao Meta" quando um negócio for ganho para otimizar a entrega dos anúncios. Solução de problemas - Insights zerados: aguarde a próxima sincronização (a cada hora) ou confirme que a conta está Conectada. - Janela não aparece: a conversa precisa ter vindo de um anúncio CTWA (cartão do anúncio presente). Veja também - Gerenciador de Anúncios: visão geral e conexão - Criar uma campanha de conversas por mensagem no Gerenciador de Anúncios - Automação e Flow Builder com ações de anúncio
Automação e Flow Builder com ações de anúncio
Visão geral Quando o Gerenciador de Anúncios está ativo, o Conversa Labs passa a expor uma malha de automação específica para anúncios: gatilhos que disparam quando algo acontece com um anúncio, condições que verificam o estado do anúncio na conversa e ações que agem sobre a campanha, a conversão ou o contato. Essa malha aparece nas três superfícies de automação do produto — Regras de Automação, Macros e Flow Builder — e todas reaproveitam exatamente a mesma lógica no servidor. Tudo é inerte quando o módulo Ads Manager está desligado: os gatilhos não disparam, as ações não fazem efeito e nada aparece nos editores. Pré-requisitos - O módulo Ads Manager habilitado na conta. - Pelo menos uma conta de anúncios conectada a uma caixa de entrada do WhatsApp. - Conversas chegando por Click-to-WhatsApp (CTWA) para que exista atribuição de anúncio. - Perfil de administrador para criar/editar regras, macros e fluxos. Passo a passo 1. Abra Configurações → Automação e crie uma nova regra. 2. Escolha um gatilho de anúncio (veja abaixo) — por exemplo, "Conversa de anúncio iniciada (CTWA)". 3. Opcional: adicione condições de anúncio para refinar quando a regra roda (por exemplo, só quando a janela de 72h está expirando). 4. Adicione uma ou mais ações de anúncio (marcar como lead, enviar conversão, pausar campanha, ajustar orçamento) — ou combine com qualquer outra ação nativa. 5. Salve e ative. A regra passa a rodar automaticamente sobre as conversas de anúncio da conta. Configurações & opções Gatilhos de anúncio (Regras de Automação) - Conversa de anúncio iniciada (CTWA) — dispara quando uma conversa é aberta por um clique em anúncio. - Lead de anúncio capturado — dispara quando um lead vindo de anúncio é registrado. - Janela de 72h expirando — dispara quando restam poucas horas da janela gratuita (uma varredura periódica emite o evento uma única vez por janela). Condições de anúncio - Estado da janela de 72h — compara o estado da janela de entrada gratuita: open (aberta), expiring (expirando) ou expired (expirada). - É uma conversa de anúncio — verifica se a conversa carrega a atribuição de um anúncio (presente ou não presente). Ações de anúncio - Pausar campanha de anúncio — pausa na Meta a campanha vinculada à conversa. - Ajustar orçamento do anúncio — define o novo orçamento diário (em unidades da moeda) da campanha da conversa. - Enviar conversão para a Meta — dispara um evento de conversão (CAPI) para a conversa, reaproveitando o mesmo mecanismo do módulo de Rastreamento de conversões (por padrão, um evento Lead). - Marcar contato como lead de anúncio — promove o contato da conversa a lead. Onde cada ação está disponível - Regras de Automação: todas as ações de anúncio. - Macros (ação manual do atendente na conversa): marcar como lead de anúncio e enviar conversão para a Meta. - Flow Builder: um nó dedicado Ação de anúncio (reaproveita o mesmo executor das demais ações), além de estarem disponíveis no nó genérico de ação do Conversa Labs. Casos de uso - Não perder a janela de 72h: quando a janela está expirando, disparar um follow-up ou notificar o time antes que a conversa saia da janela gratuita. - Qualificar automaticamente: ao iniciar uma conversa de anúncio, marcar o contato como lead e aplicar etiquetas/atribuição. - Fechar o ciclo com a Meta: quando a venda é registrada, enviar a conversão de volta para a Meta para otimizar a entrega dos anúncios. - Controle de gasto: pausar uma campanha ou reduzir o orçamento a partir de uma regra quando um critério de negócio é atingido. Dicas, limites e boas práticas - Combine a condição estado da janela com o gatilho janela expirando para agir no momento certo. - As ações de anúncio não fazem nada se a conversa não tiver uma campanha/anúncio associado — use a condição é uma conversa de anúncio para evitar execuções desnecessárias. - Ajustar orçamento espera um valor numérico em unidades da moeda (por exemplo, 50 para R$ 50,00 por dia). - Pausar/ajustar orçamento agem na Meta de forma assíncrona; o espelho de campanhas reflete o novo estado no próximo ciclo de sincronização. Solução de problemas - A regra não dispara: confirme que o módulo Ads Manager está ativo e que a conversa realmente veio de um anúncio (cartão do anúncio presente na conversa). - A ação não teve efeito: verifique se a conta de anúncios está conectada e se a conversa tem uma campanha associada. - Não vejo os gatilhos/ações de anúncio: eles só aparecem nos editores quando o módulo Ads Manager está habilitado na conta. Veja também - Gerenciador de Anúncios: visão geral e conexão - Criar uma campanha de conversas por mensagem no Gerenciador de Anúncios - Janela de 72h e painéis de métricas do Gerenciador de Anúncios
Anúncios de cadastro (Lead Ads): formulários instantâneos e captação
Visão geral Lead Ads são anúncios do Facebook/Instagram com um formulário instantâneo: a pessoa preenche sem sair do aplicativo, com nome, e-mail e telefone pré-preenchidos pela Meta. Na Conversa Labs, cada envio vira contato + lead automaticamente — deduplicado, atribuído à campanha e pronto para follow-ups, CRM e conversões. Pré-requisitos - Conta de Anúncios conectada com Página do Facebook vinculada. - Termos de Lead Ads aceitos: um administrador da Página aceita uma única vez em facebook.com/ads/leadgen/tos. Sem isso a Meta recusa a campanha (o erro aparece com este link no assistente). Saiba mais em Sobre os termos de anúncios de cadastro. - Uma URL de política de privacidade do seu negócio (a Meta exige em todo formulário). Passo a passo Criar um formulário instantâneo 1. No assistente de campanha, escolha o objetivo Formulário de cadastro e, no passo Criativo, clique em Novo formulário. 2. Dê um nome ao formulário. 3. Escolha as perguntas: nome completo, e-mail e telefone (pré-preenchidos pela Meta) e, se quiser, uma pergunta personalizada. 4. Informe a URL da política de privacidade (obrigatória) e a URL do site (obrigatória — é o destino do botão na tela de agradecimento). 5. Opcional: personalize a tela de agradecimento (título e mensagem). 6. Clique em Criar formulário — ele é criado direto na sua Página da Meta e já fica selecionado. Receber os leads Nada a configurar: os envios chegam por webhook (quando a Página tem caixa de entrada do Facebook) e por varredura automática a cada 15 minutos (para qualquer instalação), sempre deduplicados. Cada lead: - vira (ou enriquece) um contato com nome, e-mail e telefone; - aparece na aba Leads do Gerenciador de Anúncios, com o formulário e a campanha de origem; - dispara o evento de automação Lead de anúncio capturado e a conversão Lead de volta para a Meta (quando o rastreamento de conversões está ativo). Configurações & opções - Reutilizar formulários — o seletor lista todos os formulários ativos da Página (inclusive os criados no Gerenciador de Anúncios da Meta); use Atualizar para re-sincronizar. - Leads por campanha — no detalhe da campanha, a seção Leads desta campanha mostra os envios atribuídos. Casos de uso - Captação de orçamentos com pergunta personalizada ("Qual seu orçamento mensal?") alimentando o CRM. - Lista de espera de lançamento caindo direto em uma sequência de follow-up. Dicas, limites e boas práticas - Os dados de cadastro são pessoais: use-os conforme sua política de privacidade e a LGPD (a Meta proíbe revender dados de cadastro). - Formulários criados aqui também aparecem no Gerenciador de Anúncios da Meta — é o mesmo objeto. - A campanha de formulário não depende do WhatsApp vinculado à Página (isso só é exigido para o destino WhatsApp nas campanhas de conversas por mensagem). Solução de problemas - "Você não pode veicular anúncios de cadastros até sua Página aceitar os Termos…" — mensagem da própria Meta: aceite em facebook.com/ads/leadgen/tos com um administrador da Página e crie a campanha novamente. - "Campos ausentes: FollowUpActionURL" — informe a URL do site no formulário (obrigatória). - Leads não aparecem — confira se a campanha está ativa na Meta e aguarde a próxima varredura (até 15 minutos). O lead aparece com o contato vinculado na aba Leads. Veja também - Criar uma campanha (Conversas por mensagem ou Formulário de cadastro) - Rastreamento de conversões de anúncios - Follow-ups automáticos
Turmas de Lançamento: distribuição em grupos de WhatsApp
Visão geral As Turmas de Lançamento resolvem um problema clássico de quem reúne público em grupos de WhatsApp para um lançamento: o grupo enche e o link de convite "morre". Com este módulo você cria uma distribuição com um link inteligente único. Quem clica é direcionado para o grupo aberto do momento; quando esse grupo atinge a capacidade definida, a plataforma cria/abre a próxima turma automaticamente e passa a direcionar os novos leads para ela. É um motor de rotação por capacidade: você divulga um só link e o sistema cuida de manter sempre um destino com vaga, sem precisar trocar o link manualmente a cada grupo lotado. Pré-requisitos - Módulo opt-in: precisa estar habilitado para a sua conta (feature flag launch_group_distribution) e a gestão exige permissão de administrador. - Um canal de WhatsApp em funcionamento para os grupos da distribuição. - A distribuição fica inerte até um administrador criar e ativar uma turma — nada acontece por padrão. Passo a passo 1. Em Growth → Turmas de Lançamento, crie uma nova distribuição. 2. Defina a capacidade por grupo (até o limite suportado pelo WhatsApp). 3. Aponte o grupo/turma inicial que receberá os primeiros leads. 4. Ative a distribuição e copie o link inteligente gerado. 5. Divulgue esse link único (anúncios, página de captura, posts, etc.). 6. Conforme os grupos enchem, o sistema abre a próxima turma e redireciona automaticamente. 7. Acompanhe o status das turmas (quantos grupos, ocupação e qual está aberto). Configurações & opções - Capacidade por turma: define quando uma turma é considerada cheia e a rotação avança. - Link inteligente: um único endereço público que sempre leva ao grupo com vaga. - Rotação automática: criação/abertura da próxima turma quando a atual atinge a capacidade. - Estado: a distribuição só funciona quando criada e ativada por um administrador. Casos de uso - Aquecimento de lançamento reunindo milhares de pessoas em grupos sem trocar o link. - Comunidades por turmas, mantendo cada grupo dentro de um tamanho gerenciável. - Combinar com Lançamentos para encher os grupos na fase de pré-lançamento. - Usar o mesmo link em anúncios click-to-WhatsApp e na página de captura. Dicas, limites e boas práticas - Respeite o limite de membros do WhatsApp ao definir a capacidade da turma. - Cuidado com o ritmo de entradas para não acionar bloqueios anti-spam do WhatsApp. - Divulgue sempre o link inteligente — nunca o link direto de um grupo específico. - Monitore a ocupação para garantir que sempre há uma turma com vaga. Solução de problemas - O link não direciona para um grupo: verifique se a distribuição está ativa e tem uma turma aberta. - Novos leads não entram em uma nova turma: confirme a capacidade e se a rotação está habilitada. - Não vejo o módulo: ele pode não estar habilitado para sua conta ou seu perfil. Veja também - Visão geral do Growth & Marketing Studio - Ads, CTWA e leadgen
Growth Social Automation: monitoramento e engajamento em redes
Visão geral O Growth Social Automation é o motor nativo de monitoramento e engajamento em redes sociais (Instagram, TikTok e YouTube). Diferente da publicação social (que envia posts), este módulo observa e interage: acompanha perfis, conteúdos e interações, e pode executar ações de engajamento (curtir/comentar/responder), funilando os resultados para prospecções, Contatos e cadências de follow-up. Para acessar capacidades que as APIs oficiais não cobrem, o módulo opera sobre um serviço auxiliar dedicado (um "gateway" de automação social) — um componente operacional que a equipe que administra a plataforma conecta. Você usa as funcionalidades dentro do painel; a operação do serviço é responsabilidade do administrador/operador. Pré-requisitos - Módulo opt-in: precisa estar habilitado para a sua conta (feature flag growth_social_automation) e a gestão exige permissão de administrador. - O serviço auxiliar (gateway de automação social) conectado pelo operador. - Uma conta/perfil social conectado para o monitoramento e o engajamento. - O módulo fica inerte até um operador conectar uma conta social. Passo a passo 1. Confirme com o administrador que o módulo e o serviço auxiliar estão disponíveis. 2. Em Growth → Social Automation, conecte a conta/perfil social a ser monitorado. 3. Defina o que monitorar (perfis, conteúdos, palavras-chave) e quais ações de engajamento permitir. 4. Configure o destino das interações relevantes (prospecção → Contato → follow-up). 5. Acompanhe as prospecções e os resultados nos relatórios/estatísticas do módulo. Configurações & opções - Monitoramento: acompanhamento de perfis e conteúdos nas redes suportadas. - Engajamento: ações como curtir, comentar e responder, conforme as regras definidas. - Funil para Contatos: interações relevantes podem virar prospecções e Contatos. - Serviço auxiliar: o gateway de automação é um componente operacional gerido pelo operador. Casos de uso - Identificar e engajar potenciais clientes que interagem com determinados conteúdos. - Transformar interações de redes em Contatos e iniciar uma cadência de follow-up. - Monitorar perfis e temas estratégicos para a operação de marketing. - Complementar a publicação social com uma camada ativa de engajamento. Dicas, limites e boas práticas - Respeite os termos e limites de cada rede social para evitar bloqueios. - Use ritmos de engajamento moderados — automações agressivas elevam o risco de bloqueio. - Mantenha o destino de Contatos consistente para não duplicar registros. - Combine com o AI Studio e a publicação social para uma operação completa. Solução de problemas - As ações não executam: verifique se o serviço auxiliar está conectado e a conta social ativa. - Não vejo prospecções: revise os critérios de monitoramento e o destino configurado. - A conta social caiu: reconecte o perfil e confira os limites/políticas da rede. - Não vejo o módulo: ele pode não estar habilitado para sua conta ou seu perfil. Veja também - Visão geral do Growth & Marketing Studio - Publicação social - Rede de Colaboração / Matriz
Rede de Colaboração / Matriz: pods de engajamento e afiliação
Visão geral A Rede de Colaboração (a Matriz) é uma camada de engajamento orgânico colaborativo e afiliação construída sobre o motor de automação social. A ideia é simples: em vez de um único perfil tentar crescer sozinho, colaboradores combinam esforços — eles engajam em conteúdos uns dos outros (pods de impulsionamento mútuo) ou em um alvo específico (boost-target), acumulando pontos por participação. A operação ganha um painel para gerenciar colaboradores, pods e regras; cada colaborador externo acessa um portal próprio (por link) ou um widget para ver tarefas e seu desempenho. Tudo isso se integra à frente do funil para potencializar o alcance orgânico das campanhas. Pré-requisitos - Módulo opt-in: precisa estar habilitado para a sua conta (feature flag social_collaboration) e a gestão exige permissão de administrador. - O motor de Growth Social Automation disponível (a Matriz é construída sobre ele). - Colaboradores conectando seus perfis sociais para participar dos pods/alvos. Passo a passo 1. Em Growth → Rede de Colaboração, habilite a Matriz e abra o painel de gestão. 2. Convide colaboradores (eles acessam um portal por link/magic-link ou um widget). 3. Crie um pod (impulsionamento mútuo entre membros) ou um boost-target (alvo a impulsionar). 4. Defina as regras de participação e a contagem de pontos por ação. 5. Os colaboradores recebem tarefas de engajamento e registram a participação. 6. Acompanhe o placar de pontos e o desempenho da rede no painel. Configurações & opções - Pods de impulsionamento mútuo: membros engajam nos conteúdos uns dos outros. - Boost-target: a rede concentra o engajamento em um alvo específico. - Pontuação: ledger de pontos por participação, base para rankings e recompensas. - Portal do colaborador: acesso externo por link/magic-link, além de um widget. - Painel do operador: gestão de colaboradores, pods, regras e acompanhamento. Casos de uso - Aumentar o alcance orgânico de um lançamento com um pod de colaboradores. - Concentrar engajamento em um conteúdo-chave (boost-target) em um período. - Estruturar um programa de afiliação/colaboração com pontuação e reconhecimento. - Complementar tráfego pago (Ads) com impulsionamento orgânico coordenado. Dicas, limites e boas práticas - Respeite os termos das redes sociais — engajamento deve ser autêntico e dentro das regras. - Defina regras de pontuação claras para manter a rede justa e engajada. - Comece com um pod pequeno e expanda conforme a operação amadurece. - Combine com AI Studio e publicação social para abastecer a rede com conteúdo. Solução de problemas - O colaborador não acessa o portal: reenvie o link/magic-link e confirme o convite. - As ações não pontuam: revise as regras de pontuação e se o perfil está conectado. - A rede não engaja: verifique se o motor de Social Automation está ativo e os pods configurados. - Não vejo o módulo: ele pode não estar habilitado para sua conta ou seu perfil. Veja também - Visão geral do Growth & Marketing Studio - Growth Social Automation - Publicação social
Leads de anúncios: próprios × de terceiros (externos)
Visão geral Na aba Leads do Gerenciador de Anúncios, cada clique em anúncio Click-to-WhatsApp (CTWA) vira um lead atribuído à campanha de origem. Mas nem todo lead que aparece ali é seu: se o seu número conectado clicar no anúncio de outro anunciante, a mensagem pré-preenchida sai do seu número e a plataforma também recebe a atribuição do anúncio — só que o inverso do lead que você quer. Para não misturar as coisas, a plataforma classifica cada lead como Próprio ou Externo: - Próprio — um contato clicou no seu anúncio e falou com você. É um lead de verdade. - Externo — foi a sua conexão que clicou no anúncio de terceiro (ou o anúncio não é um dos seus anúncios sincronizados). É guardado para referência, mas não é um lead seu. Leads externos não contam em Total, ROAS nem disparam conversão (CAPI) de volta ao Meta. Assim os números do painel refletem só os seus resultados reais. Pré-requisitos - Módulo Growth Ads (anúncios) habilitado na conta. - Nada a configurar: a classificação é automática e retroativa (os leads antigos foram reclassificados). Como a plataforma decide (dois sinais) 1. Direção — se a mensagem do anúncio foi de saída (o seu número iniciou o clique), o lead é marcado como externo (motivo self_click). Um anúncio Click-to-WhatsApp legítimo é sempre de entrada (o contato te manda a mensagem). 2. Posse — se o anúncio (source_id) não está entre os seus anúncios sincronizados, ele pertence a outro anunciante e o lead é externo (motivo foreign_ad). Se a conta ainda não sincronizou nenhum anúncio, a plataforma dá o benefício da dúvida e mantém como próprio. Passo a passo 1. Abra Gerenciador de Anúncios → Leads. 2. Use as abas de posse no topo da lista: - Próprios (padrão) — só os seus leads reais. - Externos — anúncios de terceiros que a sua conexão clicou. - Todos — os dois juntos. 3. No cartão de KPIs, o número Externos mostra quantos cliques de terceiros existem (fora do Total). 4. Na linha de um lead externo aparece o selo Externo. Clique no lead para abrir o painel de detalhes: um banner explica por que ele é externo (você clicou no anúncio, ou o anúncio é de outro anunciante) e lembra que ele não conta em Total, ROAS nem CAPI. Configurações & opções - Corrigir manualmente: quando a sua conta de anúncios não está sincronizada, a detecção automática nem sempre distingue o seu anúncio do de terceiros. Abra o lead e use Marcar como meu ou Marcar como de terceiro — marque Aplicar a todos os leads deste anúncio para corrigir o anúncio inteiro de uma vez. - Sincronize a conta de anúncios para a detecção automática ficar precisa: aí a posse é verificada sozinha (um anúncio que não é seu vira externo automaticamente). - Leads externos continuam guardados (conversa, contato e atribuição preservados). Nada é apagado. Casos de uso - Higienizar o painel: ver só os seus leads reais em Próprios para medir ROAS sem ruído. - Auditar cliques da equipe: em Externos, ver em quais anúncios de concorrentes o seu número clicou. Dicas, limites e boas práticas - Sincronize a sua conta de anúncios para melhorar a precisão do sinal de posse — sem anúncios sincronizados, a plataforma não consegue distinguir "seu anúncio" de "anúncio de terceiro" e mantém como próprio. - Um lead externo nunca promove o contato a Lead nem dispara conversão para o Meta. Solução de problemas - Um lead seu aparece como externo? Verifique se o anúncio está sincronizado (conta de anúncios conectada) e se a primeira mensagem da conversa foi realmente de entrada. - Quero ver tudo junto? Use a aba Todos. Veja também - Anúncios CTWA e formulários de lead - Rastreamento de conversões de Ads (Meta CAPI)
Rastreamento de conversões de Ads (Meta CAPI)
Visão geral A plataforma já captura o tráfego pago: anúncios click-to-WhatsApp (CTWA) e leads de formulários de anúncio (leadgen) chegam atribuídos à campanha de origem. O rastreamento de conversões é o outro lado desse ciclo: ele envia de volta ao Meta os eventos que acontecem depois — um lead capturado, o primeiro contato, uma venda fechada — pela Conversions API (CAPI). Com isso o Meta passa a otimizar as campanhas pelos resultados reais (não só pelo clique) e você mede custo por conversão e retorno sobre o investimento com dados de verdade. Pontos-chave: - A configuração é por caixa de entrada (cada inbox de WhatsApp/anúncios tem seu próprio destino). - Os eventos são deduplicados por um identificador determinístico — a mesma venda nunca é contada duas vezes. - O token nunca aparece na interface (somente presença e os 4 últimos caracteres). - Hoje o provedor ativo é o Meta Conversions API; Google Ads e TikTok existem como estrutura preparada, mas ainda não enviam eventos. A captura (CTWA/leadgen) e a conversão são módulos distintos. Este artigo trata apenas do envio de eventos de volta ao Meta. Para a captura e atribuição, veja o artigo de Ads/CTWA/leadgen. Pré-requisitos - Módulo opt-in: a sua conta precisa ter a flag ads_conversion_tracking habilitada. Ela é diferente da flag de captura (growth_ads) — é possível ter a captura sem o envio de conversões. - Permissão de administrador (toda a configuração e o disparo manual são restritos a admin). - Uma caixa de entrada de WhatsApp Cloud com a conta de WhatsApp Business (WABA) e um token do Meta com permissão para a Conversions API. Caixas de WhatsApp Web, 360dialog ou Twilio não têm WABA — nesses casos o Dataset ID e o token são informados manualmente. - Dark-ship: ao criar, a configuração nasce desligada (enabled = falso). Nada é enviado até você ligar o interruptor — de propósito, para você validar antes. Passo a passo 1. Abra Configurações do Inbox da caixa de entrada desejada e vá até a aba Conversões. 2. Token: marque usar o token do canal para reaproveitar as credenciais da própria caixa (WhatsApp Cloud já traz a WABA e um token utilizável). Em canais sem WABA, cole o token do Meta. 3. Dataset ID: clique em descobrir automaticamente — a plataforma consulta a WABA no Graph e preenche o Dataset ID para você. Em canais sem WABA, informe o Dataset ID manualmente. 4. Código de teste: informe o test event code (você o encontra no Gerenciador de Eventos do Meta, em Eventos de teste). 5. Rode um evento de teste: a plataforma dispara LeadSubmitted e Purchase sintéticos direto ao Meta, com o código de teste. Confirme que eles aparecem em Eventos de teste no Gerenciador. 6. Só depois que o teste passar, ligue o interruptor (enabled). A partir daí os eventos de ciclo de vida começam a ser enviados de verdade. O evento de teste ignora o interruptor principal e os gatilhos (ele serve justamente para validar a fiação antes de ligar). Ele exige um código de teste e credenciais do Meta válidos. Configurações & opções Gatilhos de ciclo de vida (cada um liga/desliga um evento): | Opção | Evento enviado | Padrão | | --- | --- | --- | | lead_on_capture | LeadSubmitted quando o lead é capturado | Ligado | | contact_on_first_message | ViewContent na primeira mensagem do contato | Desligado | | purchase_on_won | Purchase quando o negócio é ganho no CRM | Ligado | | purchase_on_payment | Purchase quando um pagamento é confirmado | Ligado | | custom_on_lost | um dos eventos aceitos, escolhido em lost_event_name | Desligado / nenhum evento | - Eventos aceitos pela Meta para mensagens de negócio: LeadSubmitted, QualifiedLead, ViewContent, AddToCart, InitiateCheckout e Purchase. A Meta rejeita os nomes da CAPI de site (Lead, Contact, Schedule) e eventos personalizados como Lead_Lost nesse fluxo. - Mapa de estágio do CRM → evento (stage_event_map): associe um estágio do funil a um dos seis eventos aceitos, para reportar marcos intermediários além de ganho/perda. - Advanced matching: melhora a correspondência enviando sinais adicionais do usuário (sempre com hash — nenhum dado pessoal cru sai da plataforma). - Versão da API (meta_api_version, padrão v25.0) e partner agent (meta_partner_agent, padrão Conversa Labs): identificam suas chamadas no Meta. - Token write-only: o token é gravado e mascarado — a interface mostra apenas que existe e os 4 últimos caracteres. Salvar com o campo em branco mantém o token guardado; há uma ação explícita para limpar o token quando necessário. Ledger e disparo manual Cada tentativa de envio vira uma linha no ledger de conversões, com o estado da entrega: - pending (em processamento), sent (entregue ao Meta), failed (falhou) ou skipped (ignorado). - O ledger guarda apenas o corpo com hash / sem dados pessoais que foi enviado, e a resposta do Meta para depuração. - Cada lead tem seu ledger próprio — você abre o lead e vê todos os eventos enviados por ele. Disparo manual (admin): em um lead, você pode forçar um evento — por exemplo, registrar um Purchase de um lead que converteu fora do CRM. O disparo manual: - usa um identificador determinístico por (evento, lead), então reclicar o mesmo evento deduplica (não conta duas vezes), mas tenta de novo caso a tentativa anterior tenha falhado; - aceita apenas os seis eventos de mensagens de negócio listados acima; nomes legados Lead e Contact recebidos pela API são convertidos para LeadSubmitted e ViewContent; - exige que as conversões estejam ligadas na caixa de entrada do lead. Relatórios O relatório de Ads traz as métricas de entrega das conversões, lado a lado com a atribuição: - Enviados (sent), falhos (failed) e ignorados (skipped). - Valor reportado ao Meta — a soma do valor dos eventos entregues (útil para conferir o que foi efetivamente devolvido como receita). Eventos skipped são esperados quando um negócio não tem atribuição de anúncio: a plataforma registra o evento como ignorado (visível na central de leads) em vez de enviar algo sem origem. Provedores - Meta Conversions API — provedor ativo (v1). Envia eventos de business messaging (WhatsApp) ao dataset da sua WABA, descobrindo o Dataset ID automaticamente quando não informado. - Google Ads e TikTok — existem como estrutura preparada em provider_settings, mas não enviam eventos nesta versão. Permanecem desligados por padrão. Casos de uso - Otimizar campanhas de WhatsApp pelo lead capturado e pela venda fechada, não só pelo clique. - Devolver ao Meta o valor da venda para calcular ROAS por campanha. - Registrar manualmente um Purchase de um cliente que comprou por um canal externo ao CRM. - Reportar marcos intermediários do funil mapeando estágios do CRM para eventos do Meta. Dicas, limites e boas práticas - Sempre teste primeiro: rode o evento de teste e confirme no Gerenciador de Eventos antes de ligar. - Idempotência: confie na deduplicação determinística — ganho e pagamento de um mesmo negócio colapsam em um único Purchase entregue. - Sem atribuição = ignorado: se você vê muitos skipped, verifique se as conversas/leads estão realmente chegando com a referência do anúncio (captura CTWA/leadgen saudável). - Segurança do token: nunca compartilhe o token; ele é guardado criptografado e nunca é exibido. - O envio nunca derruba o fluxo: uma falha de entrega é registrada no ledger, não interrompe o atendimento nem o CRM. Solução de problemas - conversions_not_enabled: a flag ads_conversion_tracking está desligada para a conta ou o interruptor da caixa de entrada está desligado. Habilite a flag e ligue a configuração do inbox. - Dataset não encontrado (no_conversions_dataset): clique em Detectar ou criar novamente. A operação é idempotente: devolve o dataset existente ou provisiona um para a WABA. Se o erro persistir, informe o Dataset ID manualmente e verifique a versão da Graph API. - Evento inválido (invalid_conversion_event): selecione um dos seis eventos aceitos para mensagens de negócio. Eventos de site e nomes personalizados não são aceitos pela Meta nesse fluxo. - no_permission: o token não tem escopo/validade para a Conversions API. Gere um token com a permissão correta e refaça a configuração. - O evento de teste não aparece no Gerenciador: confirme o test event code correto e que o token e a WABA pertencem à mesma conta de anúncios; veja em Eventos de teste. - Eventos saindo como skipped: o negócio não tem atribuição de anúncio — revise a captura (CTWA/leadgen) antes do envio. Veja também - Ads, CTWA e leadgen com atribuição - Visão geral do Growth & Marketing Studio - Visão geral de Pagamentos