# Cómo transferir parámetros y etiquetas UTM

{% hint style="info" %}
Plataformas como Instagram, Facebook, WhatsApp y Telegram implementan este mecanismo a través del `visit_key` parámetro.
{% endhint %}

**Compatibilidad con deep links**\
La mayoría de los mensajeros (como Instagram, Facebook, Telegram) admiten deep links. Sin embargo, otros no.

**Solución alternativa para WhatsApp**\
Aunque WhatsApp no cuenta con deep linking nativo, aún puedes pasar parámetros y etiquetas UTM. Para ello, inserta una variable especial en el texto del mensaje predefinido que aparece al usuario después de hacer clic en tu enlace. (Este método se cubrirá en detalle más adelante.)

**Almacenamiento de parámetros**\
Todos los parámetros enviados se guardan como variables del cliente dentro del sistema.

**Estructura y tipos de parámetros**\
Un parámetro es un **par clave-valor**. Según su origen, los parámetros pueden ser:

* **Estáticos:** Tú defines el valor exacto que se transmitirá.
  * **Ejemplo:** `utm_term=webinar1` (donde `utm_term` es el nombre y `webinar1` es el valor estático).
* **Dinámicos:** La plataforma publicitaria (por ejemplo, Google Ads, Facebook Ads) inserta automáticamente los datos relevantes en el momento del clic.
  * **Ejemplo:** `term={keyword}` — aquí, el `{keyword}` marcador de posición se reemplaza dinámicamente por el término de búsqueda real que activó el anuncio.

#### Cómo usar estos parámetros en un sitio

Todos los parámetros enviados a tu sitio se convertirán en variables de trato una vez que el cliente inicie el bot. Esto incluye etiquetas UTM y otras etiquetas.

**Para obtener el enlace de tu sitio**, ve a **"Sitios"** sección.

<div data-with-frame="true"><figure><img src="/files/9cc8cb9ef4d3cd9207dc0bc050390ed99b046230" alt="" width="563"><figcaption></figcaption></figure></div>

Ejemplo de cómo agregar etiquetas UTM a un enlace de sitio:

`https://mavibot.ai/st/black_friday_mavibot?utm_source=test_wi_me&utm_medium=cpc&utm_campaign=id_campaign&utm_content=registration`

Los parámetros y etiquetas se pasarán al bot y se guardarán como variables del cliente.

<div data-with-frame="true"><figure><img src="/files/e8d9bd6fee81654b14d53a4d391760d51b063d17" alt=""><figcaption></figcaption></figure></div>

#### Cómo usar estos parámetros sin un sitio

Puedes usar **enlaces proxy** para pasar parámetros directamente. Una vez que el bot se inicie mediante ese enlace, todos los datos transmitidos se guardarán como variables de trato.

**El formato del enlace con parámetros debe ser el siguiente:**

**Estructura del enlace proxy**

Un enlace proxy parametrizado consta de dos partes:

1. **URL base** (el propio enlace proxy): `https://mavibot.ai/r/mavibot_1`
2. **Cadena de consulta** (tus parámetros): `?param1=value1&param2=value2`

**Ejemplo: agregar etiquetas UTM a un enlace de Telegram**

Aquí tienes un ejemplo de un enlace directo desde un sitio a Telegram con parámetros UTM:

<https://mavibot.ai/r/mavibot_1?utm_medium=cpc&utm_source=yandex&utm_term=key_phrase&utm_content=HappyNY#ancor>

<div data-with-frame="true"><figure><img src="/files/f6ec4ca96f73deacbfba731e6dcc6a4ff8cde68c" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/dee78bbb592bf2e13818a6477b3e941ed717d676" alt=""><figcaption></figcaption></figure></div>

**Enlaces directos a mensajeros en "Sitios"**

Esta sección muestra enlaces en los que se puede hacer clic para todos los mensajeros integrados con tu sistema.

## Funciones de WhatsApp

Como WhatsApp no admite deep links, debes añadir una variable especial al mensaje de apertura del bot. El bot usará esta variable para identificar los parámetros con los que se inició WhatsApp.

**La variable: `#{visit_key}`**

Cuando un usuario haga clic en tu enlace de WhatsApp, este marcador de posición se reemplazará automáticamente por un código numérico único que contiene los parámetros enviados.

<div data-with-frame="true"><figure><img src="/files/00f9c71f92a2e9be6692d561476127c63409c4e6" alt=""><figcaption></figcaption></figure></div>

"Sitios" → Sitio → Configuración de la página del sitio → Mensajeros → Configuración de WhatsApp

Cuando un usuario vaya a WhatsApp desde tu sitio (o mediante un enlace de mensajero desde la configuración del sitio), el `#{visit_key}` marcador de posición se reemplaza por un código numérico único.

<div data-with-frame="true"><figure><img src="/files/60a8e09c9032284890aa13ece33ca30682bb6a98" alt="" width="375"><figcaption></figcaption></figure></div>

## Suscripción a Instagram

**Evolución del seguimiento de parámetros**

* **Método anterior (`#{visit_key}`):**
* El `#{visit_key}` la variable se utilizaba colocándola en el **"Mensaje inicial de WhatsApp"**. Esto permitía rastrear los parámetros de inicio de las interacciones de Instagram.
* **Método actual (deep links con parámetros de referencia):**

Ahora puedes pasar parámetros de referencia directamente a través de deep links de Instagram, lo que ofrece mayor flexibilidad y control.

**Beneficios de usar parámetros de referencia:**

Con los parámetros de referencia, puedes:

* **Rastrear campañas** vinculando los clics a fuentes o canales específicos.
* **Atribuir usuarios** conectando un visitante de Instagram con una sesión o cuenta en tu aplicación externa.
* **Personalizar recorridos** dirigiendo a los usuarios a contenido específico o funciones concretas dentro de tu cuenta de Instagram.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcc5PLfQg8uf4gvxZZ406aRwpoDcBtDJzqbOOthnQ2fjKIQ8UHr8NTFUVl5vkbPN541vIv5lvbRxhEn0n7FSDt-g7NYwodzJg09vzSowpMRTQaSrNwbBf3XTCpYuT2rKbDUAjADeg?key=9cFsqYH0-lPo60eUI7iEQg" alt=""><figcaption><p>Deep link de Instagram</p></figcaption></figure>

El parámetro REF\_PARAM se transmite al servidor a través de un webhook.

Ejemplo: <https://ig.me/m/mavibotai?ref=mavi>

Puedes copiar el enlace a tu bot de Instagram en la sección "Canales".

El enlace se ve así: <https://ig.me/m/\\>\<account\_login\_instagram> \*

<div data-with-frame="true"><figure><img src="/files/da727d2bc21a2d28c47bdeb4adbed48ce28775c1" alt=""><figcaption></figcaption></figure></div>

El enlace se ve así: <https://ig.me/m/\\>\<account\_login\_instagram>\*

Añade el parámetro al enlace copiado:?ref=\<tu parámetro>&#x20;

A continuación, puedes usar el enlace con el parámetro ref para incorporar usuarios al bot de Instagram.

El parámetro se transmitirá SOLO en el primer contacto del usuario con tu cuenta (bot).

## Etiquetas UTM en la sección Analytics

Puedes ver estadísticas sobre las etiquetas UTM en la sección "Analytics"

Ve a la sección "Analytics" y selecciona la pestaña "Clients".

<div data-with-frame="true"><figure><img src="/files/02f5c3c733d557942a97af1f84f6888817d5bc23" alt="" width="563"><figcaption></figcaption></figure></div>

Haz clic en el botón "Add widget".

<div data-with-frame="true"><figure><img src="/files/7534665c54450ec59a11885e0e45f405b13718d9" alt="" width="563"><figcaption></figcaption></figure></div>

El **Se abrirá la ventana del** constructor de widgets.

1. Selecciona el **Etiquetas UTM** .
2. Haz clic en el **"Agregar un valor"** botón.

<div data-with-frame="true"><figure><img src="/files/4d1cbe97b63ffa81fbdaef506f3fb6a997b6d035" alt="" width="375"><figcaption></figcaption></figure></div>

Aparecen opciones de configuración adicionales para los valores de las etiquetas UTM. Haz clic en el campo **"Seleccionar una etiqueta"**.

<div data-with-frame="true"><figure><img src="/files/37eafe86a545f3c567db1c9aa9001bfe7cd360f0" alt="" width="563"><figcaption></figcaption></figure></div>

y selecciona la etiqueta de la que deseas ver las estadísticas.

<div data-with-frame="true"><figure><img src="/files/fb627b66654bfdcb726c0da97a2cbeb804d3b4d3" alt="" width="325"><figcaption></figcaption></figure></div>

Si quieres agregar varias etiquetas o todas, haz clic de nuevo en "Agregar un valor".

<div data-with-frame="true"><figure><img src="/files/684dbcf589cfa8c443f16b252ed5dbc624bd760c" alt="" width="563"><figcaption></figcaption></figure></div>

No olvides especificar el período y otros ajustes, y asegúrate de guardarlos.

Luego añade la cantidad requerida de etiquetas y después haz clic en el botón "Guardar".&#x20;

<div data-with-frame="true"><figure><img src="/files/c3b83e377568593156c80727bf652397e466bb17" alt="" width="375"><figcaption></figcaption></figure></div>

A continuación, debes hacer clic en el botón "Add a widget".

<div data-with-frame="true"><figure><img src="/files/1c41f2c3673f7ce06347b2370655931948039c33" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Lee más sobre cómo trabajar con Analytics en el artículo "[MaviBot Analytics](/doc/es/analitica-de-mavibot.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/es/websites/sitios/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.