API de Conversiones de Meta

Esta guía te ayudará a configurar la API de Conversiones de Meta usando OneChat para enviar eventos de conversión desde Facebook, Instagram y WhatsApp. Cada plataforma tiene requisitos y pasos de configuración específicos, que se describen a continuación.

Resumen

● Crearás una Fuente de Datos de Mensajería en Meta Events Manager.

● Luego obtendrás las credenciales (Access Token y Data Set ID).

● Estas credenciales se agregan en OneChat.

● Finalmente, activarás eventos usando la API de Conversiones de Meta dentro del Flow Builder de OneChat.

Paso 1: Crear una Fuente de Datos de Mensajería

1. Ve a Meta Events Manager: https://business.facebook.com/events_manager

2. Haz clic en + Add Data Source.

3. Selecciona Messaging como tipo de fuente y luego haz clic en Next.

A) Integración con Facebook

Paso 1: Seleccionar la página de Facebook

1. Elige Facebook como plataforma.

2. Selecciona tu página de Facebook.

3. Otorga todos los permisos solicitados.

Si tu página no aparece:

● Asegúrate de que tu cuenta de Facebook sea administradora de la página.

● La página debe estar activa y conectada a un Business Manager.

Paso 2: Asignar nombre a la fuente de datos

1. Ingresa un nombre único (evita usar exactamente el nombre de la página).

2. Haz clic en Start Integration.

1. Espera la confirmación y luego cierra la ventana de configuración.

Paso 3: Copiar las credenciales de acceso

1. Ve a la pestaña Settings de la nueva fuente de datos.

2. Copia el Data Set ID.

1. Haz clic en Generate Access Token y luego cópialo.

Paso 4: Agregar las credenciales en OneChat

1. En OneChat, abre la configuración de tu espacio de trabajo.

2. Ve a Integrations > Meta Conversions API.

3. Pega el Data Set ID y el Access Token en los campos correspondientes.

4. Haz clic en Save.

Paso 5: Enviar eventos en la configuración del flujo de OneChat

1. Abre tu Flow Builder en OneChat.

2. Agrega un Action Node.

3. Elige: Events Actions > Facebook/Instagram/WhatsApp APIs > Meta Conversions API

Paso 6: Probar eventos

1. En Meta Events Manager, abre tu Fuente de Datos.

2. Ve a la pestaña Test Events y selecciona el canal para la prueba.

3. Copia el Test Event Code.

1. Pega este código en la acción de OneChat al hacer la prueba.

1. Ejecuta el flujo y verifica que el evento aparezca en el panel de Test Events.

Nota: puedes obtener el PSID para tu prueba haciendo clic en Explorer Graph API y copiando el PSID de los datos:

Paso 7: Configuración especial para anuncios Click-to-WhatsApp Ads (CTWA)

Si estás ejecutando anuncios CTWA:

● Cuando el usuario envía un mensaje, el payload incluye un referral ID.

● Necesitas capturar este referral ID dentro de tu flujo.

● Además, debes pasar el Facebook Page ID asociado con el anuncio. Ambos valores son obligatorios para que Meta atribuya correctamente el evento.

Para obtener el CTWA_clid, puedes ver el tutorial en el siguiente enlace, donde explicamos cómo guardar el payload de CTWA_clid a través del WhatsApp Ad Referral Trigger:

WhatsApp Ad Referral

Notas importantes

Integración con WhatsApp

● Debes usar un número de WhatsApp Business Platform (no WhatsApp personal).

● El número debe estar conectado a un Facebook Page ID.

● Para Click-to-WhatsApp Ads (CTWA), debes manejar los referral ID. Si no aparece en la lista:

● Asegúrate de que tu número esté conectado mediante la configuración de WhatsApp Business Manager.

Integración con Instagram

Si Instagram no aparece en la lista:

● Abre la app de Instagram > Settings > Account Center > Connect to Facebook.

Solución de problemas comunes

● La página o el perfil de IG no está conectado a un Business Manager.

● Se está intentando usar una cuenta personal de WhatsApp en lugar de una cuenta empresarial.

● El token expiró o no se generó correctamente.

● La página de Facebook está inactiva o no tiene los permisos requeridos.

● Falta el referral ID o el Page ID para campañas CTWA.

● La cuenta publicitaria tiene restricciones o problemas de facturación.

Notas finales

Una vez que todo esté configurado correctamente:

● Puedes reutilizar la misma Fuente de Datos en múltiples flujos.

● No es necesario reintegrarla, a menos que quieras separar eventos por marca o plataforma.

● Siempre realiza pruebas antes de publicar para verificar que Meta esté recibiendo los eventos. Tu integración de Meta Conversions API está completa.

Si encuentras algún problema o tienes comentarios, no dudes en abrir un ticket de soporte escribiéndonos a hola@onechat.co