> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta y Google Ad Tags & Details

> Cuando alguien hace clic en un  o en un  y te envía un mensaje, el sistema automáticamente:

* **Etiqueta al contacto** para que puedas identificar instantáneamente los leads de anuncios
* **Guarda los metadatos del anuncio en campos personalizados** del contacto *(solo para Meta Ads)*
* **Añade todos los metadatos disponibles del anuncio** al primer mensaje de WhatsApp

Esto facilita ver qué anuncio generó el lead, construir automatizaciones y atribuir ingresos a las campañas.

***

## ¿Qué se Agrega?[​](#qué-se-agrega "Enlace directo al ¿Qué se Agrega?")

### 1. Etiquetas de Contacto (Meta Ads)[​](#1-etiquetas-de-contacto-meta-ads "Enlace directo al 1. Etiquetas de Contacto (Meta Ads)")

Para leads de **Meta Click-to-WhatsApp**, añadimos automáticamente:

* `instagram-ad-lead-whatsapp` – cuando el lead proviene de un anuncio de Instagram
* `fb-ad-lead-whatsapp` – cuando el lead proviene de un anuncio de Facebook

Usa estas etiquetas en listas inteligentes, flujos de trabajo, pipelines e informes.

***

### 2. Detalles del Anuncio Añadidos al Mensaje[​](#2-detalles-del-anuncio-añadidos-al-mensaje "Enlace directo al 2. Detalles del Anuncio Añadidos al Mensaje")

Junto con el mensaje del lead, añadimos los metadatos del anuncio directamente en el mensaje de WhatsApp:

```text theme={null}
Hola, me interesa el tratamiento Plasma IQsourceApp: facebooksourceType: adsourceId: 1234567890campaignName: Plasma IQ Lead Gen – MXadSetName: Lookalike 1% – Women 25–45adName: Video Test 3 – Hook AmediaType: VIDEO...
```

> Los campos exactos dependen de lo que Meta/Google envíen. Reenviamos todo lo que recibimos para que no pierdas datos de atribución.

***

## Campos Personalizados (Meta Ads - Nueva Función)[​](#campos-personalizados-meta-ads--nueva-función "Enlace directo al Campos Personalizados (Meta Ads - Nueva Función)")

Cuando un contacto escribe a través de un anuncio de Meta, extraemos automáticamente los datos del anuncio y los guardamos como **campos personalizados** en el contacto. Esto te permite rastrear qué anuncio, campaña y plataforma generó cada lead directamente en tu CRM.

### Cómo Funciona[​](#cómo-funciona "Enlace directo al Cómo Funciona")

<Steps>
  <Step>
    El contacto hace clic en un anuncio de Meta → se abre WhatsApp → envía un mensaje
  </Step>

  <Step>
    Meta adjunta metadatos del anuncio a ese mensaje
  </Step>

  <Step>
    Nuestro sistema extrae los metadatos y los guarda en campos personalizados
  </Step>

  <Step>
    Si existe un campo personalizado → se rellena
  </Step>

  <Step>
    Si no existe → se omite silenciosamente
  </Step>
</Steps>

> No se requiere configuración de nuestra parte. Solo crea los campos personalizados que desees.

### Campos Personalizados Disponibles[​](#campos-personalizados-disponibles "Enlace directo al Campos Personalizados Disponibles")

Crea los campos en **Configuración → Campos Personalizados → Agregar Campo**. La clave del campo debe coincidir exactamente:

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/assets/images/Field-name-4f2bacd9e86fc39fa7868ef972a50256.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=4b5e93476fdeeda27fab2e4e9de6c0d5" alt="Ejemplo de configuración de campo personalizado" width="2880" height="1622" data-path="images/features/assets/images/Field-name-4f2bacd9e86fc39fa7868ef972a50256.png" />
</Frame>

| Nombre del campo        | Tipo           | Descripción                            | Ejemplo                                    |
| ----------------------- | -------------- | -------------------------------------- | ------------------------------------------ |
| `source_app`            | Texto          | Plataforma donde se publicó el anuncio | `facebook`, `instagram`                    |
| `source_url`            | Texto          | URL del anuncio/publicación            | `https://www.instagram.com/p/DSYeWccjKJP/` |
| `source_id`             | Texto          | ID único del anuncio en Meta           | `120240271425200365`                       |
| `title`                 | Texto          | Título/encabezado del anuncio          | `¡Oportunidad Única! `                     |
| `body`                  | Texto (Grande) | Texto del cuerpo del anuncio           | Copia completa del anuncio                 |
| `source_type`           | Texto          | Tipo de fuente                         | `ad`                                       |
| `media_type`            | Texto          | Formato del medio                      | `IMAGE`, `VIDEO`                           |
| `ctwa_clid`             | Texto          | ID de seguimiento de clics             | `Afe9mAvBPUVos1-QSGjl4h...`                |
| `greeting_message_body` | Texto (Grande) | Mensaje de saludo automático           | `Hola, gracias por tu interés...`          |

### Instrucciones de Configuración[​](#instrucciones-de-configuración "Enlace directo al Instrucciones de Configuración")

<Steps>
  <Step>
    Ve a **Configuración → Campos Personalizados → Agregar Campo**
  </Step>

  <Step>
    Crea los campos que desees usando las claves exactas indicadas arriba
  </Step>

  <Step>
    Elige el tipo de campo apropiado (**Texto** o **Texto Grande**)
  </Step>

  <Step>
    Guarda
  </Step>
</Steps>

Eso es todo. La próxima vez que un contacto escriba a través de un anuncio de Meta, los campos se rellenarán automáticamente.

### Notas Importantes[​](#notas-importantes "Enlace directo al Notas Importantes")

* **Crea solo los campos que necesites.** La mayoría de los usuarios solo necesitan `source_app`, `source_url`, `source_id` y `title`
* **Los campos se actualizan en cada mensaje CTWA.** Los nuevos datos del anuncio sobrescriben los valores anteriores
* **Funciona para Facebook e Instagram.** El campo `source_app` te indica la plataforma
* **Sin impacto en la funcionalidad existente.** La adición de metadatos al mensaje sigue funcionando como antes

***

## Cómo Usar Estos Datos en Flujos de Trabajo[​](#cómo-usar-estos-datos-en-flujos-de-trabajo "Enlace directo al Cómo Usar Estos Datos en Flujos de Trabajo")

### Usando Etiquetas[​](#usando-etiquetas "Enlace directo al Usando Etiquetas")

* **Disparador:** Etiqueta de Contacto Añadida → `fb-ad-lead-whatsapp` O `instagram-ad-lead-whatsapp`
* **Acciones:**
  * Crear Oportunidad en un pipeline específico
  * Asignar a un representante de ventas
  * Enviar una secuencia de seguimiento personalizada
  * Notificar al equipo por Slack/Email

### Usando Campos Personalizados (Recomendado)[​](#usando-campos-personalizados-recomendado "Enlace directo al Usando Campos Personalizados (Recomendado)")

**Ejemplo 1: Enrutar por plataforma**

* **Disparador:** Contacto Creado o Actualizado
* **Filtro:** Campo personalizado `source_app` = `instagram`
* **Acciones:**
  * Asignar al especialista de Instagram
  * Enviar una bienvenida específica para Instagram
  * Agregar al pipeline de leads de Instagram

**Ejemplo 2: Segmentación avanzada**

* **Disparador:** Contacto Creado
* **Filtro:** Campo personalizado `title` contiene `Retargeting`
* **Acciones:**
  * Enviar seguimiento basado en urgencia
  * Agregar al pipeline de leads calientes
  * Programar una llamada inmediata

### Usando el Contenido del Mensaje[​](#usando-el-contenido-del-mensaje "Enlace directo al Usando el Contenido del Mensaje")

Analiza los datos añadidos al mensaje usando webhooks o herramientas de automatización (n8n, Make, Zapier) para extraer los nombres de campaña/conjunto de anuncios/anuncio y realizar enrutamiento avanzado.

***

## Dónde Ver Estos Datos[​](#dónde-ver-estos-datos "Enlace directo al Dónde Ver Estos Datos")

**Campos Personalizados del Contacto:**

<Steps>
  <Step>
    Ve a **Contactos**
  </Step>

  <Step>
    Abre un contacto proveniente de un anuncio de Meta
  </Step>

  <Step>
    Desplázate hasta la sección **Campos Personalizados**
  </Step>

  <Step>
    Visualiza los campos del anuncio rellenados
  </Step>
</Steps>

**Mensaje de la Conversación:**

<Steps>
  <Step>
    Ve a **Conversaciones**
  </Step>

  <Step>
    Abre una conversación proveniente de un anuncio
  </Step>

  <Step>
    Mira el primer mensaje
  </Step>

  <Step>
    Consulta los metadatos añadidos al final
  </Step>
</Steps>

***

## Requisitos de Conexión[​](#requisitos-de-conexión "Enlace directo al Requisitos de Conexión")

Para que los mensajes de Meta Ads se sincronicen de forma confiable:

* El teléfono debe estar **en línea con internet activo**
* La app de WhatsApp debe estar **en ejecución** (puede estar en segundo plano)
* Se recomienda una **conexión estable** (WiFi o datos móviles confiables)

> Si tu teléfono está desconectado, los mensajes pueden retrasarse o no sincronizarse. Usa un dispositivo dedicado para tu número empresarial y garantiza sincronización 24/7.

***

## Requisitos[​](#requisitos "Enlace directo al Requisitos")

* Campaña de Meta o Google configurada como **Click-to-WhatsApp**
* Número de WhatsApp conectado a través de nuestra plataforma
* Para campos personalizados: crear los campos en el CRM con las claves correspondientes
* Teléfono en línea con conexión estable

***

## Mejores Prácticas[​](#mejores-prácticas "Enlace directo al Mejores Prácticas")

* **Nombra las campañas claramente** – Usa nombres significativos (ej., `MX | Plasma IQ | IG Story | Warm`) para identificarlas fácilmente
* **Crea los campos personalizados necesarios** – La mayoría solo necesita `source_app`, `source_url`, `source_id`, `title`
* **Construye flujos de trabajo dedicados** – Enruta leads de Facebook, Instagram y Google de forma diferente
* **Usa etiquetas para organización** – Combina etiquetas de anuncios con etiquetas internas (`hot-lead`, `consult-booked`)
* **Mantén el teléfono conectado** – Una conexión estable garantiza la entrega de mensajes en tiempo real

***

## Preguntas Frecuentes[​](#preguntas-frecuentes "Enlace directo al Preguntas Frecuentes")

<AccordionGroup>
  <Accordion title="¿Funciona esto tanto para Facebook como para Instagram?">
    Sí. Las etiquetas los diferencian:

    * `fb-ad-lead-whatsapp` → Facebook
    * `instagram-ad-lead-whatsapp` → Instagram

    El campo personalizado `source_app` también muestra `facebook` o `instagram`.
  </Accordion>

  <Accordion title="¿Funciona esto para Google Ads?">
    Sí, para **anuncios de Google Click-to-WhatsApp**. Los datos del anuncio se añaden al cuerpo del mensaje.

    > **Nota:** Los campos personalizados son actualmente solo para Meta Ads. Los datos de Google aparecen únicamente en el cuerpo del mensaje.
  </Accordion>

  <Accordion title="¿Necesito crear todos los campos personalizados?">
    No. Crea solo los campos que necesites. Los más comunes son `source_app`, `source_url`, `source_id` y `title`. Los campos que no crees se ignoran.
  </Accordion>

  <Accordion title="¿Qué pasa si creo campos después de que ya llegaron leads?">
    Los campos personalizados se rellenan solo en mensajes nuevos. Los contactos existentes no se actualizarán de forma retroactiva. Si hacen clic en un nuevo anuncio y vuelven a escribir, los campos se rellenarán entonces.
  </Accordion>

  <Accordion title="¿Puedo desactivar esto?">
    El etiquetado y la adición de mensajes siempre están activos para preservar los datos de atribución. Los campos personalizados son opcionales - no los crees si no los necesitas.
  </Accordion>

  <Accordion title="¿Funciona esto para mensajes orgánicos?">
    No. Las etiquetas, campos personalizados y detalles del anuncio solo aplican a anuncios de Meta/Google Click-to-WhatsApp. Los mensajes orgánicos no se ven afectados.
  </Accordion>

  <Accordion title="¿Qué pasa si mi teléfono está desconectado cuando alguien hace clic en mi anuncio?">
    WhatsApp pone el mensaje en cola y lo entrega cuando tu teléfono esté en línea. Sin embargo, la sincronización con el CRM puede retrasarse. Mantén tu teléfono conectado para una entrega en tiempo real.
  </Accordion>

  <Accordion title="¿Puedo usar campos personalizados en listas inteligentes?">
    Sí. Crea listas inteligentes filtrando por `source_app`, `title` o cualquier otro campo personalizado para segmentar leads de anuncios.
  </Accordion>

  <Accordion title="¿Puedo exportar contactos con estos campos?">
    Sí. Los campos personalizados se exportan junto con el resto de los datos del contacto.
  </Accordion>
</AccordionGroup>

***

## Soporte[​](#soporte "Enlace directo al Soporte")

Si necesitas ayuda con la configuración o incorporación:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)