Essa integração permite que o Assistente Virtual envie dados de eventos dos anúncios Facebook Click-to-WhatsApp (CTWA) para a Meta Conversion API (CAPI). Isso possibilita um rastreamento mais preciso das conversões e otimiza as campanhas publicitárias com base nos dados reais de interação dos usuários.
Antes de configurar o envio de eventos, certifique-se de solicitar os dados necessários, o Endpoint para onde os eventos devem ser enviados e os cURLs de cada evento por meio de um Service Request.
A seguir, você encontrará os eventos compatíveis com a Conversion API for Business Messaging (Click-to-WhatsApp) que podem ser enviados a partir do Studio para a CAPI, junto com as boas práticas para uma implementação eficaz.
Eventos Disponíveis
Detalhes dos eventos compatíveis com a Meta Conversion API:
Purchase: uma compra atribuída à conversa foi concluída.
LeadSubmitted: o usuário enviou dados de contato (por exemplo, preencheu um formulário dentro do chat).
InitiateCheckout: o usuário iniciou um processo de pagamento.
AddToCart: o usuário adicionou um produto ao carrinho durante a conversa.
ViewContent: o usuário visualizou conteúdo relevante (como um item de catálogo ou material multimídia).
OrderCreated: um pedido vinculado à conversa foi criado.
OrderShipped: o pedido foi enviado.
OrderDelivered: o pedido foi entregue ao cliente.
OrderCanceled: o pedido foi cancelado.
OrderReturned: o pedido foi devolvido (total ou parcialmente).
CartAbandoned: o usuário abandonou um carrinho após interagir pelo chat.
QualifiedLead: o lead foi qualificado de acordo com as regras de negócio.
RatingProvided: o usuário forneceu uma avaliação.
ReviewProvided: o usuário deixou uma resenha (com ou sem avaliação).
Boas Práticas
Depois de ter todos os dados necessários, siga estas recomendações para garantir uma integração estável e uma medição precisa dos eventos:
Moeda e Valor: sempre inclua ambos os campos (currency e value) nos eventos com dados monetários.
Somente Eventos de Mensagens: relate apenas ações que ocorreram dentro da conversa do WhatsApp (as conversões web/app devem ser enviadas por outros canais da CAPI).
Validação: verifique a ingestão dos eventos no Events Manager correspondente ao seu dataset_id.
Desduplicação: use ctwa_clid como chave única, se necessário.
- Tratamento de Erros:
Se aparecer o erro error_subcode: 2804132, isso significa que o dataset_id não está vinculado à WABA.
Crie ou verifique o dataset com o waba_id correto e atualize a configuração do canal.