> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversões da Meta

> Avise a Meta quando as pessoas que vieram dos seus anúncios de clique para o WhatsApp viram leads qualificados ou compram, para que o Gerenciador de Anúncios mostre resultados reais e seus anúncios encontrem mais compradores.

As Conversões da Meta contam à Meta o que acontece depois que alguém clica em um dos seus anúncios de clique para o WhatsApp e começa uma conversa. Quando esse contato chega a uma etapa do funil que você escolhe, ou confirma um pedido, a Ciarem envia à Meta um evento como **Lead qualificado** ou **Compra**. O Gerenciador de Anúncios mostra esses resultados ao lado de cada anúncio, e a Meta pode otimizar seus anúncios para pessoas que compram, não só para pessoas que iniciam uma conversa. Os administradores configuram em **Configurações > Integrações > Conversões da Meta**.

> [!NOTE]
>
> Por enquanto, as conversões são enviadas a partir de linhas de WhatsApp. O Messenger chega em breve.

## O que a Ciarem compartilha com a Meta

Só são enviados os contatos que vieram de um dos seus anúncios de clique para o WhatsApp, e só durante os 7 dias seguintes ao último clique deles em um anúncio. Para cada evento, a Ciarem compartilha:

* O ID do clique no anúncio que a Meta anexou à conversa, que diz à Meta em qual anúncio a pessoa clicou.
* O evento, por exemplo **Lead qualificado** ou **Compra**.
* O valor dele, se você definiu um.

Nada mais da conversa é compartilhado: nem mensagens, nem nomes, nem telefones, nem e-mails. Contatos que escreveram para você sem clicar em um anúncio nunca são enviados.

## Ative

**1. Ative a integração**

Vá em **Configurações**, depois em **Integrações**, e clique em **Ativar** no cartão de Conversões da Meta. A Ciarem abre a página de configuração.

**2. Ligue suas linhas de WhatsApp**

Em **Linhas**, ligue cada linha que recebe conversas dos seus anúncios. Na primeira vez, a Ciarem cria um dataset para a linha na Meta. Um dataset é onde a Meta reúne os eventos da sua conta de anúncios, e você pode vê-lo no Gerenciador de Eventos da Meta com **Abrir no Gerenciador de Eventos**.

**3. Escolha quais etapas a Meta fica sabendo**

Em **Etapas do funil → eventos**, escolha um evento para cada etapa que importa (veja abaixo). Etapas deixadas em **Não enviar** nunca são enviadas.

### Usar um dataset que você já tem

Se a sua conta de anúncios já envia eventos para a Meta de outro lugar, por exemplo um pixel no seu site, você pode enviar os eventos da Ciarem para esse mesmo dataset. Clique em **Usar outro dataset** na linha e cole o **ID do dataset**, que você encontra no Gerenciador de Eventos em **Fontes de dados**. Caso contrário, mantenha o dataset que a Ciarem criou.

## Associe eventos às etapas do funil

Cada etapa do funil pode enviar um evento quando um contato que veio de um anúncio entra nela. Uma configuração comum:

| Etapa do funil | Evento |
| - | - |
| Interessado | Lead enviado |
| Qualificado | Lead qualificado |
| Ganho | Compra |

Você também pode definir um **Valor (opcional)** e a moeda dele para cada evento, por exemplo o valor médio de uma venda. A Meta informa esse valor junto com o evento.

Cada evento é enviado uma vez por clique no anúncio. Se um contato voltar a entrar na mesma etapa, a Meta não é avisada duas vezes. A etapa inicial não aparece na lista, porque todo contato novo cai nela primeiro.

Os administradores editam as etapas pelo botão **Etapas do funil** no cabeçalho de Contatos. Veja [Contatos e etapas do funil](https://help.ciarem.ai/pt/using-ciarem/contacts-and-stages.md).

## Pedidos

Se você usa o [módulo de checkout](https://help.ciarem.ai/pt/ai-agent/taking-orders.md), deixe ligado **Enviar os pedidos confirmados do checkout como Compra**. Cada pedido que um contato vindo de um anúncio confirma é enviado como **Compra** com o total e a moeda do pedido.

> [!WARNING]
>
> Se você vende pelo checkout, não associe também uma etapa do funil a **Compra**, ou cada venda vai contar duas vezes no Gerenciador de Anúncios.

## Confira se funciona

### Envie um evento de teste

**Evento de teste** envia um evento de exemplo para o dataset de uma linha, para você conferir a conexão antes de chegarem leads reais.

1. No Gerenciador de Eventos, abra seu dataset, vá em **Eventos de teste** e copie o código do evento de teste.
2. Na Ciarem, escolha a **Linha**, cole o **Código do evento de teste** e clique em **Enviar**.

Um evento de teste precisa de um clique real em um anúncio nessa linha nos últimos 7 dias. Se não houver nenhum, clique em um dos seus próprios anúncios de clique para o WhatsApp, envie uma mensagem e tente novamente. Abrir o anúncio pelo link de uma publicação compartilhada não conta: só um clique no próprio anúncio leva o ID do clique.

### Eventos recentes

**Eventos recentes** lista o que a Ciarem enviou: o contato, o evento e se ficou **Enviado**, **Com falha** ou **Pendente**. No topo da página você também vê quantos eventos foram enviados e falharam nos últimos 7 dias, e quantas linhas estão ativas.

## Desative

Desligue o interruptor no topo da página de Conversões da Meta para parar de enviar. Suas linhas, datasets e associações de etapas são mantidos e voltam a valer quando você ligar de novo. Para parar só uma linha, desligue-a em **Linhas**.

## Solução de problemas

### "Este canal foi conectado antes de a Ciarem poder enviar conversões"

Linhas de WhatsApp conectadas antes de 9 de outubro de 2026 não deram à Ciarem permissão para enviar eventos à Meta. Clique em **Reconectar** na linha e faça a conexão do WhatsApp mais uma vez. Suas conversas, contatos e configurações continuam como estão.

### "A conexão com a Meta desta linha não consegue ler esse dataset"

O ID do dataset que você colou pertence a uma empresa que a conexão desta linha não alcança. Confira o ID no Gerenciador de Eventos, ou mantenha o dataset que a Ciarem criou.

### Os eventos não aparecem no Gerenciador de Eventos

* Confira **Eventos recentes** na Ciarem. Se o evento aparece como **Enviado**, a Meta recebeu.
* A Meta pode levar até 30 minutos para mostrar os eventos na **Visão geral** do dataset, e às vezes os eventos de teste nem aparecem em **Eventos de teste**. Olhe a **Visão geral** de novo depois de um tempo.
* Se nada aparece em **Eventos recentes**, confira se a integração e a linha estão ligadas, se a etapa tem um evento associado e se o contato clicou em um anúncio nos últimos 7 dias.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.