Перевод клиента в другой мессенджер

Объединение контактов

get_merge_link(client_type, tag, group)

Функция возвращает ссылку, которая, при переходе по ней, перенаправит пользователя в указанный бот

Параметры:

merge_client(main_client_id, client_id) - свяжет текущего клиента с клиентом с идентификатор которого указан в переменной main_client_id, если передан второй параметр, то свяжет клиента client_id с main_client_id.

Параметры функции:

Функция возвращает ссылку вида 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()

Удаление связи между контактами клиента разных мессенджеров

unmerge_client(client_id) - отвяжет текущего клиента от привязанного. Если есть или если передан параметр в функции, то отвяжет клиента с идентификатором client_id от того, к которому привязан client_id - идентификатор клиента salebot. Функция может работать, как без параметра так и с ним. Если указать ее в калькуляторе так: unmerge_client() - то удалена будет связь текущего клиента от того, к которому была ранее создана. В случае если параметр передан, то удалена будет связь с клиентом идентификатор которого передан в функцию. Рекомендуем использовать функции, если уверенны в ее необходимости и понимаете, как она работает.

Колбеки после успешного объединения контактов

После успешного объединения контактов в карточке клиента вы увидите раздел Связанные диалоги:

После успешного перехода в новый мессенджер клиенту в старый придет колбек switch_to_ с припиской

Например: switch_to_telegram, если клиент перешел в телеграм

Передать переменные клиента при переходе в другой мессенджер

При переходе в другой мессенджер может потребоваться передача переменных клиента, чтобы продолжить с ним диалог.

Самый простой способ передать значение переменной - прикрепить к ссылке параметры.

Придумайте название переменной, которая будет создана у клиента при переходе по ссылке.

Для примера, если переводите в Telegram из Whatsapp можно назвать переменную id_wa и передать в ней client_id из диалога с Whatsapp - ботом и передать номер телефона в переменной phone_wa. Названия переменных могут быть ЛЮБЫЕ понятные вам.

Как передать параметр с ссылкой:

В диалоге Whatsapp ссылка выглядит следующим образом:

В диалог основного клиента (там, где выдана ссылка для перехода) при запуске бота в другом мессенджере придет колбэк, а в диалоге в новом мессенджере у клиента будут записаны переменные с теми значениями, что были указаны в ссылке: