Descubre qué anuncio de Facebook o Instagram generó un chat de WhatsApp

En Deskwoot, saber qué anuncio de Facebook o Instagram generó un chat de WhatsApp es automático: cada anuncio Click-to-WhatsApp envía los datos de referencia de Meta a tu bandeja de entrada junto con el primer mensaje, y Deskwoot guarda todo el contexto del anuncio en la conversación, en el contacto y a través de la API.

Qué datos se guardan

Cada vez que un visitante hace clic en un anuncio Click-to-WhatsApp y envía su primer mensaje, Meta agrega un objeto referral al webhook entrante. Guardamos el objeto completo en la conversación:

• Tipo de origen. Puede ser ad o post, según si el clic vino de un anuncio pagado o de un botón “Enviar mensaje” en una publicación de Facebook o Instagram.
• ID del anuncio o de la publicación. El objeto de Meta que generó el clic, útil para agrupar las conversaciones por anuncio en tus informes.
• ID del clic (ctwa_clid). El identificador de cada clic, que puedes comparar con tus informes de Meta Ads y volver a enviar a la API de Conversiones.
• Título y texto. El texto exacto del anuncio que vio el visitante en el momento del clic.
• URL de origen. Un enlace directo al anuncio o a la publicación en Facebook.
• Tipo de contenido y URL de la imagen o del video. El creativo que el visitante estaba viendo cuando hizo clic.

Dónde encontrarlo en Deskwoot

Abre cualquier conversación de WhatsApp. El panel de información de la derecha muestra una tarjeta verde Vino de un anuncio de WhatsApp cada vez que la conversación empezó desde un anuncio Click-to-WhatsApp. Si la misma persona hace clic en otro anuncio mientras su conversación sigue abierta, la nueva atribución reemplaza la tarjeta visible y la anterior se conserva en conversation.customAttributes.whatsappReferralHistory.

La referencia más reciente también se copia en el contacto, en customAttributes.lastWhatsappReferral, así que la atribución se mantiene para cualquier conversación futura de la misma persona.

Obtener los datos por API

Los datos están disponibles en los endpoints normales de conversaciones y contactos, dentro de customAttributes. Para leerlos por API necesitas un token de API, y solo el plan Enterprise puede crearlo:

GET /api/v1/conversations/<id>
{
  "id": "...",
  "customAttributes": {
    "whatsappReferral": {
      "sourceUrl": "https://fb.me/2abc123def",
      "sourceId": "120203456789012345",
      "sourceType": "ad",
      "headline": "Patch Video Ad",
      "body": "Get our new patch with 30% off this week",
      "ctwaClid": "AAabcdEFGHijklMNOPqrstUVWxyz1234567890",
      "capturedAt": "2026-05-01T19:39:41Z"
    }
  }
}

Enviar los datos a tu CRM o a tu plataforma de anuncios

Los webhooks salientes de Deskwoot (Configuración > Webhooks) no incluyen los datos del anuncio. Eventos como Conversación actualizada o Conversación resuelta llevan el ID de la conversación. Usa ese ID para leer la conversación por API como se muestra arriba y luego envía customAttributes.whatsappReferral (ID del clic e ID del anuncio) a HubSpot, Pipedrive, Notion, Google Sheets o de vuelta a la API de Conversiones de Meta para optimizar tus campañas con resultados reales.

Límites que debes conocer

• Meta solo agrega el objeto referral al primer mensaje de una sesión que empieza desde un anuncio. Lo tomamos en el primer mensaje y lo guardamos. Los mensajes siguientes de la misma conversación no lo traen.
• Las conversaciones que no empezaron desde un anuncio (chats orgánicos, respuestas manuales, clics en enlaces que no vienen de un anuncio) no muestran la tarjeta. Es lo correcto, porque no hay nada que atribuir.
• La función requiere el canal WhatsApp Cloud API. WhatsApp a través de Twilio no entrega los mismos datos.
• La tarjeta del anuncio en los detalles de la conversación está incluida desde el plan Business. Para leer los datos por API necesitas el plan Enterprise.

Preguntas frecuentes