For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/guides/pixel-on-pipeline-stage.md.
  • Português
  • Como mandar uma conversão quando um contato entra numa etapa do pipeline?

    Cada etapa do pipeline pode ter um evento de pixel. Quando um contato entra naquela etapa, a Clickmax envia o evento escolhido pelo servidor, pela API de Conversões, para os pixels da Meta que estão ativos e marcados para receber eventos que não acontecem numa tela. É assim que um marco do atendimento — uma reunião marcada, uma proposta enviada — vira conversão na sua campanha.

    Antes de começar

    • Papel: Proprietário, Administrador ou Editor. Quem tem papel de atendente vê a etapa, mas não configura o evento.
    • Permissão de Tráfego para ver os pixels da conta ao configurar o evento. Sem ela, a tela do evento avisa que você não tem acesso aos pixels. Depois de configurado, o envio não depende de quem move o contato.
    • Pelo menos um pixel da Meta ativo, com a opção Receber eventos que não acontecem numa tela marcada e a API de Conversão ligada com um token válido. Veja como o pixel recebe conversa, ligação e clique em link de e-mail.

    1. Escolher o evento da etapa

    1. No menu do CRM, abra Pipelines e entre no pipeline que você quer configurar.
    2. No topo da etapa, clique no menu ⋮.
    3. Clique em Evento de pixel.
    4. Escolha um evento da lista. Cada opção mostra o nome padrão da Meta entre parênteses — por exemplo Realizou compra (Purchase) ou Virou lead (Lead).
    5. Clique em Configurar evento.

    A etapa passa a exibir o nome padrão da Meta logo abaixo do título — Purchase, Lead —, então dá para conferir a configuração de todas as etapas de uma olhada.

    Para desligar, abra a mesma tela e clique em Não enviar evento.

    A lista mostra só os eventos que a API de Conversões recebe de uma etapa. ViewContent e os eventos padrão da Meta que a Clickmax não envia pelo servidor (Search, AddToWishlist, CustomizeProduct, Donate, FindLocation) não aparecem. Se uma etapa sua já estava com um deles, ele continua marcado com o aviso Este evento não é enviado pelo servidor — escolha outro para a etapa voltar a enviar.

    2. Quando o evento sai — e quando não sai

    O que acontece no pipelineEnvia o evento?
    Alguém arrasta o contato para a etapa e o movimento é salvosim
    Uma automação muda a etapa do contatosim
    Você muda a etapa por ação em massasim
    Você muda a etapa pela ficha da oportunidade ou pelo atendimentosim
    A etapa recusa o movimento e o contato volta para a etapa de origemnão
    A oportunidade não tem contato vinculadonão
    Você reordena o contato dentro da mesma etapa, sem trocar de etapanão
    Você acabou de configurar o evento e já havia contatos parados na etapanão

    A regra por trás da tabela: o evento sai depois de a mudança de etapa ser salva, venha ela de onde vier. Não depende de quem moveu o card estar com o navegador aberto nem de bloqueador de anúncios.

    Cada oportunidade conta uma vez por etapa: se a oportunidade sai da etapa e volta, o evento não sai de novo. Configurar o evento não é retroativo — quem já estava na etapa não gera conversão.

    3. O evento vai para quais pixels?

    Para os pixels da Meta da sua conta que estão ativos e têm a opção Receber eventos que não acontecem numa tela marcada. A tela do evento mostra quantos são.

    O filtro existe porque mover um card não acontece em página, funil nem produto: é um marco do atendimento, e não há tela onde escolher o pixel. É o mesmo caso da conversa no WhatsApp e do clique em link de e-mail.

    4. O que a Meta recebe

    O evento chega como conversão registrada pelo CRM, no formato que a Meta usa para estágios de lead, com os dados do contato: e-mail, telefone, cidade e estado do cadastro, e o clique no anúncio de onde ele veio. Não vão o endereço de internet nem o navegador de quem moveu o card — a conversão é do contato, não do seu time.

    Se o último clique de anúncio do contato foi num anúncio de clique para WhatsApp, o evento vai como conversa daquele anúncio — veja eventos enviados pelo servidor.

    Para a venda fechada no pipeline, prefira mandar a oportunidade ganha como conversão. Use um caminho ou o outro para a mesma venda, nunca os dois.

    5. Conferir se está funcionando

    1. Mova um contato de teste para a etapa configurada.
    2. Abra Tráfego › Pixel e trackeamento, entre no pixel e confira a linha no Histórico de envio.
    3. No Gerenciador de Eventos da Meta, o evento aparece com o nome padrão da Meta, uma vez por pixel que recebe eventos sem tela.

    O passo a passo completo de conferência está em validar Pixel e eventos.

    Relacionados

    Se não funcionou

    • Não aparece a opção Evento de pixel no menu da etapa: seu papel não permite configurar etapa. Peça a quem é Proprietário ou Administrador.
    • A tela diz que você não tem pixel ativo: pode ser que o pixel exista e esteja sem a opção Receber eventos que não acontecem numa tela. Abra Editar no pixel, marque a opção e volte. Se não houver pixel nenhum, cadastre um em Tráfego › Pixel e trackeamento.
    • A tela diz que você não tem acesso aos pixels: falta a permissão de Tráfego no seu cargo. Peça a quem administra a conta.
    • A tela diz que não conseguiu ler os pixels da sua conta: é falha momentânea de leitura, e não ausência de pixel — não cadastre outro. Feche e abra a tela de novo em alguns instantes.
    • O contato entrou na etapa e nada chegou: confira se a oportunidade tem contato vinculado e se o pixel tem a API de Conversão ligada com token válido. O motivo de cada envio fica no Histórico de envio do pixel.
    • O contato voltou para a etapa e a conversão não saiu de novo: é o comportamento esperado — cada oportunidade conta uma vez por etapa.
    • A conversão conta em dobro: procure o mesmo evento configurado em duas etapas pelas quais o contato passa, ou numa tag do Google Tag Manager.