1. [Ajuda](https://nuvia.ai/docs)
2. [Canais](https://nuvia.ai/docs/colecoes/19378288-canais)
3. [Whatsapp](https://nuvia.ai/docs/colecoes/19430943-whatsapp)

# Como sincronizar dados de conversão da Nuvia com a Meta (CAPI)

Envie eventos de conversão para a Meta quando leads de anúncios Click-to-WhatsApp avançam no Funil Inteligente, melhorando a otimização dos anúncios.

Disponível em

Todos os planos.

Quem pode fazer

Administradores da conta.

Atualizado em 3 de agosto de 2026

[Whatsapp](https://nuvia.ai/docs/colecoes/19430943-whatsapp)

1. [Entendendo as regras do WhatsApp: janela de 24h, 72h e templates](https://nuvia.ai/docs/artigos/14575042-entendendo-as-regras-do-whatsapp-janela-de-24h-72h-e-templates)
2. [Como sincronizar dados de conversão da Nuvia com a Meta (CAPI)](https://nuvia.ai/docs/artigos/15421878-como-sincronizar-dados-de-conversao-da-nuvia-com-a-meta-capi)
3. [Como migrar um número de WhatsApp de outra plataforma para a Nuvia](https://nuvia.ai/docs/artigos/16414388-como-migrar-um-numero-de-whatsapp-de-outra-plataforma-para-a-nuvia)
4. [Como melhorar a taxa de resposta em campanhas de WhatsApp](https://nuvia.ai/docs/artigos/14501604-como-melhorar-a-taxa-de-resposta-em-campanhas-de-whatsapp)
5. [Coexistência do WhatsApp Business com a Nuvia](https://nuvia.ai/docs/artigos/15554165-coexistencia-do-whatsapp-business-com-a-nuvia)
6. [Como criar templates de WhatsApp com varíaveis](https://nuvia.ai/docs/artigos/14579891-como-criar-templates-de-whatsapp-com-variaveis)
7. [Como criar uma conta no Meta Business](https://nuvia.ai/docs/artigos/16548186-como-criar-uma-conta-no-meta-business)

Nesta página

1. Como funciona
2. Passo 1: Vincular um dataset ao número de WhatsApp
3. Passo 2: Definir o evento de conversão em cada etapa
4. Eventos disponíveis

**Nesta página4 seções**

1. Como funciona
2. Passo 1: Vincular um dataset ao número de WhatsApp
3. Passo 2: Definir o evento de conversão em cada etapa
4. Eventos disponíveis

A Nuvia envia eventos de conversão para a Meta (via Conversions API, ou “CAPI”) quando um lead que chegou por um anúncio de Click-to-WhatsApp avança nas etapas do seu Funil Inteligente. Com isso, a Meta entende quais conversas viraram leads qualificados ou vendas e passa a otimizar a entrega dos anúncios para trazer contatos com mais chance de converter.

## Como funciona

A sincronização liga três pontos: o anúncio de Click-to-WhatsApp (que traz o lead), o número de WhatsApp que recebe a conversa e o Funil Inteligente que conduz o atendimento. Quando uma conversa avança para uma etapa que tem um evento de conversão configurado, a Nuvia envia esse evento para o **dataset** da Meta (em Eventos/Events Manager) vinculado àquele número.

A Nuvia identifica a origem pelo **identificador do clique** (ctwa_clid) que a Meta envia junto com a primeira mensagem da conversa.

### A sincronização só acontece quando **todas** estas condições são atendidas:

-

A conversa veio de um anúncio de **Click-to-WhatsApp**.

-

O atendimento é por **WhatsApp Cloud API** (outros canais não enviam eventos de conversão).

-

O número de WhatsApp tem um **dataset vinculado** (passo 1).

-

A etapa para a qual a conversa avançou tem um **evento de conversão definido** (passo 2).

Importante

a sincronização é opt-in. Enquanto você não vincular um dataset ao número, nenhum evento é enviado para a Meta (mesmo que as etapas já tenham eventos configurados).

## Passo 1: Vincular um dataset ao número de WhatsApp

O dataset é o “destino” na Meta que recebe os eventos de conversão. Cada número de WhatsApp tem o seu.

1.

No menu lateral, no ícone de perfil, **clique nos 3 pontinhos e selecione “configurações”**

2.

No menu lateral, acesse **Apps > WhatsApp**

3.

Na tabela de números, localize a coluna **Dataset ID (CAPI)**

4.

Na linha do número desejado, clique em **Vincular** (ou **Trocar**, se já houver um dataset)

5.

No menu **Datasets disponíveis**, selecione um dataset existente da sua conta da Meta (WABA) ou clique em **Criar novo dataset**

6.

Confirme, a Nuvia exibe **Dataset vinculado** (ou **Dataset criado e vinculado**) e o nome do dataset passa a aparecer na coluna

Enquanto não houver dataset, a coluna mostra **Não vinculado**. Para remover o vínculo, clique no ícone de lixeira ao lado do dataset, a Nuvia confirma com **Dataset desvinculado** e volta a não enviar eventos para aquele número.

Importante

se o menu mostrar **Nenhum dataset encontrado para este WABA**, crie um pela opção **Criar novo dataset** ou verifique na Meta se a conta de WhatsApp tem um dataset de mensagens disponível.

## Passo 2: Definir o evento de conversão em cada etapa

O evento diz à Meta o que aconteceu quando a conversa chega àquela etapa. Você configura etapa por etapa, dentro do Funil Inteligente.

1.

No menu lateral, acesse **Funis Inteligente** e abra o agente desejado

2.

Dentro agente/funil, **acesse a aba “etapas do funil”**

3.

Na etapa que representa a conversão (por exemplo, a etapa de lead qualificado), **clique nos 3 pontinhos ao lado do card da etapa**

4.

Clique em **Evento de conversão**

5.

Escolha o evento que melhor descreve aquela etapa

6.

A escolha é salva na hora; para parar de enviar, refaça o processo e selecione **Nenhum**

## Eventos disponíveis

Evento (Nuvia)Quando usar

**Nenhum** A etapa não envia nenhum evento (padrão)

**Visualização de conteúdo** Lead demonstrou interesse inicial

**Lead capturado** Lead forneceu dados de contato

**Lead qualificado** Lead foi qualificado pelo agente

**Adicionado ao carrinho** Lead selecionou um produto/serviço

**Checkout iniciado** Lead iniciou o processo de compra

**Compra realizada** Negócio fechado / venda concluída

Importante

o evento **Compra realizada** só é enviado quando a oportunidade tem **valor maior que zero** e uma **moeda definida**. Sem esses dados, o evento é ignorado, os demais eventos não têm essa exigência.

## Perguntas frequentes

**Por que meus eventos não estão chegando na Meta?**

O envio só acontece quando todas as condições são atendidas: a conversa veio de um anúncio de Click-to-WhatsApp, o atendimento é por WhatsApp Cloud API, o número tem um dataset vinculado (passo 1) e a etapa tem um evento configurado (passo 2). Se qualquer uma faltar, o evento não é enviado. Conversas que não vieram de anúncios de Click-to-WhatsApp nunca geram eventos de conversão.

**Preciso configurar um dataset para cada número de WhatsApp?**

Sim. O dataset é vinculado por número, na coluna Dataset ID (CAPI) dentro de Integrações > WhatsApp. Números sem dataset vinculado não enviam eventos.

**O que acontece se eu deixar o evento como “Nenhum”?**

A etapa não envia nenhum evento de conversão para a Meta. Use Nenhum nas etapas que não representam uma conversão relevante para a otimização dos anúncios.

**Posso reaproveitar o mesmo dataset em vários números?**

O vínculo é feito número a número. Você escolhe, para cada número, qual dataset da sua conta da Meta (WABA) receberá os eventos daquele número.

**Desvincular o dataset apaga os eventos já enviados?**

Não. Desvincular apenas interrompe o envio de novos eventos a partir daquele número. Os eventos já recebidos pela Meta permanecem registrados no dataset.

[AnteriorEntendendo as regras do WhatsApp: janela de 24h, 72h e templates](https://nuvia.ai/docs/artigos/14575042-entendendo-as-regras-do-whatsapp-janela-de-24h-72h-e-templates) [PróximoComo migrar um número de WhatsApp de outra plataforma para a Nuvia](https://nuvia.ai/docs/artigos/16414388-como-migrar-um-numero-de-whatsapp-de-outra-plataforma-para-a-nuvia)

Este artigo ajudou?

## Artigos relacionados

- [Como conectar o WhatsApp na Nuvia](https://nuvia.ai/docs/artigos/14489425-como-conectar-o-whatsapp-na-nuvia)
- [Como configurar um Funil Inteligente na Nuvia](https://nuvia.ai/docs/artigos/14570332-como-configurar-um-funil-inteligente-na-nuvia)
- [Glossário de termos da Nuvia](https://nuvia.ai/docs/artigos/14580494-glossario-de-termos-da-nuvia)
- [Como sincronizar contatos e deals entre Nuvia e HubSpot](https://nuvia.ai/docs/artigos/14590403-como-sincronizar-contatos-e-deals-entre-nuvia-e-hubspot)
- [O que a Nuvia sincroniza com o HubSpot e quando](https://nuvia.ai/docs/artigos/16473526-o-que-a-nuvia-sincroniza-com-o-hubspot-e-quando)

[Whatsapp](https://nuvia.ai/docs/colecoes/19430943-whatsapp)

1. [Entendendo as regras do WhatsApp: janela de 24h, 72h e templates](https://nuvia.ai/docs/artigos/14575042-entendendo-as-regras-do-whatsapp-janela-de-24h-72h-e-templates)
2. [Como sincronizar dados de conversão da Nuvia com a Meta (CAPI)](https://nuvia.ai/docs/artigos/15421878-como-sincronizar-dados-de-conversao-da-nuvia-com-a-meta-capi)
3. [Como migrar um número de WhatsApp de outra plataforma para a Nuvia](https://nuvia.ai/docs/artigos/16414388-como-migrar-um-numero-de-whatsapp-de-outra-plataforma-para-a-nuvia)
4. [Como melhorar a taxa de resposta em campanhas de WhatsApp](https://nuvia.ai/docs/artigos/14501604-como-melhorar-a-taxa-de-resposta-em-campanhas-de-whatsapp)
5. [Coexistência do WhatsApp Business com a Nuvia](https://nuvia.ai/docs/artigos/15554165-coexistencia-do-whatsapp-business-com-a-nuvia)
6. [Como criar templates de WhatsApp com varíaveis](https://nuvia.ai/docs/artigos/14579891-como-criar-templates-de-whatsapp-com-variaveis)
7. [Como criar uma conta no Meta Business](https://nuvia.ai/docs/artigos/16548186-como-criar-uma-conta-no-meta-business)

## Ainda precisa de ajuda?

Clientes falam com o suporte pelo chat dentro da plataforma. Ainda não é cliente? Fale com o nosso time.

[Falar com o suporte na plataforma](https://app.nuvia.ai) [Ainda não sou cliente](https://nuvia.ai/contact)

---
Source: https://nuvia.ai/docs/artigos/15421878-como-sincronizar-dados-de-conversao-da-nuvia-com-a-meta-capi
