Как передавать пользовательские переменные при подписке на чат-бота

Интеграция SendPulse с мессенджерами позволяет передавать пользовательские переменные в аккаунт SendPulse при подписке через виджет или по переходу по ссылке. С помощью этого функционала вы можете передавать значения для существующих переменных в «Аудитории» чат-бота.

Обратите внимание, что для передачи переменных вам нужно предварительно их создать в аудитории чат-бота. Отправка данных на несуществующие поля будет игнорироваться

Передача переменных при подписке на чат-бота с помощью виджета или по ссылке работает на данный момент только для Facebook, Telegram и ВКонтакте чат-ботов. При подписке на Instagram и WhatsApp чат-бота вы не можете передавать пользовательские переменные, так как социальные сети не поддерживают эту возможность.

При подписке через виджет

Вы можете настроить передачу переменных с вашего сайта, где установили виджет подписки, двумя способами.

Способ 1

После добавления кода виджета подписки чат-бота, добавьте на сайт код вида:

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

Если пользователи подписались на чат-бота, а потом для этих пользователей появились переменные {{phone}}, {{email}}, {{city}} и {{name}} их данные не будут переданы в аккаунт SendPulse.

Обратите внимание: если вы подключали дополнительный сбор переменных для подписчиков 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.

При подписке по переходу по ссылке

Вы также можете передавать переменные при подписке на бота, вставляя в ссылку на бота переменные через параметр ?ref (для Facebook и ВКонтакте) или ?start (для Telegram), разделяя переменные знаком |.

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

К примеру, ссылка для Facebook чат-бота будет будет иметь следующий вид:

https://m.me/{page_id}?ref={flow_id}|var1_name=value1|var2_name=value2

Где flow_id — ID цепочки, var_name — название переменной, а value — значение, которое нужно передавать. Все приведенные параметры в примере опциональны.

Для ссылки Telegram чат-бота дополнительно необходимо добавить промежуточный домен «tg.pulse.is», так как Telegram имеет ограничение по формату и размеру передаваемых данных. Ссылка будет иметь следующий вид:

https://tg.pulse.is/{bot_name}?start={flow_id}|var1_name=value1|var2_name=value2

Обновлено: 21.03.2022