Growth & Marketing Studio
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 ConversaLabs 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 ConversaLabs 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. - Click-to-Messenger e Click-to-Instagram Direct — um clique em anúncio que abre uma conversa no Messenger ou no Instagram Direct vira um lead de anúncio com essa origem, um por conversa. Ele aparece na central de leads (com aba própria quando há leads) e aciona os mesmos fluxos de lead: automações, follow-ups, distribuição de grupos, webhooks e o evento de conversão. Ações exclusivas do WhatsApp são ignoradas com registro nessas conversas, nunca enviadas pelo canal errado. No painel lateral da conversa e no drawer de detalhes do lead, a prévia mostra a origem e o título do anúncio, além da imagem quando a Meta fornecer photo_url. 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 do anúncio e os painéis de métricas (gasto, conversas, ROAS). - A janela gratuita do anúncio CTWA (aberto pelo app do WhatsApp no Android ou no iOS) abre quando a empresa responde dentro das 24 horas da mensagem do cliente e pode ficar aberta por até 7 dias. Responda dentro dessas 24 horas para que ela abra: enquanto estiver aberta, toda mensagem para esse cliente é gratuita. 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 gratuita do anúncio 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 ConversaLabs 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 ConversaLabs 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 uma pessoa falando): 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. - A Meta retirou os posicionamentos Explorar do Instagram e Stories do Messenger, e o assistente não os oferece mais. Um rascunho antigo que ainda os tenha mostra o posicionamento marcado com o aviso Retirado pela Meta: desmarque-o. Se ele estiver junto de outros posicionamentos da mesma plataforma, é removido na criação e os demais seguem valendo. Se for o único escolhido daquela plataforma, a criação é recusada com uma mensagem pedindo outro posicionamento; a plataforma nunca é ampliada por conta própria. 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 - Primeiros passos - Gerenciador de Anúncios: visão geral e conexão - Anúncios de cadastro (Lead Ads) - Janela gratuita do anúncio (até 7 dias) e insights - Automação com anúncios
Janela gratuita do anúncio (até 7 dias), insights e automação de anúncios
Visão geral Quando um cliente chega por um anúncio Click-to-WhatsApp e a empresa responde a tempo, a Meta abre uma janela gratuita do anúncio que pode ficar aberta por até 7 dias. Enquanto ela está aberta, toda mensagem enviada a esse cliente é gratuita. A ConversaLabs 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 gratuita do anúncio - Vale para anúncios Click-to-WhatsApp que abrem a conversa pelo app do WhatsApp no Android ou no iOS. - A regra da Meta, literal: se você responde dentro da janela de atendimento usando qualquer tipo de mensagem, a mensagem é gratuita e a janela gratuita abre a partir do momento em que você respondeu; ela pode ficar aberta por até 7 dias e, enquanto aberta, você pode enviar qualquer tipo de mensagem sem cobrança. - O relógio começa na primeira resposta da empresa, e não na mensagem do cliente. Essa resposta precisa sair dentro da janela de atendimento, ou seja, até 24 horas depois da última mensagem do cliente; sem resposta nesse prazo, a janela gratuita não abre. - Só a resposta enviada pela API Cloud abre a janela. Numa caixa híbrida, uma resposta pelo WhatsApp Web não a abre: a próxima resposta pela Cloud dentro do prazo é a que abre. - Quando a conversa do anúncio começa, na mensagem do cliente, a plataforma já registra a janela, que fica aguardando a primeira resposta com o prazo de 24 horas para responder. Quando a empresa responde dentro desse prazo, a janela gratuita abre. - A partir dessa resposta, a janela pode ficar aberta por até 7 dias (antes eram 72 horas). Dentro dela, mensagens de qualquer tipo, inclusive modelos, são gratuitas. - Quando a Meta informa na mensagem o horário exato de fim da janela, a plataforma usa esse horário. Sem essa informação, ela conta 7 dias a partir da primeira resposta. - A janela de atendimento de 24 horas não mudou e continua valendo à parte: ela define quando você pode responder com texto livre. - Estados: aguardando a primeira resposta, aberta, expirando (menos de 6h restantes) e expirada. O aviso de "janela expirando" e as automações dele só disparam depois que a janela abriu. - Se a Meta cobrar uma mensagem que a plataforma considerava dentro da janela, a janela é encerrada na hora, para que o aviso do campo de resposta nunca diga "gratuita" para algo cobrado. - Se a Meta informar que a primeira resposta foi gratuita só pela janela de atendimento de 24 horas, e não pela janela do anúncio, a janela não abriu: ela é encerrada do mesmo jeito. - 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 do anúncio". - Ações: marcar contato como lead, enviar conversão ao Meta (CAPI), pausar campanha, ajustar orçamento. Passo a passo 1. Escolha a janela de análise e confira se a conta de anúncios está conectada antes de comparar os indicadores. Configurações & opções - Ajuste período, campanha e filtros conforme a pergunta de negócio, sem comparar janelas com fusos diferentes. Casos de uso - Identificar uma campanha com queda de resultados e priorizar a revisão do orçamento ou criativo. Dicas, limites e boas práticas - Responda dentro das 24 horas da mensagem do cliente: é essa primeira resposta que abre a janela gratuita de até 7 dias. - Para ver quais mensagens saíram grátis pela janela do anúncio, abra a Central de custos do WhatsApp: o motivo aparece como Janela gratuita do anúncio (até 7 dias). - 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). - A janela gratuita não abriu: a empresa não respondeu dentro das 24 horas da última mensagem do cliente, a resposta saiu pelo WhatsApp Web (só a API Cloud abre a janela), a Meta cobrou a resposta ou a Meta informou a resposta como gratuita só pela janela de atendimento. 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 ConversaLabs 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 gratuita do anúncio 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 do anúncio expirando — dispara quando restam poucas horas da janela gratuita do anúncio (uma varredura periódica emite o evento uma única vez por janela). A janela abre na primeira resposta da empresa, enviada dentro das 24 horas da mensagem do cliente, e dura até 7 dias. Quando a Meta informa o fim exato da janela na mensagem, o gatilho usa esse horário. Condições de anúncio - Estado da janela do anúncio — compara o estado da janela gratuita do anúncio: 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 ConversaLabs. Casos de uso - Não perder a janela gratuita do anúncio: quando a janela está expirando, disparar um follow-up ou notificar o time antes que a conversa saia da janela gratuita de até 7 dias. - 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 gratuita do anúncio 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 ConversaLabs, 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 - Primeiros passos - 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: grupos de WhatsApp e rotação de vendedores
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". Você cria uma turma com um link inteligente único. Quem clica é levado ao grupo aberto do momento. Quando esse grupo atinge a capacidade definida, a plataforma cria o próximo grupo sozinha e passa a direcionar os novos leads para ele, sem que você troque o link divulgado. Cada turma tem um tipo de destino: - Grupo: grupos padrão do WhatsApp, criados automaticamente conforme enchem. - Comunidade: uma Comunidade do WhatsApp com os grupos dentro dela. - Canal: um canal de transmissão já existente, em que as pessoas entram pelo link de convite. - Rotação de vendedores: cada lead abre uma conversa individual com um dos seus vendedores no WhatsApp. Nenhum grupo é criado. Neste artigo, turma é o que você cria na lista de Turmas de Lançamento, e grupo é cada grupo de WhatsApp criado dentro dela. No quadro da turma, cada grupo aparece numerado ("Turma 1", "Turma 2" e assim por diante), e algumas opções o chamam de unidade. Pré-requisitos - Módulo opt-in: precisa estar habilitado para a sua conta (feature flag launch_group_distribution). - Permissões: agentes podem ver as turmas. Criar, editar, ativar, pausar e recuperar turmas é para administradores e para papéis personalizados com a permissão Gerenciar turmas de lançamento. - Uma caixa de entrada WhatsApp Web conectada, ou uma caixa híbrida com o lado WhatsApp Web ativo. É ela que cria e administra os grupos. Uma caixa só da API Cloud não aparece na lista. - A rotação de vendedores depende de uma liberação feita pelo operador da plataforma. Sem ela, a opção aparece desabilitada. - A turma fica inerte até ser ativada. Nada acontece por padrão. Passo a passo 1. Em Crescimento → Turmas de Lançamento, clique em Nova turma. 2. Em Básico, dê um nome e escolha: - a Caixa de entrada do WhatsApp; - as Caixas de entrada da rotação, se quiser repartir a criação dos grupos entre vários números; - o Tipo de destino e o Modo de entrada; - a Capacidade por turma, que é a capacidade de cada grupo; - o Modelo de nome dos grupos. 3. Em Distribuição, escolha como a plataforma decide o grupo e, se quiser, crie Regras de roteamento. Na rotação de vendedores, esta aba se chama Vendedores. 4. Em Agenda, defina, se quiser, a data em que a turma deve terminar. 5. Em Entrada e saída, escolha os Gatilhos de entrada, as listas de bloqueio e de permissão e a Página de espera. 6. Em Mensagens, escreva a Mensagem de boas-vindas e os textos de cada momento. 7. Em Destinos, defina a identidade e as permissões dos novos grupos. Se o destino for um canal, informe o canal existente. Na rotação de vendedores, esta aba não aparece. 8. Em Configurações, ajuste o ritmo de envio e o intervalo entre os passos de criação. 9. Clique em Salvar. Uma aba com campo pendente aparece marcada como "(revisar)", e o botão Ir para leva até ela. 10. Na lista, use Ativar. A plataforma já prepara o primeiro grupo para que o link tenha destino assim que for divulgado. 11. Clique no endereço da coluna Link inteligente para copiá-lo e divulgue-o em anúncios, páginas de captura e posts. 12. Acompanhe a turma pelo botão Abrir. A aba Turmas mostra o quadro dos grupos, e a aba Membros mostra quem entrou, quem está na fila e quem falhou. Há também Engajamento e, na rotação de vendedores, Vendedores. O quadro se atualiza sozinho quando um grupo é criado, abre ou lota e quando membros entram ou saem. Se algo parecer desatualizado, use Atualizar. Configurações & opções Destino, capacidade e modo de entrada - Capacidade por turma: quantas pessoas cada grupo recebe antes de a plataforma passar para o próximo. O padrão é 256, ou o valor definido nos padrões da conta, e o máximo configurável é 1.023. Usar capacidade máxima preenche esse valor somente quando você clica. A Margem de segurança começa em 0 e reserva vagas abaixo do limite de 1.024 do WhatsApp. Por exemplo: capacidade 1.023 e margem 24 permitem até 1.000 pessoas; capacidade 256 continua permitindo 256. A origem da margem aparece no formulário, com opção de personalizar ou restaurar o valor herdado. Unidades existentes sem capacidade personalizada acompanham as edições da turma; uma capacidade personalizada por unidade prevalece. A capacidade já salva da turma não é aumentada automaticamente. Uma comunidade comporta até 2.000 pessoas no total; depois disso, o WhatsApp pode recusar o vínculo, e os grupos novos abrem normalmente, fora da comunidade. Um canal não tem limite de seguidores. - Modo de entrada: - Link de convite: a pessoa recebe o link do grupo e toca para entrar; - Adição direta: a pessoa é adicionada diretamente ao grupo, o que depende do consentimento dela no WhatsApp; - Ambos: a plataforma tenta a adição direta e, se não der, envia o link de convite. Em um canal, só existe o link de convite. - Caixas de entrada da rotação: sem seleção, a caixa principal cria todos os grupos. A ordem é preservada e novas seleções entram no final. A lista mostra o nome completo, o número quando disponível e o estado da conexão: conectada, desconectada ou desconhecida. Em uma caixa híbrida, o estado corresponde ao lado WhatsApp Web. Use os botões de mover para cima ou para baixo para escolher a ordem; pelo teclado, pressione Alt + ↑ ou Alt + ↓ com o foco em um controle da linha selecionada. O foco acompanha a caixa, e a nova posição é anunciada ao leitor de tela. Uma caixa selecionada que deixou de aparecer entre as disponíveis continua identificada pelo ID: você pode movê-la ou removê-la explicitamente, sem perder as outras seleções. Em caso de erro ao carregar, use Tentar novamente. Essas escolhas definem quem cria os próximos grupos; outra caixa não assume os grupos já criados. Como a plataforma escolhe o grupo Em Distribuição → Como escolher a unidade: - Encher a primeira (padrão): todos vão para o grupo aberto de menor número até ele lotar. - Revezar entre as abertas: a plataforma alterna entre os grupos abertos, em sequência. - Sortear: a plataforma escolhe ao acaso um dos grupos abertos. Na maior parte do tempo existe só um grupo aberto, porque a plataforma cria o próximo apenas quando nenhum tem vaga. Essas opções fazem diferença quando há mais de um grupo aberto ao mesmo tempo, por exemplo quando um grupo que estava cheio volta a ter vaga porque pessoas saíram. Regras de roteamento As regras podem encaminhar o lead para outra turma conforme as UTMs, a etiqueta do contato ou a origem de entrada. No link inteligente, as regras recebem as UTMs do endereço e a origem link; as etiquetas do contato não estão disponíveis nesse caminho. Nas entradas por eventos atendidos pelos gatilhos, recebem o contato e a origem event; na ação de inscrição de uma automação, recebem o contato e a origem automation. Esses dois caminhos não recebem as UTMs do link. A inscrição manual pelo botão Inscrever vai diretamente para a turma escolhida, sem consultar essas regras. - Cada regra combina condições, uma por campo. Para o link, use Origem da campanha (utm_source) e Nome da campanha (utm_campaign). - Todas as condições de uma regra precisam corresponder. Para as UTMs, maiúsculas e espaços nas pontas não fazem diferença. A etiqueta (tag) precisa existir no contato com o mesmo valor, e a origem de entrada (source) precisa corresponder exatamente à origem da inscrição. - Para Origem de entrada, escolha uma das opções fornecidas pelo servidor; nomes de eventos não são origens de inscrição. Para Etiqueta, escolha uma etiqueta da sua conta. Valores antigos que deixaram de estar disponíveis continuam visíveis até você escolher um substituto ou remover a condição. UTMs continuam sendo texto livre. - A primeira regra que corresponder decide. Use as setas para mudar a ordem. Sem correspondência, o lead segue nesta turma. - O destino precisa ser outra turma ativa. Uma regra que aponta para uma turma pausada, arquivada ou concluída é ignorada, e a próxima regra é avaliada. - A turma de destino pode ter as próprias regras. A plataforma segue no máximo três encaminhamentos e interrompe qualquer ciclo, deixando o lead na turma em que estiver. - Use Testar um link para colar um link com UTMs e ver qual regra ele aciona antes de divulgar. Para começar por um exemplo: 1. Em Destino dos exemplos, escolha outra turma ativa da sua conta. Se não houver destino disponível, crie ou ative outra turma e volte ao formulário. 2. Escolha o exemplo do Instagram (utm_source = instagram), de campanha (utm_campaign = black-friday) ou com duas condições (utm_source = google E utm_campaign = lancamento). A regra entra ao fim da lista; as regras anteriores, sua ordem, os valores já digitados e o link de teste são preservados. 3. Use Preencher link do exemplo para alterar somente o campo de teste. O endereço ilustrativo não é aberto. Confira o Resultado esperado no rascunho atual: uma regra anterior pode ter prioridade sobre o exemplo. 4. Revise o destino, as condições e a ordem, depois clique em Salvar. O teste lê somente utm_source e utm_campaign da URL. Ele não avalia tag nem source, não salva regras e não inscreve ninguém; também não confirma vagas nem as regras da turma de destino. Por exemplo, ?utm_source=instagram corresponde ao exemplo do Instagram; o mesmo link sem essa UTM não corresponde a essa regra. Se a configuração de roteamento salva tiver formato inválido, o valor original continua visível. Substituir configuração inválida limpa somente esse valor no rascunho; revise as regras herdadas, monte regras válidas e salve para aplicar o reparo. Editar outro campo preserva a configuração antiga sem converter seus valores. Data de encerramento e conclusão Em Agenda → Encerrar a turma em, você define quando a turma termina. - Depois dessa data, nenhum grupo novo é criado e ninguém mais da fila é colocado em grupo. - Na verificação seguinte, que acontece a cada poucos minutos, a turma passa a Concluída, desde que nenhum grupo esteja em criação. Quem ainda estava na fila nesse momento não entra em grupo e aparece em Membros como Ignorado. - Entre a data e a conclusão, o link inteligente ainda pode levar a um grupo que continue aberto. Depois de concluída, a turma não aceita novas inscrições. - Sem data, a turma continua até você pausá-la. - Se a data escolhida já passou, a tela avisa que a turma pode concluir no próximo ciclo. Use Limpar a data para removê-la. Pausar, arquivar, restaurar e duplicar - Pausar interrompe novas entradas: o link inteligente deixa de levar a um grupo e os membros na fila não são alocados. Os grupos já criados continuam existindo no WhatsApp. - Arquivar pausa a turma e a tira da lista principal (filtro Arquivadas). Nada é excluído. - Restaurar devolve a turma arquivada como rascunho. Ative-a de novo para voltar a receber leads. - Duplicar cria uma cópia da configuração, útil para mudar um campo travado. A cópia nasce com outro endereço de link inteligente, sem a data de encerramento e sem as imagens dos grupos: revise esses campos antes de ativar e divulgue o link novo. Página de espera e link indisponível - Página de espera (em Entrada e saída): o endereço para onde vai quem clica no link quando ainda não há grupo aberto, ou quando a turma está em rascunho, pausada, arquivada ou concluída. - Sem esse endereço, o visitante vê uma página curta dizendo que o link não está disponível no momento. Os detalhes estão em O que o visitante vê quando o link não está disponível, em Solução de problemas. Gatilhos de entrada e listas - Gatilhos de entrada: inscrevem contatos automaticamente na turma quando um evento escolhido acontece, como uma cobrança paga, um negócio do CRM ganho ou um comentário capturado. São aceitas as 22 opções do catálogo fornecido pelo servidor, com nome e descrição traduzidos; nomes de outros eventos da plataforma não são automaticamente gatilhos de entrada. Para cobranças pagas, use payment_charge.paid: payment_charge.confirmed é um alias de emissão, não uma opção aceita na configuração. Uma lista vazia desliga a inscrição automática por eventos. Use a busca para encontrar uma opção por nome, descrição ou chave e marque as que deseja usar. A busca não esconde os itens já salvos. Se o catálogo não carregar, tente novamente: isso atualiza as opções sem apagar os valores e as alterações em andamento. Configurações antigas com chaves desconhecidas precisam ser corrigidas ou removidas explicitamente: os itens ficam visíveis, e escolher um substituto só altera a lista depois de aplicar o reparo. Um valor salvo em formato inválido também é mostrado; substituí-lo por uma lista vazia é uma ação explícita, a confirmar ao salvar. Nada é convertido nem descartado silenciosamente. Uma edição de outro campo pode manter exatamente a lista antiga, mas, ao alterar os gatilhos, toda a lista precisa ser válida. Criar ou duplicar uma turma também exige uma lista válida. A API recusa listas inválidas com HTTP 422 e o código invalid_entry_triggers. Estar no catálogo não garante que o evento seja produzido, que o módulo esteja habilitado ou que o contato possa entrar. Em particular, commerce.due_soon ainda não tem produtor automático. - Lista de bloqueio e Lista de permissão: um número por linha. Um número nas duas listas fica bloqueado. Com a lista de permissão preenchida, só os números dela entram. Quem é barrado aparece em Membros como Ignorado. - Inscrever (no detalhe da turma): cole números de WhatsApp, um por linha. A plataforma remove duplicados, ignora os números barrados pelas listas e informa quantos entraram na fila. Os números colados só entram no grupo nos modos Adição direta e Ambos, quando a adição dá certo. No modo Link de convite, eles aparecem como Convidado, mas ninguém recebe o link: um número colado não fica ligado a um contato, e o convite só sai para contatos que já têm conversa com a plataforma. Mensagens - Mensagem de boas-vindas: nos modos Link de convite e Ambos (quando a pessoa recebe o convite), a plataforma tenta enviar a mensagem e o link do grupo para quem entra na fila por um gatilho, uma automação ou pela API, na conversa que já tem com o contato. Quem não tem conversa, ou foi inscrito só pelo número, não recebe esse envio. Quem clica no link inteligente já está a caminho do grupo e também não o recebe. Você pode usar variáveis, como o primeiro nome do contato. - Variações de spintax: cadastre versões alternativas. Cada envio sorteia uma delas, o que deixa as mensagens menos repetitivas. O botão Gerar variações com o Maestro sugere variações. - Mídia da mensagem: use Enviar arquivo, Escolher da biblioteca ou Colar link no campo disponível. Upload e biblioteca dependem da habilitação e do acesso à biblioteca da conta; sem acesso, use um link permitido. Se uma seleção falhar, o valor anterior é mantido. Aguarde o upload terminar e clique em Salvar para aplicar a escolha. Links externos devem usar HTTPS; HTTP só é aceito para arquivo da própria plataforma, autorizado para a conta. - Momentos com mídia: boas-vindas (welcome) e abertura da unidade (unit_opened) têm caminho de envio de mídia. Na lista de mensagens por momento, a abertura da unidade é a opção com mídia disponível; boas-vindas usa seu próprio editor. Os outros cinco momentos — lembrete, contagem regressiva, confirmação da lista de espera, aviso de remoção e aviso de graduação — estão indisponíveis para nova mídia: ainda não há envio automático conectado a eles. A mídia antiga é preservada e pode ser removida para corrigir a configuração. Salvar um texto ou arquivo não programa, por si só, um disparo. - Duas mensagens com mídia: no fluxo com mídia, a plataforma prepara primeiro a mensagem de texto com o convite e o cartão do grupo, depois uma mensagem separada com o arquivo. As mensagens aparecem separadas na conversa. Um registro local ou envio para a fila não confirma entrega nem leitura no WhatsApp. - Seletores de modelo indisponíveis para envio: Modelo enviado, em Mensagem direta ao entrar, e Aviso enviado antes da remoção, em pós-compra, usam os IDs de modelo fornecidos pelo servidor. Você pode corrigir um ID antigo ou restaurar a herança, mas esses dois campos ainda não estão ligados ao envio. Salvar o ID não dispara uma mensagem nem agenda um aviso, mesmo escolhendo boas-vindas ou abertura da unidade. Isso é separado dos fluxos com mídia acima. Foto da turma e de cada grupo Em Destinos, configure a foto da identidade da turma. Para personalizar apenas um grupo, use as configurações desse grupo no quadro. A foto personalizada do grupo prevalece sobre a identidade da turma. Sem foto personalizada, vale a identidade da turma; sem ela, a URL herdada, quando houver. Remover mídia na foto do grupo restaura a imagem herdada depois de salvar. - Use arquivo JPEG ou PNG de até 8 MiB (8.388.608 bytes), enviado do computador, escolhido da biblioteca ou indicado por link. O teto é da foto; não é um limite geral para todo anexo de mensagem. - Para links externos de foto, use HTTPS. HTTP é aceito somente para um arquivo da própria plataforma, autorizado para a conta; não use um endereço HTTP externo nem altere um link da biblioteca para tentar torná-lo válido. - Arquivo ou link recusado preserva a seleção anterior. Escolher e salvar a imagem não confirma, por si só, que a foto já foi aplicada no WhatsApp. Histórico de mensagens do grupo A seleção e o envio de originais históricos pela interface de Turmas ainda não estão disponíveis. A política definida para esse recurso distingue: - Automático com prova: exige autoria empresarial comprovada dos originais e verificação completa do conjunto de mensagens considerado. Essa prova ainda está ausente; o envio automático permanece indisponível. - Antigos por seleção manual: prevê escolher até 100 originais, com prévia. Esse fluxo também está indisponível na interface atual. A escolha manual não deve ser chamada de "últimas da empresa" e não comprova autoria empresarial, retenção dos originais ou entrega das mensagens. A existência de registros locais não demonstra quais são as mensagens mais recentes nem garante retenção por 90 dias. Uma falha ou um resultado não confirmado não autoriza reenviar como uma tentativa nova ou com novos identificadores; preserve a tentativa existente para conferência. Rotação de vendedores Com o tipo de destino Rotação de vendedores, o link inteligente não leva a um grupo: ele abre uma conversa no WhatsApp com um dos seus vendedores, já com uma mensagem pronta, como "Olá! Vim pelo link e quero saber mais.". Nenhum grupo é criado. Os vendedores ficam na aba Vendedores do detalhe da turma. - Adicionar vendedor: informe o nome, o telefone com DDI e DDD e o peso. Um mesmo telefone não pode aparecer duas vezes. Na linha do vendedor, você pode vincular uma Caixa de entrada e um Agente vinculado. - Ordem e Pausado: reorganize a fila com as setas e pause um vendedor sem removê-lo. - Como escolher o vendedor: Revezar em ordem (padrão), Ponderado pelo peso (um vendedor com peso 2 recebe, em média, o dobro de quem tem peso 1) ou Sortear. - Limite diário por vendedor: quantos leads cada vendedor recebe por dia; 0 significa sem limite. O dia segue o fuso horário da conta. Cliques repetidos do mesmo navegador e da mesma rede em menos de 30 minutos não contam de novo. - Pausar quem estiver offline: pula o vendedor cujo agente vinculado está offline. - Sem nenhum vendedor disponível (todos pausados, offline ou no limite do dia), o link usa a Página de espera ou mostra a página de indisponibilidade. Com a turma ativa e nenhum vendedor cadastrado, ou com todos pausados, a aba avisa que os leads estão indo para o destino alternativo. - Enquanto o operador da plataforma não liberar a rotação de vendedores, a aba mostra os vendedores em modo somente leitura. Configuração herdada e "Restaurar padrão" Algumas opções podem vir de três origens: o padrão do sistema, a configuração da conta ou um valor definido nesta turma. O valor da turma vence o da conta, e o da conta vence o padrão. Um chip ao lado da opção mostra de onde vem o valor que está valendo. - Na aba Vendedores, cada opção começa herdada ("Valor herdado: …"). Use Personalizar para definir um valor só para esta turma, ou Herdar para desistir antes de salvar. - Quando a opção já tem um valor salvo na turma, aparece Restaurar padrão. Ele apaga a personalização, e a turma volta a seguir a conta ou, sem ela, o padrão do sistema. Ele não copia o valor herdado para a turma. - No formulário, o intervalo entre os passos de criação funciona do mesmo jeito: o chip mostra "Herdado do padrão do sistema" ou "Definido nesta turma", e Restaurar o padrão volta ao valor herdado. - Os campos Máx. de envios por segundo e Máx. de envios por hora, em branco, usam o padrão do sistema. Os dois limites valem juntos. Grupos: identidade, convite e membros - Coadministradores adicionais: opcional. O número conectado da caixa de entrada já cria o grupo como proprietário; informe apenas as outras pessoas que também devem administrar os grupos. - Máx. de tentativas confirmadas por turma: em Hub WhatsApp → Configurações → Limitação de transmissão, defina por caixa de entrada quantas recusas confirmadas do WhatsApp cada grupo pode ter antes de a turma ser pausada. Nessa tela, "turma" é cada grupo, e o limite vem da caixa que cria aquele grupo. O mesmo limite vale para as recusas dos ajustes opcionais do grupo, mas aí a turma não é pausada: o ajuste é deixado de lado e o grupo abre assim mesmo. A tela informa se o valor vem desta caixa, da conta ou do padrão da instalação. Timeout e resultado incerto nunca usam esse limite e continuam exigindo reconciliação. - Campos travados depois do primeiro grupo: assim que a turma cria o primeiro grupo, a caixa de entrada, o tipo de destino e o endereço do link inteligente ficam fixos, porque os grupos já criados pertencem a eles. O formulário mostra esses campos como somente leitura e o servidor recusa a alteração. Para mudar, duplique a turma e ajuste a cópia antes de ativá-la; a cópia tem outro link inteligente. Um endereço que já foi usado por mais de uma turma não pode ser escolhido: ele está aposentado em definitivo (veja Endereço usado por mais de uma turma, em Solução de problemas). - Link de convite de cada grupo: administradores e papéis com Gerenciar turmas de lançamento podem gerenciar o convite dos grupos abertos, em grupos e comunidades; essas ações não se aplicam a canais. No quadro, Buscar link de convite relê do WhatsApp o link que o grupo tem agora (é a correção segura quando o link guardado ficou desatualizado). Gerar novo link de convite é diferente: ele revoga o link atual, então todo link já divulgado em anúncio, post ou mensagem enviada para de funcionar na hora. A plataforma pede confirmação, nomeando o grupo, antes de fazer isso. Quando o convite é confirmado, o link inteligente da turma passa a apontar para ele. Se outra atualização do convite estiver em andamento, aguarde a conclusão antes de tentar novamente. Se a resposta não confirmar o novo link, use Buscar link de convite para recuperar o convite atual antes de divulgá-lo. Enquanto um novo link está sendo gerado, o anterior não fica disponível para cópia. Se a tela não conseguir confirmar o convite atual, use Tentar novamente para consultá-lo antes de divulgá-lo; essa consulta não gera outro link nem revoga um convite. - Estados dos membros: em Membros, filtre por estado e por origem. Os estados são Pendente, Na fila, Convidado, Adicionado, Entrou, Falhou, Ignorado, Na lista de espera, Saiu, Removido e Graduado. - Tentar novamente os que falharam: na aba Membros, administradores e quem tem a permissão Gerenciar turmas de lançamento em um papel personalizado podem devolver à fila todos os membros em Falhou; eles serão alocados no próximo grupo aberto. A plataforma informa quantos voltaram para a fila, e esse número vem do servidor, não da página que você está vendo. Antes de confirmar, o diálogo consulta a quantidade total de falhas da turma e informa que os filtros e a página não limitam a ação. Se essa consulta falhar, carregue a quantidade novamente; a confirmação fica desabilitada até haver uma contagem válida. O que fica registrado de cada clique Quando alguém clica no link inteligente, a plataforma registra a campanha de origem (utm_source, utm_medium, utm_campaign, utm_term e utm_content), o domínio da página de onde a pessoa veio, a família do navegador e um código resumido derivado do endereço IP. O endereço IP, o navegador completo e o endereço completo da página de origem não são guardados. Na rotação de vendedores, o clique também registra qual vendedor recebeu o lead. 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. - Uma turma por canal de aquisição: um único link nos anúncios, com regras de roteamento que levam quem vem do Instagram, do YouTube ou de uma campanha específica para a turma certa. - Atendimento comercial 1:1 com rotação de vendedores, respeitando o limite diário de cada um. - Inscrever automaticamente quem chega por um anúncio click-to-WhatsApp, com o gatilho Lead de anúncio capturado (CTWA / formulário). - Usar o mesmo link inteligente em anúncios com link, posts e na página de captura. Dicas, limites e boas práticas - Divulgue sempre o link inteligente, nunca o link direto de um grupo específico. - Respeite o limite de membros do WhatsApp ao definir a capacidade. Para reservar vagas abaixo do teto de 1.024, configure a Margem de segurança; o padrão é 0. Entradas manuais e convites já compartilhados podem ocupar vagas antes da próxima atualização da contagem. - Cuidado com o ritmo de entradas para não acionar bloqueios anti-spam do WhatsApp. Use o Ritmo de envio em Configurações para limitar os envios por segundo e por hora. - Gerar um novo link de convite invalida os links já divulgados. Prefira Buscar link de convite, que só relê o link atual, e só revogue quando for intencional. - Em um canal, ninguém é adicionado diretamente. O WhatsApp só permite entrar em um canal pelo link de convite, então uma turma com destino Canal é sempre por link, e as ações de buscar ou gerar convite não se aplicam. - A criação automática de canais ainda está em modo somente-teste e não está disponível para as contas. O canal precisa existir antes, criado por exemplo em Hub WhatsApp → Canais → Criar canal. A turma de canal só ativa com o Identificador do canal e a URL de convite do canal preenchidos em Destinos, e hoje nenhuma tela da plataforma mostra esse identificador. Um canal existente não pode ter nome, descrição ou foto alterados pela plataforma. - Teste as regras de roteamento com Testar um link antes de publicar anúncios com UTMs. - Na rotação de vendedores, mantenha pelo menos um vendedor sem pausa e com limite diário compatível com o volume esperado. - Monitore a ocupação para garantir que sempre haja um grupo com vaga. Solução de problemas - O link não direciona para um grupo: verifique se a turma está ativa e tem um grupo aberto. - Novos leads não entram em um novo grupo: confirme a capacidade e se a turma não passou da data de encerramento. - A regra de roteamento não levou o lead para outra turma: identifique o caminho de entrada. No link inteligente, confira as UTMs e a origem link. Nos eventos atendidos pelos gatilhos e na ação de inscrição da automação, confira as etiquetas do contato e a origem literal event ou automation, respectivamente. Verifique também se a turma de destino está ativa e se uma regra anterior corresponde primeiro. O botão Inscrever não passa pelo roteamento. Testar um link confere somente UTMs; não simula etiquetas nem origem de entrada. - A turma não conclui: a conclusão só acontece depois da data em Encerrar a turma em, e só quando nenhum grupo estiver em criação. Sem data, a turma nunca conclui sozinha; para encerrá-la, pause-a ou arquive-a. - A opção Rotação de vendedores aparece desabilitada: ela depende de uma liberação do operador da plataforma. - O link da rotação de vendedores leva à Página de espera ou à página de indisponibilidade: nenhum vendedor está disponível naquele momento. Todos estão pausados, offline (com Pausar quem estiver offline ligado) ou no limite do dia. A aba Vendedores só mostra o aviso quando não há vendedor cadastrado ou todos estão pausados; nos outros casos, confira o status dos agentes e o limite diário. - Não consigo ativar uma turma de canal: a plataforma não ativa uma turma de canal sem o Identificador do canal e a URL de convite do canal em Destinos. Hoje nenhuma tela mostra o identificador do canal, então a turma de canal ainda não pode ser ativada só pela plataforma. - O grupo falhou ao ser criado: abra o grupo no quadro para ver o diagnóstico. Ele diz o que aconteceu, em qual etapa, quantas tentativas já houve e quando será a próxima tentativa automática. Revise a conexão da caixa de entrada e os coadministradores adicionais. - O grupo já existe e a configuração está em andamento: quando o grupo já existe no WhatsApp, a plataforma retoma o trabalho pendente sozinha. O card diz isso e não oferece "Confirmar ausência", porque autorizar uma nova tentativa nesse caso criaria um grupo duplicado. A ação de confirmar ausência só aparece quando a plataforma permite reconciliar uma criação não confirmada. A ausência de um grupo registrado na plataforma não prova sua ausência no WhatsApp: o administrador precisa conferir antes de confirmar. - O grupo está aberto, mas com ajustes pendentes: um grupo pode abrir e receber membros mesmo que um ajuste opcional não tenha sido aplicado (logo, descrição, coadministradores, vínculo com a comunidade). O card lista exatamente quais passos ficaram de fora. Esses ajustes não são reaplicados automaticamente: corrija a configuração e aplique-os no WhatsApp quando quiser. A permissão de envio, a aprovação de entrada (quando pedida) e o link de convite (nos modos com link) são etapas essenciais: precisam ser aplicadas antes que o grupo seja aberto. - A conta criadora não está disponível ou perdeu acesso ao grupo: outra caixa da rotação não assume um grupo já criado. Verifique a conexão e o acesso da conta criadora no WhatsApp. Quando o diagnóstico pedir correção de configuração, mantenha a turma pausada até corrigir o acesso e reative-a depois. - Resultado não confirmado pelo WhatsApp: a turma é pausada para não criar um grupo duplicado; confirme primeiro no WhatsApp se o grupo existe. Somente se ele não existir, use Confirmar ausência e tentar novamente: a ação reaproveita o mesmo grupo da sequência, sem criar outra sequência. - Excluir uma turma não exclui os grupos do WhatsApp: a exclusão remove a configuração, os grupos registrados na plataforma e o histórico de membros. Os grupos criados continuam existindo no WhatsApp e, se você quiser encerrá-los, isso precisa ser feito por lá. - Endereço usado por mais de uma turma: o link inteligente não traz o nome da conta, então um mesmo endereço nunca pode pertencer a duas turmas, e a plataforma impede isso em definitivo. Se a sua instalação já tinha turmas com o mesmo endereço, a plataforma aposentou esse endereço para sempre e deu a cada turma afetada um endereço novo, formado pelo endereço antigo seguido do número da conta (por exemplo, promo passa a ser promo-12), com sufixos adicionais quando necessário para garantir um endereço exclusivo. Copie sempre o endereço confirmado no detalhe da turma, em vez de deduzi-lo pelo exemplo. O detalhe da turma mostra um aviso com o endereço anterior, e o botão de copiar já entrega o link novo. Os links antigos deixaram de funcionar: o visitante vê a página de indisponibilidade, sem URL alternativa e sem registro de lead, e isso vale também para turmas pausadas ou arquivadas. Divulgue o link novo em todos os lugares onde o antigo foi publicado. Um endereço aposentado não pode ser escolhido de novo por nenhuma turma, nem depois que as outras forem excluídas. - O que o visitante vê quando o link não está disponível: em uma turma com endereço válido, se ela estiver em rascunho, pausada, arquivada, concluída ou sem grupo aberto, o link inteligente usa a Página de espera configurada, quando houver. Endereços inexistentes ou aposentados nunca usam essa alternativa. Sem um destino válido, a plataforma mostra uma página pública curta dizendo que o link não está disponível no momento. Se o endereço pertence a uma única turma, a página usa o idioma da conta responsável: português, inglês ou espanhol; outro idioma da conta usa inglês. Para um endereço inexistente, aposentado ou ambíguo, usa o idioma principal do navegador quando ele for um desses três, ou inglês nos demais casos. A página não revela o nome da conta nem da turma e não aparece em buscadores. - 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 - Caixa híbrida do WhatsApp
Growth Social: engajamento nativo, campanhas e monitoramento
Visão geral O Growth Social reúne engajamento pelas caixas nativas e automação por uma conta social conectada ao gateway. São conexões distintas: Instagram com login direto, Instagram vinculado pelo Facebook e a Página Facebook usam suas respectivas caixas oficiais. A automação Instagram por gateway usa uma sessão própria e não substitui essas caixas silenciosamente. Publicações, comentários e regras de Engajamento precisam da caixa correta. Uma regra enviada à fila ainda não é uma mensagem entregue: acompanhe o resultado de cada operação no histórico. Ao conectar ou reconectar o Instagram com Growth Social habilitado, autorize também o gerenciamento de comentários solicitado pela Meta. Uma conexão antiga pode precisar dessa nova autorização. A assinatura de comentários no webhook e a permissão da conta precisam estar ativas para que uma regra receba interações reais. Pré-requisitos - Acesso ao módulo e permissão para configurar a conta ou suas regras. - Para Engajamento nativo, caixa Instagram ou Facebook conectada, com as permissões necessárias à operação desejada. - Para automação por gateway, módulo habilitado, serviço disponível e sessão Instagram conectada. Complete a verificação em duas etapas ou o desafio solicitado antes de executar ações. - Para proxy gerenciado, disponibilidade no pool configurado pelo administrador. Credenciais de proxy próprio devem ser preenchidas somente no campo apropriado. Passo a passo 1. Abra Growth Social e selecione Engajamento e a caixa desejada. Confirme se está trabalhando no Instagram direto, no Instagram vinculado pelo Facebook ou na Página Facebook. 2. Selecione a publicação, abra os comentários e configure a regra de resposta privada ou moderação. Confira palavras-chave, texto ou template e ações adicionais antes de salvar. 3. Faça uma interação controlada e consulte o histórico. Resposta privada, resposta pública e moderação têm resultados próprios; uma falha adicional não deve ser confundida com ausência da DM já enviada. 4. Na automação Instagram, conecte a conta e configure a rota de conexão. Confira o estado efetivo depois de salvar. 5. Em Monitores, selecione conta, tipo, alvo quando necessário e intervalo. Consulte o estado de coleta, o motivo de falha e a próxima tentativa. 6. Em Campanhas, escolha a audiência e ordene as etapas. Defina o atraso de cada etapa, inclusive a primeira, e o template das DMs. Ative a campanha e acompanhe seus resultados. Configurações & opções Caixas nativas As duas conexões oficiais do Instagram são suportadas como caminhos separados. A Página Facebook também tem seu próprio contexto. As ações disponíveis dependem da conexão; permissões ausentes, limites e expiração de acesso aparecem como falhas, não como uma lista vazia de comentários. O histórico diferencia processamento, envio confirmado, falha e resultado incerto. A resposta privada confirmada é registrada no atendimento correspondente; erros de registro local devem ser investigados sem reenviar a mensagem já confirmada pelo provedor. Se o mesmo perfil Instagram estiver conectado pelos dois caminhos na mesma conta, a regra correspondente de menor ID, com desempate pela caixa, define o contexto da resposta privada. Um comentário não gera duas DMs apenas por existir nas duas conexões. Uma falha ao registrar no atendimento uma DM já confirmada é reavaliada automaticamente até cinco vezes, sem reenviar ao provedor. Ações adicionais interrompidas ficam identificadas como incertas ou não concluídas e não são repetidas automaticamente. Campanhas e monitores As etapas de campanha só avançam depois que sua ação é confirmada. Etapas repetidas de DM têm identificação própria. Pausar ou arquivar impede novos despachos; retomar também garante a inscrição da audiência caso ela ainda não tivesse sido processada. Operações já iniciadas podem terminar depois da pausa. Uma campanha concluída terminou o processamento dos seus alvos; consulte a divisão entre concluídos e falhos. Não é permitido alterar a sequência ou trocar a conta conectada após a inscrição de alvos. Para outro fluxo, crie uma nova campanha. O atraso entre etapas é a configuração disponível; objetos adicionais de agenda ou throttle sem suporte são recusados. Monitores Instagram traduzem contadores de perfil/publicação em métricas e gravam as audiências coletadas como prospects. A última página limpa o cursor para permitir um novo ciclo. O intervalo mínimo é de cinco minutos. Falhas temporárias aguardam retomada progressiva; após cinco falhas consecutivas, ou diante de falha definitiva, a coleta fica parada. Tentar novamente limpa essa parada para o agendador reavaliar o monitor. Rota de conexão Escolha conexão direta, proxy próprio ou proxy gerenciado. Para proxy, a política de falha pode manter a conta parada, procurar uma rota saudável ou permitir conexão direta quando isso tiver sido escolhido explicitamente. Confira a região e o estado efetivo; uma configuração salva ainda pode estar pendente ou parada. O pool compartilha capacidade com outros consumidores da plataforma. Casos de uso - Responder a um comentário Instagram pela caixa oficial e continuar o atendimento na conversa correta. - Executar uma sequência de acompanhamento com atrasos e confirmação por etapa. - Acompanhar métricas e formar audiências sem repetir a mesma página ou duplicar prospects. Dicas, limites e boas práticas Teste primeiro com contas e destinatários dedicados. Conexão ativa e testes automatizados não comprovam uma entrega real. Respeite as permissões e os limites de cada integração; não há garantia de ausência permanente de falhas externas. A disponibilidade de TikTok e YouTube depende de seus próprios conectores e não deve ser inferida da conexão Instagram. Não copie senhas, cookies, tokens ou URLs de proxy com credenciais para capturas e chamados. Uma rota direta após falha só deve ser utilizada quando sua política autorizar essa alternativa. Solução de problemas - Falha de sessão ou desafio: reconecte a conta e conclua a verificação solicitada. - Monitor parado: corrija a causa indicada e use Tentar novamente. A retomada ocorre pelo agendador, não representa coleta concluída. - Entrega incerta: confira o resultado no provedor e peça a um administrador para reconciliar a ação com nota de auditoria e, quando entregue, o ID externo. A reconciliação registra o resultado e não envia outra mensagem automaticamente. - Campanha com falhas: consulte o alvo e a ação associada. Registros legados que avançaram sem confirmação podem exigir reconciliação; não recrie envios indiscriminadamente. - Proxy parado ou pendente: confira credenciais, saúde, região e capacidade do pool. Só considere a rota ativa após confirmação do gateway. - Erro ao abrir comentários: confira a caixa selecionada, a conexão e as permissões; não interprete o erro como ausência de comentários. Se uma resposta manual a um comentário tiver resultado incerto, ela continuará bloqueada após recarregar a página. Um administrador deve conferir o resultado no provedor e registrar a reconciliação com uma observação. A confirmação de entrega exige o identificador externo e nunca envia novamente; a confirmação de não entrega libera uma nova tentativa explícita. Recuperação de comentários e diagnóstico do provedor O histórico separa a mensagem privada, a resposta pública e o registro na caixa. Uma falha na resposta pública não cancela uma mensagem privada confirmada. Abra Diagnóstico do provedor na operação com falha para consultar código, subcódigo e ID da requisição sem expor credenciais. Um administrador pode ativar deliberadamente a recuperação oficial de comentários para uma caixa Instagram, regra e publicação verificadas. Por padrão, ela começa pelos novos comentários; processar comentários antigos exige um corte explícito dentro da janela permitida. A recuperação compartilha o registro de envios do webhook, mantendo entregas incertas para reconciliação sem reenviar a DM. Quando a resposta oficial omite a identidade do autor ou um horário confiável, a recuperação pausa com diagnóstico e preserva sua posição. Após corrigir acesso ou identificação, o administrador pode retomar a mesma leitura ou interrompê-la. Somente o nome de usuário nunca cria identidade nem autoriza uma DM automática. 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. Ao marcar Aplicar a todos os leads deste anúncio, a correção inclui todos os leads já capturados do mesmo anúncio na conta e permitidos pelo seu acesso, mesmo fora da página ou aba atual. Leads CTWA e de formulário podem pertencer ao mesmo anúncio. Sem um anúncio identificado, somente o lead aberto é alterado. Isso não cria uma regra para leads futuros nem dispara conversões. 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), anúncios que abrem uma conversa no Messenger (click-to-Messenger) ou no Instagram Direct (click-to-Instagram Direct) 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 um canal da Meta e um token com a permissão de eventos desse canal: - WhatsApp Cloud: a conta de WhatsApp Business (WABA) e whatsapp_business_manage_events; - Messenger (caixa da Página do Facebook): a Página e page_events; - Instagram: a conta profissional do Instagram e instagram_manage_events. Caixas de WhatsApp Web, 360dialog ou Twilio não têm WABA — nesses casos o Dataset ID e o token são informados manualmente. - O login da Página e o do Instagram não pedem page_events nem instagram_manage_events. Para o Messenger e o Instagram, use o token da conexão com o Gerenciador de Anúncios da Meta (as permissões vêm da configuração do Login do Facebook para Empresas no Painel de Apps da Meta) ou cole um token que tenha a permissão. - 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 Detectar ou criar — a plataforma consulta a WABA, a Página ou a conta do Instagram da caixa e preenche o Dataset ID para você (a Meta devolve o dataset existente ou cria um). 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: a versão da API de Marketing da Meta é definida pela plataforma, a mesma para todas as caixas (hoje v26.0), e a tela só a mostra. Pela API, o campo meta_api_version ficou obsoleto: ainda aceita apenas v26.0 ou v25.0, mas é ignorado no envio. - Partner agent (meta_partner_agent, padrão ConversaLabs): identifica 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. Messenger e Instagram - Um clique em anúncio que abre uma conversa no Messenger ou no Instagram Direct vira um lead de anúncio com a origem Click-to-Messenger ou Click-to-Instagram Direct. Ele aparece na central de leads e dispara os mesmos fluxos de um lead do WhatsApp: o evento LeadSubmitted, as automações e o Flow Builder do gatilho lead de anúncio capturado, os follow-ups, a distribuição de grupos e os webhooks da conta. - Ações que só existem no WhatsApp não saem pelo canal errado: um template ou flow do WhatsApp numa conversa do Messenger ou do Instagram é ignorado e registrado, e a distribuição de grupos registra o lead sem WhatsApp como ignorado (sem WhatsApp). - As automações podem filtrar pela origem do lead de anúncio (Click-to-WhatsApp, formulário, Click-to-Messenger ou Click-to-Instagram Direct). - A Meta não tem clique identificado nesses canais: o evento leva a Página e o ID do contato na Página (Messenger), ou a conta do Instagram e o ID do contato no Instagram. Vendas e estágios do CRM dessa conversa contam como do anúncio, na janela de 7 dias do lead. - Instagram é só mensuração: a Meta registra os eventos no Gerenciador de Eventos, mas hoje não otimiza anúncios do Instagram com eles. A otimização por compra vale para anúncios que levam ao Messenger e ao WhatsApp. A tela de Conversões mostra esse aviso nas caixas do Instagram. Leads de formulário (CRM) Os eventos de leads de formulário de anúncio seguem o formato da API de Conversões para CRM da Meta: levam o ID do lead e os campos event_source: crm e lead_event_source (o nome do CRM, o mesmo do partner agent). Sem esses campos a Meta não usa o evento na otimização por leads de conversão. 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. - Quando uma tentativa falha ou é ignorada, o ledger mostra o que fazer (por exemplo, a permissão que falta no token) e mantém o motivo original da Meta para diagnóstico. - A Meta não deduplica eventos de mensagens. A plataforma tenta de novo, com o mesmo identificador, só quando tem certeza de que o evento não chegou: limite de chamadas, Meta indisponível ou conexão que nem chegou a abrir. Se a Meta demorar a responder depois do envio, o evento fica como falho (pode ter chegado) e não é reenviado sozinho: confira no Gerenciador de Eventos antes de reenviar. 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 do WhatsApp, do Messenger e do Instagram ao dataset da WABA, da Página ou da conta do Instagram, descobrindo o Dataset ID automaticamente quando não informado. Leads de formulário saem no formato de CRM. - 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. Se ainda falhar, peça ao administrador da plataforma para conferir a versão da API de Marketing, que é definida para todas as caixas. - 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 a permissão de eventos do canal (whatsapp_business_manage_events, page_events ou instagram_manage_events). Reconecte o Gerenciador de Anúncios da Meta com a permissão ou cole um token que a tenha. - Faltou a Página ou o ID do contato (Messenger/Instagram): a conversa precisa ter vindo da Página ou da conta do Instagram conectada à caixa. - Falhou com "pode ter chegado": a Meta demorou a responder depois do envio. Confira o evento no Gerenciador de Eventos e só reenvie se ele não estiver lá. - 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