Datos de origen de anuncios
Cuando un contacto escribe desde un anuncio de Meta (Click-to-WhatsApp, Click-to-Messenger o un anuncio de Instagram), guardamos qué anuncio lo trajo en la conversación, en additional_attributes.meta_referral. Sirve para atribuir leads y ventas a campañas, y para cerrar el círculo con la Conversions API de Meta.
Dónde está
- Por API:
GET /api/v1/accounts/{account_id}/conversations/{id}→additional_attributes.meta_referral. También viene en los listados y en el filtro. - Por webhook: puede aparecer en
additional_attributesde los eventos de conversación una vez capturado. El evento de creación puede emitirse antes de guardar el referral; si falta, consultá el detalle por API.
La actualización depende del canal:
| Conexión | Cuándo se guarda o cambia |
|---|---|
| WhatsApp Cloud nativo | Se captura si el mensaje trae referral al crear una conversación nueva. No se vuelve a capturar en cada mensaje de esa conversación. |
| Messenger e Instagram nativos | Un referral de un anuncio distinto puede reemplazar el anterior en la misma conversación. Repetir el mismo ID de anuncio conserva el dato existente. |
Conector externo (Channel::Api) |
Depende del conector; no asumas el comportamiento del canal nativo. |
La creación o reapertura de una conversación depende del canal y de la configuración de la bandeja. meta_referral representa el dato actualmente guardado, no un historial de todos los clics. Si necesitás atribución histórica, almacená tus propias observaciones con fecha y reconciliá por API.
Forma del dato
Es un objeto plano con las mismas claves para todos los canales. Las claves que Meta no envió se omiten (no vienen en null).
"meta_referral": {
"source_type": "ad",
"source_id": "120211234567890",
"headline": "Cocinas a medida",
"body": "Pedí tu presupuesto sin cargo",
"source_url": "https://fb.me/xyz",
"ctwa_clid": "ARAkP1n...",
"media_type": "image",
"image_url": "https://scontent.../ad.jpg",
"captured_at": "2026-09-02T14:00:00Z"
}
| Campo | Canales | Significado |
|---|---|---|
source_type |
Todos | ad para anuncios. En otros orígenes, la fuente de Meta en minúsculas (post, shortlink). |
source_id |
Todos | Id del anuncio en Meta. Cruzalo con el Ads Manager o la Marketing API para obtener campaña y conjunto. |
headline |
Todos | Título del anuncio tal como lo vio el cliente. |
image_url, video_url |
Todos | La pieza del anuncio. |
body |
Texto del anuncio. | |
source_url |
URL del anuncio o publicación. | |
ctwa_clid |
Click id de Click-to-WhatsApp. Es el identificador que acepta la Conversions API de Meta para atribuir eventos (por ejemplo, una venta) al anuncio. | |
media_type, thumbnail_url |
Tipo de pieza (image o video) y miniatura. |
|
ref |
Messenger, Instagram | Parámetro ref del anuncio o del link m.me, si lo configuraste. |
type |
Messenger, Instagram | OPEN_THREAD. |
channel |
Messenger, Instagram | messenger o instagram. Útil en conexiones que comparten Channel::FacebookPage; verificá también la bandeja. |
psid, page_id |
Messenger | Id del remitente en la página y id de la página. |
igsid, ig_account_id |
Id del remitente en Instagram y id de la cuenta de Instagram. | |
captured_at |
Todos | Cuándo lo registramos, en ISO 8601. |
Ejemplo de un lead de Instagram:
"meta_referral": {
"source_type": "ad",
"source_id": "120211234567890",
"headline": "Cocinas a medida",
"image_url": "https://scontent.../ad.jpg",
"ref": "verano-2026",
"type": "OPEN_THREAD",
"channel": "instagram",
"igsid": "1784...",
"ig_account_id": "1784...",
"captured_at": "2026-09-02T14:00:00Z"
}
Cómo usarlo
- Filtrar leads de anuncios: en el filtro de conversaciones no se puede consultar dentro de
additional_attributes; filtrá por bandeja y fecha y quedate con las que tienenmeta_referral. Si querés segmentarlas en el panel, una regla de automatización puede etiquetarlas al crearse. - Atribuir campaña y conjunto:
source_ididentifica el anuncio, no la campaña. Los nombres de campaña y conjunto no están garantizados dentro demeta_referral; obtenelos desde tu integración autorizada con Meta. - Reportar conversiones: conservá
ctwa_clidcuando esté presente para tu integración con Conversions API. Guardarlo en el CRM no significa que una conversión ya haya sido enviada.
Campañas propias
Una campaña de mensajes del CRM es distinta de un anuncio de Meta. El campaign_id interno de una conversación no se incluye en el serializador REST general: no dependas de encontrarlo en GET .../conversations/{id}. El source_id de meta_referral identifica un anuncio o fuente de Meta, no una campaña de envíos del CRM.