Enviar evento de conversão CTWA para a API de Conversões do Facebook

Visão geral

Use a ação da Regra de ciclo de vida Enviar evento de conversão CTWA para enviar eventos de conversão de Click-to-WhatsApp (CTWA) do Chakra para a API de Conversões da Meta (Business Messaging). O Chakra atribui o evento usando ctwa_clid da origem de marketing do chat ou processo.

Pré-requisitos

• Uma conexão com Facebook / Meta em Admin → Conexões de contas de anúncios (necessária para que o Chakra possa enviar eventos de conversão CTWA pela API de Conversões da Meta)
• Tráfego de anúncios CTWA / WhatsApp para que a origem de marketing do chat ou processo marketingSource inclua ctwa_clid e wabaId
• Uma conta do WhatsApp Business (WABA) que o Chakra possa usar para localizar o conjunto de dados de conversão da Meta
• Permissão para criar e editar Regras de ciclo de vida

Conectar o Facebook / Meta ao Chakra

1. Acesse Admin → Conexões de contas de anúncios (/admin/ad-account-connections).
2. Clique em Conectar conta de anúncios.
3. Em Provedor da conta de anúncios, selecione Facebook / Meta.
4. Continue com o Facebook e aprove as permissões solicitadas (incluindo gerenciar eventos do WhatsApp Business) para que o Chakra possa enviar eventos de conversão do Pixel e CTWA pela API de Conversões da Meta.
5. Confirme se a nova conexão da Meta aparece na lista Conexões de contas de anúncios antes de criar a Regra de ciclo de vida.

Quando usar esta ação

Selecione Enviar evento de conversão CTWA para conversões de Click-to-WhatsApp. Se ctwa_clid estiver ausente, o Chakra ignora o envio (a regra não falha com um erro crítico). Para a API de Conversões da Meta baseada em Pixel ou outros fluxos OAuth de contas de anúncios da Meta que selecionam uma conta de anúncios / Pixel específico na ação, use Enviar conversão para conta de anúncios .

Criar a Regra de ciclo de vida

1. Abra Regras de ciclo de vida e crie uma regra para o momento que você quer contabilizar como conversão (por exemplo, uma mudança de estado do processo ou um evento do chat).
2. Adicione as condições de evento necessárias (por exemplo, apenas quando o estado do lead mudar para convertido).
3. Adicione a ação Enviar evento de conversão CTWA.
4. Configure a definição da ação usando os campos abaixo e salve e ative a regra.

Campos da ação

• Nome do evento (obrigatório) — Meta event_name, como Lead, Purchase ou um nome personalizado
• Valor (opcional) — valor numérico da conversão; compatível com Handlebars
• Moeda (opcional) — por exemplo, INR ou USD
• Dados personalizados (opcional) — parâmetros adicionais do evento como pares de chave/valor

Como funciona a atribuição

• O Chakra lê ctwa_clid e wabaId da origem de marketing marketingSource.
• Os eventos são enviados com action_source=business_messaging e o canal de mensagens whatsapp.
• O conjunto de dados da Meta é localizado automaticamente a partir da WABA quando a ação é executada.

Verificar

1. Confirme se existe uma conexão com Facebook / Meta em Conexões de contas de anúncios.
2. Inicie uma conversa CTWA para que o Chakra armazene ctwa_clid no chat ou processo.
3. Acione a condição da Regra de ciclo de vida (por exemplo, mude o lead para o estado convertido).
4. Confirme se a regra foi executada com sucesso e, em seguida, verifique o evento de conversão no Gerenciador de Eventos da Meta.

Observações

• Sem uma conexão com uma conta de anúncios do Facebook / Meta, o Chakra não pode enviar eventos de conversão CTWA para a API de Conversões da Meta.
• Se ctwa_clid estiver ausente → a ação será ignorada.
• Falhas ao localizar o conjunto de dados da WABA aparecem como erros da ação.
• Consulte também a visão geral das Regras de ciclo de vida em Plataforma → Recursos para saber como eventos e ações funcionam em conjunto.