Как передавать пользовательские переменные при подписке на чат-бота
Интеграция 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
Регистрация через соцсети
Войти через Facebook Войти через Google