Як передавати користувацькі змінні при підписці на чат-бота

Інтеграція SendPulse з месенджерами дозволяє передавати власні змінні в обліковий запис SendPulse під час підписки через віджет на сайті або по переходу у бота за посиланням. Використовуйте цю функцію, щоб автоматично оновлювати значення для наявних змінних в Аудиторії чат-бота.

Ви також можете передавати UTM-мітки під час підписки. Значення позначок для кожного підписника зберігаються у відповідній змінній в Аудиторії чат-бота.

При підписці через онлайн-чат або віджет на сайті

JS скрипт онлайн-чата та віджета підписки може автоматично визначати та зберігати UTM-мітки.

Якщо користувач переходить на ваш сайт за посиланням із UTM-мітками, де параметри розділені ? та &, — ці мітки автоматично збережуться в профілі користувача після підписки.

Якщо ви хочете передати інші мітки або додаткові змінні, ви можете використовувати один з двох способів нижче.

Спосіб 1. Через скрипт window.oSpP

Після підключення онлайн-чату чи віджета підписки, можна скрипт для автоматичної передачі змінних під час підписки. Приклад коду:

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

Наприклад, якщо на сайт надходять дані відвідувача, а він підписується на чат-бота, підключеного до сайту, ці дані (ім’я, місто, email, телефон) автоматично передаються у відповідні змінні чат-бота під час підписки.

Якщо користувачі підписалися на бот через віджет чи онлайн-чат, а потім для цих користувачів з'явилися змінні {{phone}}, {{email}}, {{city}} та {{name}} їх дані не будуть передані до облікового запису SendPulse.

Щоб передати ім’я підписника онлайн-чату до SendPulse, аби це ім’я автоматично було показано у діалогах. Для цього вкажіть параметр window.oSpP.full_name при використанні, наприклад, такого коду:

<script> window.oSpP = { full_name: "Olga Petrenko", city: "Odesa" } </script>

Із заданим імʼям контакт буде одразу показуватися в розділах Діалоги та Аудиторія.

Якщо ви підключали додатковий збір змінних для підписників web push повідомлень за допомогою window.oSpP, віджет для збору додаткових змінних для чат-бота може не спрацювати, оскільки будуть конфлікти. Використовуйте другий спосіб.

Спосіб 2. Через приховані поля введення

Спосіб дійсний для віджета підписки.

Додайте на сайт додаткові поля input із класом sp_push_custom_data:

<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="Olga">
<input type="hidden" name="city" class="sp_push_custom_data" value="Odessa">

Обидва способи універсальні для сайтів на будь-яких CMS.

При підписці з переходу за посиланням

Ви також можете передавати змінні під час підписки на бота, вставляючи в посилання на бота змінні через розділювачі, які наведені нижче. Усі параметри у прикладах опціональні.

За допомогою такого механізму можна передавати utm-мітки, email, телефон чи інші змінні. При переході за посиланням та стартом діалогу значення змінних записуються для конкретного підписника в аудиторії чат-бота.

Ви можете скопіювати приклад посилання у самому сервісі. Читайте докладніше: Запуск бота за посиланням або QR-кодом.

Наприклад, для посилання Telegram чат-бота додатково необхідно додати проміжний домен tg.pulse.is, оскільки Telegram має обмеження за форматом і розміром даних, що передаються. Посилання буде мати такий вигляд:

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

Де bot_name – назва бота, flow_id – ID ланцюжка, var_name – назва змінної, яка наявна в аудиторії бота, а value – значення, яке потрібно передавати, utm_campaign= та utm_medium= – параметри міток.

Для посилання WhatsApp чат-бота, щоб передати потрібні змінні, додається проміжний домен wa.pulse.is та запуск ланцюжка спрацює лише для контактів, які надішлють попередньо встановлений текст (за замовчуванням це "Start", або інший, зазначений вами). Посилання буде мати такий вигляд:

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

Параметр text= є обовʼязковим — без нього посилання не спрацює.

Посилання для Facebook чат-бота з передачею додаткових змінних буде мати такий вигляд:

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

Для Instagram чат-бота з передачею додаткових змінних буде мати такий вигляд:

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

Для Viber чат-бота посилання спрацює тільки на пристрої, де встановлено застосунок, і матиме такий вигляд:

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

При відправці форми на сайті

Перенаправляйте користувача в бот після заповнення форми на сайті, створеному за допомогою конструктора SendPulse, та надсилайте дані в аудиторію чат-бота.

Перейдіть у чат-бот, натисніть на три крапки та скопіюйте посилання на ланцюжок — саме це посилання треба вказати як URL-адресу в налаштуванні форми.

Оновлено: 07.08.2025