Transfiere variables personalizadas durante la suscripción a un chatbot

La integración de SendPulse con apps de mensajería te permite pasar variables personalizadas a tu cuenta de SendPulse cuando un usuario se suscribe a tu chatbot a través de un widget de sitio web o un enlace de chatbot. Usa esta función para actualizar automáticamente los valores de las variables en la Audiencia de tu chatbot.

También puedes enviar etiquetas UTM durante una suscripción. La Audiencia de tu chatbot guarda los valores UTM de cada suscriptor en variables.

Suscripción a través de un chat en vivo o un widget

El código JavaScript del chat en vivo y los widgets de suscripción pueden detectar y guardar automáticamente las etiquetas UTM.

Cuando un usuario visita tu sitio web a través de un enlace con etiquetas UTM, formateadas con ? y &, estas etiquetas se guardarán automáticamente en los datos de contacto de este usuario una vez que se suscriba.

Para transferir más etiquetas o variables personalizadas, utiliza uno de los dos métodos que se describen a continuación.

Método 1. Usar el script window.oSpP

Una vez que hayas creado un chat en vivo o un widget de suscripción, puedes usar un script para transferir automáticamente variables durante una suscripción al chatbot. Así es como puede lucir:

<script type="text/javascript">
    window.oSpP = {
        phone: '+123123123',
        email: 'username@example.com',
        name: "Annabelle",
        city: "London"
    }
</script>

Supongamos que tu sitio web, vinculado a un chatbot, recibe los datos de un visitante, como su nombre, ciudad, email, o teléfono. Si este visitante se suscribe a tu chatbot, este recibirá y guardará sus datos en variables.

Si un cliente se suscribe a tu chatbot antes de que se añadan las variables de su teléfono, email, ciudad, y nombre, sus datos no se guardarán en tu cuenta de SendPulse.

Puedes mostrar automáticamente los nombres de los suscriptores en las conversaciones, pasándolos desde tu chat en vivo. Para ello, utiliza el parámetro window.oSpP.full_name en tu script:

<script> window.oSpP = { full_name: "Anabelle Cane", city: "London" } </script>

Los contactos aparecerán inmediatamente con los nombres especificados en Conversaciones y Audiencia.

Si recopilas variables adicionales de suscriptores de notificaciones push web usando window.oSpP, esto podría interferir con el widget de recopilación de variables de tu chatbot y provocar un mal funcionamiento. Para evitarlo, utiliza un método alternativo.

Método 2. Uso de campos de entrada ocultos

Este método es aplicable a los widgets de suscripción.

Añade campos adicionales con la clase sp_push_custom_data a tu sitio web:

<input type="hidden" name="email" class="sp_push_custom_data " value="username@example.com">
<input type="hidden" name="phone" class="sp_push_custom_data " value="+123123123">
<input type="hidden" name="name" class="sp_push_custom_data " value="Annabel">
<input type="hidden" name="city" class="sp_push_custom_data " value="London">

Ambos métodos son aplicables a sitios web que funcionan con cualquier CMS.

Suscripción a través de un enlace

También puedes pasar variables durante una suscripción si las añades al enlace de tu chatbot utilizando los delimitadores que se indican a continuación. Todos los parámetros de los ejemplos son opcionales.

Este método ayuda a pasar etiquetas UTM, direcciones de correo electrónico, números de teléfono o cualquier otra variable personalizada. Cuando un usuario hace clic en el enlace e inicia una conversación, los valores de las variables se guardarán automáticamente en el perfil de ese suscriptor en la Audiencia de tu chatbot.

Puedes copiar una muestra de enlace para cada aplicación de mensajería. Más información: Inicia un bot a través de un enlace o un código QR.

En los enlaces de chatbot de Telegram, agrega el dominio intermedio tg.pulse.is ya que Telegram limita el formato y la longitud de los datos transferidos. Tu enlace tendrá este aspecto:

https://tg.pulse.is/{bot_name}?start={flow_id}&var1_name=value1&var2_name=value2&utm_campaign=summer_sale&utm_medium=banner

Aquí, {bot_name} es el nombre de tu chatbot de Telegram,{flow_id} es el ID del flujo que se activará, var_name es un nombre de variable de la Audiencia de tu chatbot, value es el valor que se pasará, y utm_campaign y utm_medium son parámetros UTM opcionales.

Los enlaces del chatbot de WhatsApp incluyen un dominio intermedio,  wa.pulse.is. Tu flujo solo se iniciará cuando un usuario envíe un mensaje preestablecido, como “Start” o cualquier otro mensaje que puedas personalizar. Tu enlace tendrá este aspecto:

https://wa.pulse.is/{bot_owner_phone_number}?start={chain_id}&text=Start&var1_name=value1&var2_name=value2&utm_campaign=summer_sale&utm_medium=banner

El parámetro text= es obligatorio. Tu enlace no funcionará sin él.

Un enlace de chatbot de Facebook que pasa variables adicionales tendrá este aspecto:

https://m.me/{page_id}?ref={flow_id}__var1_name=value1__var2_name=value2__utm_campaign=summer_sale__utm_medium=banner

Un enlace de chatbot de Instagram que pasa variables adicionales tendrá este aspecto:

https://ig.me/{bot_name}?ref={flow_id}__var1_name=value1__var2_name=value2__utm_campaign=summer_sale__utm_medium=banner

Los enlaces del chatbot de Viber solo funcionan en dispositivos que tengan instalada la aplicación. Tu enlace tendrá este aspecto:

viber://pa?chatURI={bot_name}&context={flow_id}|var1_name=value1|var2_name=value2|utm_source=summer_sale|utm_medium=banner

Suscripción a través de un formulario web

Redirige a los usuarios a tu chatbot una vez que rellenen el formulario en tu sitio web impulsado por SendPulse y envía los datos a tu audiencia de chatbot.

Ve a tu chatbot, haz clic en los tres puntos y copia el enlace de tu flujo. Utiliza este enlace en la configuración de tu formulario.

Última actualización: 04.07.2025