Перевод клиента в другой мессенджер
функционал позволит сменить канал общения с клиентом, избегая ограничения в 24 часа
Объединение контактов
Внимание! Для создания ссылок для перехода из одного мессенджера в другой к проекту должен быть подключен бот в нужном мессенджере.
get_merge_link(client_type, tag, group)
Функция возвращает ссылку, которая, при переходе по ней, перенаправит пользователя в указанный бот
Параметры:
client_type | тип клиента число, обязательный параметр, указывает на какой мессенджер будет совершен переход | (доступны следующие значения 0: 'vkontakte', 1: 'telegram', 2: 'viber', 3: 'facebook', 6: 'whatsapp', 8: 'odnoklassniki', 10: 'instagram') |
tag | сообщение, которое придет в чат с клиентом после перехода (для ТГ) или запишется в переменную tag (для ВК) (так же как в минилендингах) - необязательный параметр | |
group | идентификатор бота, можно посмотреть в списке подключенных ботов. Не обязательный параметр |
merge_client(main_client_id, client_id) - свяжет текущего клиента с клиентом с идентификатор которого указан в переменной main_client_id, если передан второй параметр, то свяжет клиента client_id с main_client_id.
Параметры функции:
main_client_id | идентификатор клиента, который будут основным в связке |
client_id | идентификатор клиента, которого нужно связать с клиентом указанным в первом параметре. Необязательный, если не передан, то будет связан текущий клиент |
Обратите внимание, если к проекту подключено более одного бота в одном мессенджере и не передан параметр group, то ссылка будет сформирована на первый найденный бот из подключенных.
Функция возвращает ссылку вида https://salebot.pro/mlink/000
Пример для формирования ссылки для перехода в телеграм link = get_merge_link('1') - ссылка на первого найденного в проекте бота телеграм, без тега link = get_merge_link('1', '', 'testovbot') - ссылка на конкретного бота без тега link = get_merge_link('1', 'сменил чат', 'testovbot') - ссылка на конкретного бота с тегом
Важные примечания
Для ссылок на инстаграм*! Если вы генерируете ссылку на инстаграм*, тогда в переменные добавится переменная text_to_merge_contact со значением вида cli123 (уникальное для каждого объединения) После перехода в инстаграм* нужно попросить пользователя отправить этот текст в директ.
Для ссылок на Whatsapp! После перехода по ссылке для объединения контактов, ведущей на whatsapp, в поле ввода пользователю автоматически подставится текст вида cli123 (уникальное для каждого объединения). Пользователь должен его отправить в чат, иначе объединение не произойдет. Дополнительно, при генерации ссылки на whatsapp, добавится переменная text_to_merge_contact с тем же значением. Рекомендуется уведомить пользователя о необходимости после перехода отправить этот текст в чат.
Для ссылок на ВКонтакте! После перехода в диалог сообщества ВК по ссылке для объединения контактов необходимо, чтобы пользователь написал сообщение или нажал кнопку Начать. После этого у пользователям появится системная переменная tag (тег), если был параметр передан tag в функции get_merge_link()
Для ссылок на Telegram! После перехода по ссылке в Telegram пользователь должен запустить бота кликом по кнопке Запустить(Начать/Старт в зависимости от устройства). В диалог с ботом придет значение параметра tag, указанного в функции get_merge_link()
*Принадлежит компании Meta, признанной экстремисткой и запрещенной на территории России
Внимание! Переменная text_to_merge_contact удаляется при новой генерации ссылки на объединение или перезаписывается, если генерация ссылки производится для инстаграм или whatsapp.
Удаление связи между контактами клиента разных мессенджеров
unmerge_client(client_id) - отвяжет текущего клиента от привязанного. Если есть или если передан параметр в функции, то отвяжет клиента с идентификатором client_id от того, к которому привязан client_id - идентификатор клиента salebot. Функция может работать, как без параметра так и с ним. Если указать ее в калькуляторе так: unmerge_client() - то удалена будет связь текущего клиента от того, к которому была ранее создана. В случае если параметр передан, то удалена будет связь с клиентом идентификатор которого передан в функцию. Рекомендуем использовать функции, если уверенны в ее необходимости и понимаете, как она работает.
Колбеки после успешного объединения контактов
После успешного объединения контактов в карточке клиента вы увидите раздел Связанные диалоги:
После успешного перехода в новый мессенджер клиенту в старый придет колбек switch_to_ с припиской
Колбэк switch_to_(мессенджер,в который перешел клиент) приходит в диалог с ботом, в котором была ВЫДАНА ссылка для перехода в новый мессенджер)
Например: switch_to_telegram, если клиент перешел в телеграм
Передать переменные клиента при переходе в другой мессенджер
При переходе в другой мессенджер может потребоваться передача переменных клиента, чтобы продолжить с ним диалог.
Самый простой способ передать значение переменной - прикрепить к ссылке параметры.
Важно! Если передать название переменной, которое уже есть в диалоге в другом мессенджере, то значение замениться на то, что указано в ссылке
Придумайте название переменной, которая будет создана у клиента при переходе по ссылке.
Для примера, если переводите в Telegram из Whatsapp можно назвать переменную id_wa и передать в ней client_id из диалога с Whatsapp - ботом и передать номер телефона в переменной phone_wa. Названия переменных могут быть ЛЮБЫЕ понятные вам.
Как передать параметр с ссылкой:
В диалоге Whatsapp ссылка выглядит следующим образом:
В диалог основного клиента (там, где выдана ссылка для перехода) при запуске бота в другом мессенджере придет колбэк, а в диалоге в новом мессенджере у клиента будут записаны переменные с теми значениями, что были указаны в ссылке:
Передать таким способом параметры можно только при первой связке двух контактов. Далее используйте переменную main_client_id или функцию для присвоения переменных.
Last updated
