Deeplink
Deeplink (или Диплинк) нужен для передачи параметров в ссылке. Можно отслеживать источник перехода в бота или задавать параметры для перешедших по ссылке пользователей. Другими словами Диплинк — это UTM-метка для чат-бота.
Работает в Telegram, Viber, ТамТам, ВКонтакте и ФБ*.
Чтобы создать Deeplink, перейдите в Настройки ➝ События и нажмите кнопку Добавить событие. Введите Имя события и выберите Тип — Deeplink.
Чтобы удалить cобытие, нажмите на кнопку Удалить.
Deeplink с текстом
Используется для создания ссылки, которая ведет на определенный экран. Например, вы сгенерировали Диплинк vasya, чтобы считать клиентов, которые привел ваш партнер Василий. Для этого вы отправите всех пользователей на экран, записывающий визит.
- Добавьте и назовите Deeplink.
- В Свойствах укажите Тип — Текст и его Значение — текст латиницей (параметр), который будет указан в ссылке и который запишется в переменную deeplink.
- В Действии укажите Тип — выбираем, будет пользователю присылаться какой-либо Экран или Текст.
- В Ссылках скопируйте нужные вам ссылки с добавленным в них значением.
Параметр ссылки диплинка с типом Текст хранится в переменной lastUpdate.parsed.deeplink
Deeplink с регулярным выражением
Используется для создания ссылки, которая ведет на определенный экран. Можно использовать для отслеживания перехода пользователя из разных рекламных кампаний по параметру в конце ссылки.
- Добавьте и назовите Deeplink.
- В Свойствах укажите Тип — Регулярное выражение и его Значение — необходимое регулярное выражение. Укажите Имя переменной — произвольную переменную, в которую запишется параметр ссылки и Тип переменной — Массив или Строка. При необходимости задаем флаги регулярных выражений.
- В Действии укажите Тип — выбираем, будет пользователю присылаться какой-либо Экран или Текст после перехода по ссылке.
- Нажмите кнопку сохранения, чтобы сформировалась ссылка. В Ссылках ее нужно скопировать и после знака = в конце ссылки дописать подходящее под регулярное выражение значение, которое будет записано в переменную.
Пользователю, который перейдет по такой ссылке сразу будет присвоена переменная с определенным значением в ней. Компоненты конструктора (Развилка, Алерт и т.д.) могут сразу же работать с этой переменной. Переданный в бота параметр отображается в переменных пользователя (раздел «Пользователи»).
Имя переменной, в которую записывается параметр Диплинка можно выводить в названии Ярлыка.
Тогда все пользователи по ссылке Диплинка могут приходить на один экран и каждый получит свой ярлык, который будет такой же как параметр ссылки.
Например, если у пользователя параметр Диплинка записывается в переменную trigger, то при создании ярлыка на экране входа нужно вписать в поле имя ярлыка {{trigger}}
Регулярное выражение .* будет пропускать любое значение (текст латиницей и цифры). Если использовать это регулярное выражение, то больше одного Диплинка создать не получится. Если вам нужно несколько Диплинков, создайте уникальное регулярное выражение для каждого события.
Deeplink в Viber
Из-за особенностей платформы Viber (бот запускается только после реакции пользователя), после перехода по ссылке Диплинка пользователю нужно написать боту, после чего он получит экран повторно. Чтобы этого избежать, нужно отдельно для Viber сделать другое событие Диплинк, которое направит на специально созданный для Viber экран. На этом экране нужно разместить кнопку «Начать» с переходом на нужный экран.
Deeplink для нестандартных ситуаций
Иногда по Диплинку нужно получить, например, email пользователя, но ограничения URL-адреса не позволяют нам этого сделать. Тогда на помощь приходит Base64.
В целом работа c Диплинком абсолютно никак не изменяется. Все, что вам нужно после получения Диплинк-ссылки — это подставить в конец base64-.
Рассмотрим на примере.
1. Для начала создадим экран в конструкторе, который будет приходить, когда сработает Диплинк.
2. Создадим и настроим событие Диплинк.
3. Скопируем получившийся Диплинк в поисковую строку браузера и к полученной ссылке допишем base64-, чтобы указать боту, что данные передаются в формате base64.
4. Закодируем нужные данные. Можно воспользоваться сторонним сервисом, например https://www.base64encode.org
5. Полученную строку формата base64 подставляем в конец Диплинка (после base64-).
6. Перейдем по созданной нами ссылке, чтобы протестировать полученный Диплинк.
После перехода по ссылке мы получили base64, расшифровали его и записали итоговое значение.
В переменных пользователя также можно будет увидеть расшифрованный email, который записался в соответствующую переменную, после того, как Диплинк сработал.
Конечная ссылка не должна превышать 64 символа — Telegram и другие платформы могут отказаться работать с большими ссылками. Используйте латиницу и спецсимволы. С другими языками base64 может закодировать текст с невалидными символами для URL, и тогда ссылка не будет работать.
*Продукты Meta признаны экстремистскими и запрещены в РФ.