Формат ссылок для запуска ботов и передача входных параметров (Deeplink)

Последние изменения: 10.02.2020

В зависимости от канала необходимо использовать свой формат ссылок для старта бота. Часть каналов позволяют передать параметры при старте бота. Такие параметры могут использоваться в боте для определения алгоритма работы с клиентами или для сбора статистики по источникам переходов в бот.

Способ передачи зависит от конкретного канала:

Канал	Описание
Apple	Для Apple Business Chat доступны параметры biz-intent-id - позволяет передать суть/намерение запроса biz-group-id - позволяет уточнить подразделение, которому направлен запрос. Необходимо, так как бизнес чат может быть только один для компании body - текст для подстановки в текст начального сообщения Смотри документацию Apple
Telegram	Используется параметр start. Смотри https://core.telegram.org/bots#deep-linking Пример: https://telegram.me/<Имя_бота>?start=<параметры>
Facebook	Используется параметр ref. Смотри https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links/ Например: http://m.me/<PAGE_NAME>?ref=<REF_PARAM>
Viber	Используется параметр Context. Смотри http://developers.viber.com/docs/tools/deep-links/ Например: viber://pa?chatURI=<URI>&context=<YourContext>&text=<YourText>
ВКонтакте	Используется параметр ref. Дополнительно доступен параметр ref_source, который может использоваться вместе с ref Смотри https://vk.com/dev/bizmessages_doc?f=2.6. Передача произвольного параметра с помощью ссылки vk.me. Например: https://vk.me/<group_name>?ref=<параметры>&ref_source=<источник>
WhatsApp	Прямой поддержки входных параметров и автоматического старта диалога нет, но возможна передача номера для выбора контакта и подстановка текста первого сообщения. Смотри https://faq.whatsapp.com/en/iphone/23559013 Например: https://api.whatsapp.com/send?phone=<Номер>&text=<Текст>

Помогла ли вам статья?