API de Conversiones (CAPI) para Anuncios de WhatsApp – Seguimiento de eventos CTWA | WOZTELL

API de conversiones para WhatsApp (CTWA)

Introducción

Anuncio Click-to-WhatsApp (CTWA) es una forma común de ofrecer un punto de entrada desde el anuncio directamente a la conversación de WhatsApp. Con el soporte de Disparador de Anuncios Eventos de la Aplicación, puedes crear un flujo de conversión completo en el creador de chatbots.



Configurar CTWA

Para comenzar, necesitas configurar un Anuncio Click-to-WhatsApp (CTWA) para que los clientes puedan ser redirigidos desde la app a tu número de empresa.

Para configurar el CTWA en el Administrador de Anuncios, puedes consultar la guía proporcionada por Meta.



Conceder Permisos de Anuncios

  1. Para habilitar las funciones relacionadas con los anuncios Click-to-WhatsApp y los Eventos de Conversión en WOZTELL, por favor habilita los Permisos de Anuncios en la página de la plataforma del canal WhatsApp Cloud.

NOTA

Asegúrate de que el usuario de Facebook que realiza el inicio de sesión de Facebook para empresas tenga el permiso de "Control total" para gestionar la cuenta publicitaria correspondiente.



  1. En el primer paso del flujo de Inicio de sesión para empresas, selecciona la Cuenta Comercial que deseas conectar con WOZTELL.
  1. Elige la página que deseas asociar.
  1. Selecciona la cuenta publicitaria a la que deseas conectar.

Idea
NOTA:

Este conjunto de datos es esencial para registrar eventos de conversión mediante la Conversions API. WOZTELL gestiona la creación del conjunto de datos automáticamente usando tu ID de cuenta empresarial de WhatsApp (`waba_id`) y lo vincula a tu página conectada. Este conjunto de datos actúa como destino donde Meta recibe los datos de eventos para medir el rendimiento.
  1. Para la API de conversión, Meta creará un conjunto de datos en el Administrador de Eventos, el cual lleva el nombre de la página asociada.

  1. Permite que WOZTELL tenga los siguientes permisos.
  1. Ahora WOZTELL se ha conectado a tu cuenta empresarial.
  1. Haz clic en "Volver a Woztell" para cerrar la ventana emergente.


Funcionalidades

Al permitir los Permisos de Anuncios, ahora tienes acceso a funciones relacionadas con CTWA y la API de Conversiones.

Vista previa de CTWA

Con el Permiso de Anuncios, el Anuncio Click-to-WhatsApp (CTWA) puede visualizarse en el historial de conversación para diferenciarlo de otros tipos de entrada.

El Anuncio Click-to-WhatsApp (CTWA) también puede mostrarse en el hilo de la bandeja de entrada.



Disparador de Anuncios

El Disparador de Anuncios de Meta te permite crear flujos de chatbot específicamente para los usuarios que ingresaron a través de un CTWA. Es capaz de reconocer entradas por “un anuncio en particular” o “cualquier anuncio”. Además, puedes añadir grupos de palabras clave al disparador.

Idea
NOTA

Si configuras el Disparador de Anuncios sin ningún grupo de palabras clave, se activará con cualquier entrada del usuario, siempre que ese miembro esté asociado a un anuncio.


Crear Disparador

  1. Primero, crea un nodo global.
  1. Crea un nuevo disparador y selecciona Disparador de Anuncios de Meta.
  1. Puedes añadir palabras clave al disparador.
  1. Además, puedes decidir si el chatbot se activa por Todos los Anuncios o por Anuncios Específicos usando el correspondiente ID del Anuncio.

Crear Respuesta

  1. Para colocar la respuesta, crea un nodo general.
  1. Crea una nueva respuesta.
  1. Agrega el mensaje de respuesta y guarda el nodo.
  1. Por último, asegúrate de redirigir desde el nodo global al nodo general con la respuesta.


Enviar Evento de Conversión

Para los clientes que ingresan a la conversación a través de CTWA, Meta admite eventos de conversión para ayudar a hacer seguimiento de posibles conversiones. Puedes utilizar la acción para marcar una compra completada o un lead enviado en un punto específico del flujo del chatbot.

Estos eventos serán enviados a Meta y se asociarán con un anuncio CTWA específico.


Idea
NOTA:

Para garantizar la atribución correcta de la conversión al clic original del anuncio, el payload del evento debe incluir el campo "ctwa_clid" (Click-to-WhatsApp Click ID). Este identificador es capturado automáticamente por WOZTELL desde el objeto `referral` en el webhook cuando un usuario inicia una conversación a través de un CTWA.
Debes almacenar este ID y enviarlo más adelante cuando ocurra una conversión (por ejemplo, envío de lead o compra) durante la conversación.




  1. Dado que tienes un flujo de chatbot para entrada de usuario vía CTWA, puedes crear un nuevo nodo para enviar el evento.
  1. Crea una nueva acción.
  1. Selecciona "Enviar Evento de Conversión", luego elige el "ID de WABA", "ID de Cuenta de Anuncios" y "ID del Anuncio".


{
data: [
{
event_name: "Purchase",
event_time: 1675999999,
action_source: "business_messaging",
messaging_channel: "whatsapp",
user_data: {
whatsapp_business_account_id: "<WABA_ID>",
ctwa_clid: "<CLICK_ID>"
},
custom_data: {
currency: "USD",
value: 123
}
}
],
partner_agent: "WOZTELL"
}
  1. En "Tipo de Evento", si seleccionas "Compra", especifica la "Moneda" y el "Valor".
  1. Si seleccionas el evento "Lead", no será necesario rellenar ningún otro campo.
  1. Si lo necesitas, también puedes incluir información adicional en el campo "Entrada opcional". Consulta aquí para más detalles.
  1. Una vez que se ejecute el nodo que contiene la acción "Enviar evento de conversión", este será enviado a Meta para marcar una conversión completada.

Advertencia
Importante:

Meta no deduplica eventos automáticamente. Si existe la posibilidad de enviar la misma conversión múltiples veces (por ejemplo, por reintentos o múltiples flujos), asegúrate de que tu sistema gestione la deduplicación antes de llamar a la API de Conversiones.

Para confirmar rápidamente si los eventos se han enviado correctamente, puedes dirigirte al dataset correspondiente en el Administrador de eventos de tu Business Manager de Facebook.

Ahora puedes crear y enviar un Evento de compra o un Evento de lead para marcar una conversión completada. El evento se podrá visualizar en el Administrador de eventos dentro del Business Manager de Facebook.
Una vez enviado el evento, puedes validarlo en el Administrador de eventos de Meta seleccionando el dataset asociado a tu cuenta comercial. Esta confirmación garantiza que Meta ha recibido y procesado correctamente el evento.

Idea
NOTAS:

Los datos del evento se mostrarán en el dataset configurado en el paso 5 del proceso de permisos de anuncios.

Si trabajas como socio en nombre de un cliente, asegúrate de que el cliente sepa cómo localizar su dataset en el Administrador de eventos para fines de verificación.