Одним из наиболее эффективных способов привлечь клиентов в мессенджеры и социальные сети является использование ссылок-приглашений.
Для удобства клиентов используйте сервисы для сокращения ссылок.
Для отправки сообщений по API можно добавить уникальную информацию о клиенте в конце пригласительной ссылки. Эта информация будет передана роботу с помощью специального ключевого слова.
Пример пригласительной ссылки в Telegram-бота: https://t.me/Test_Rassilki_Bot. В этой ссылке нет персонализации, поэтому мы не сможем отличить одного клиента от другого. Однако если добавить к ней уникальное для каждого клиента ключевое слово, то робот сможет идентифицировать пользователя и предоставить ему персонализированный контент.
Ссылка может выглядеть так: https://t.me/Test_Rassilki_Bot?start=79133912047. При переходе по этой ссылке бот сможет принять информацию и идентифицировать пользователя. Вы можете нажимать на эти ссылки и своими глазами увидеть реакцию робота. Также вы можете попробовать изменить информацию в ссылке — робот выведет ее вам.
Добавление ключевых слов и уникальной информации о клиенте в ссылку позволяет чат-боту автоматически распознавать пользователя и получать о нем необходимые данные без дополнительных вопросов.
Для каждого мессенджера и социальной сети используется свое уникальное ключевое слово:
Эти ключевые слова добавляются в конце ссылки. Вы можете передавать цифры и латинские буквы; кириллица не будет работать.
Для работы с информацией, переданной из ссылки, используйте переменную clientExternalId — именно в нее будет записываться информация после ключевого слова ссылки. Эта переменная используется для всех соцсетей и мессенджеров, вне зависимости от того, пришел ли клиент по ссылке в Telegram или, например, Facebook*.
Система автоматически заполнит эту переменную значением из ссылки. Любую переменную, включая clientExternalId, вы можете вывести в отчет или использовать в блоках Условие и Запрос к серверу.
В ссылке можно передать идентификатор клиента. Если нужно много информации о клиенте, например, товар, который он заказал, его цена и количество, поможет блок Запрос к серверу и интеграцией с CRM:
clientExternalId.Используйте ссылку-приглашение для передачи значений внешнего ID клиента, телефона, email и переменных сценария бота. Для этого выполните следующие действия:
Сформируйте json. Для формирования запроса используйте следующие сокращения:
p — phone.e — email.eId — externalId.v — variables.Закодируйте json в Base64URL. Подробнее о кодировании в Base64URL читайте в статье Кодирование и декодирование.
Максимальная длина получившейся строки, закодированной в Base64URL, — 64 символа. При превышении лимита данные переданы не будут.
Вставьте закодированный json в ссылку на бота. Ссылка будет выглядеть так: https://t.me/<Имя_бота>?start=<Base64URL-кодированный JSON>, где:
<ИМЯ_БОТА> — username вашего Telegram-бота (например: MyCoolBot).start — параметр, содержащий Base64URL-кодированный JSON (например: eyJlIjoiZW1haWxAZ21haWwuY29tIn0).Значение переменной будет автоматически передано в сценарий.
Примеры передачи значений:
Чтобы передать значение email@gmail.com в переменную email, выполните следующие действия:
{"e":"email@gmail.com"}.eyJlIjoiZW1haWxAZ21haWwuY29tIn0.https://t.me/ИМЯ_БОТА?start=eyJlIjoiZW1haWxAZ21haWwuY29tIn0.Чтобы передать значение 79000000000 в переменную phone, выполните следующие действия:
{"p":"79000000000"}.eyJwIjoiNzkwMDAwMDAwMDAifQ.https://t.me/ИМЯ_БОТА?start=eyJwIjoiNzkwMDAwMDAwMDAifQ.Чтобы передать значение externalId в externalId, выполните следующие действия:
{"eId":"externalId"}.eyJlSWQiOiJleHRlcm5hbElkIn0.https://t.me/ИМЯ_БОТА?start=eyJlSWQiOiJleHRlcm5hbElkIn0.Чтобы передать значение Москва в переменную city, выполните следующие действия:
{"v":{"city":"Москва"}}.eyJ2Ijp7ImNpdHkiOiLQnNC-0YHQutCy0LAifX0.https://t.me/ИМЯ_БОТА?start=eyJ2Ijp7ImNpdHkiOiLQnNC-0YHQutCy0LAifX0.Чтобы не превысить максимальную длину в 64 символа получившейся строки в base64URL, используйте следующие советы:
{"v": {"stage_name": "1. Первый этап"}} используйте {"v": {"stage": "1"}}.firstName: Ivan, lastName: Ivanov, age: 23, используйте cl_data: Ivan Ivanov 23, а в сценарии разделите на 3 переменных через BPL.*Деятельность организации Meta Platforms Inc. и ее продуктов Instagram и Facebook запрещена в Российской Федерации.