Saltar al contenido principal
Los anuncios Click to WhatsApp (CTWA) de Facebook e Instagram abren una conversación de WhatsApp cuando el usuario hace clic. Esta guía explica cómo saber si un chat viene de un anuncio de Meta: cuando la conversación se origina en un anuncio, Jelou inserta automáticamente en memoria un objeto _referral con los datos del anuncio de origen. Con esa información puedes atribuir el lead, enrutar según la campaña, personalizar la primera respuesta o registrar el origen en tu CRM, sin cruzar datos manualmente entre Meta Ads Manager y el canal conversacional.

​
Cómo funciona

Cuando un usuario hace clic en un anuncio Click to WhatsApp, WhatsApp se abre con un mensaje inicial y Meta adjunta a esa primera interacción los datos de referencia (referral) del anuncio. Jelou detecta esos datos y los inserta automáticamente en la memoria de la conversación bajo la variable _referral.
No se requiere ninguna instalación en el Marketplace. El objeto _referral se inyecta automáticamente en memoria siempre que la conversación se origine en un anuncio Click to WhatsApp.

​
Detectar si un chat viene de un anuncio

Para saber si una conversación llegó desde un anuncio de Meta, comprueba si existe la variable _referral en memoria. Cuando la conversación se origina en un anuncio, Jelou inserta el siguiente objeto: 
{
  "_referral": {
    "source_url": "https://fb.me/XXXXX",
    "source_id": "120XXXXXXXXX387",
    "source_type": "ad",
    "body": "BODY_CONTENT",
    "media_type": "video",
    "video_url": "https://www.facebook.com/story.php?story_fbid=XXXXX",
    "thumbnail_url": "https://scontent.ftru6-2.fna.fbcdn.net/v/XXXXXXXXX",
    "ctwa_clid": "CTWA",
    "welcome_message": {
      "text": "WELCOME_MESSAGE"
    }
  }
}
Si _referral no existe en memoria, la conversación no se originó en un anuncio Click to WhatsApp (por ejemplo, un usuario que escribe directamente al número). Puedes aprender más sobre cómo leer estas variables en: Memory.

​
Referencia de campos

CampoDescripción
source_urlURL corta del anuncio de origen (por ejemplo, un enlace fb.me).
source_idIdentificador del anuncio o publicación de origen en Meta.
source_typeTipo de origen. El valor ad indica que la conversación vino de un anuncio.
bodyTexto principal del anuncio que vio el usuario antes de hacer clic.
media_typeTipo de contenido del anuncio: image o video.
video_urlURL del video del anuncio. Presente cuando media_type es video.
thumbnail_urlURL de la miniatura del contenido del anuncio.
ctwa_clidClick to WhatsApp Click ID: identificador único del clic, útil para atribución y reporting.
welcome_message.textMensaje de bienvenida configurado en el anuncio, con el que inicia la conversación.
Los campos disponibles dependen del anuncio. Un anuncio con imagen no incluirá video_url, y algunos campos pueden llegar vacíos según cómo esté configurado el creativo.

​
Cómo usarlo en tu flujo

Dentro de cualquier nodo puedes acceder a los datos del anuncio con la sintaxis de memoria {{$memory._referral.campo}}. Por ejemplo:
  • {{$memory._referral.source_type}} → ad
  • {{$memory._referral.ctwa_clid}} → identificador del clic para atribución
  • {{$memory._referral.body}} → texto del anuncio que vio el usuario
Una forma habitual de aprovecharlo es ramificar el flujo según el origen:
1

Comprueba si la conversación viene de un anuncio

Al inicio del flujo, evalúa si existe _referral en memoria. Si existe, la conversación llegó desde un anuncio Click to WhatsApp.
2

Guarda la atribución para reutilizarla

Conserva ctwa_clid y source_id en memoria o envíalos a tu CRM para atribuir el lead a la campaña de origen.
3

Personaliza o enruta según el anuncio

Usa body, source_url o source_id para adaptar la primera respuesta del agente, enrutar al equipo correcto o disparar una notificación interna.
El objeto _referral solo se inyecta cuando la conversación se origina en el anuncio. Si el usuario ya tenía una conversación previa con el número y vuelve a escribir sin pasar por el anuncio, la referencia puede no estar disponible.

​
Artículos relacionados

Memory

Cómo leer y persistir variables entre conversaciones y nodos.

Google Ads

Atribuye conversaciones de WhatsApp a tus campañas de Google Ads.