Salebot.pro
Search
⌃K

Объединение контактов разных мессенджеров

функционал позволит сменить канал общения с клиентом, избегая ограничения в 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 - идентификатор бота, можно посмотреть в списке подключенных ботов. Не обязательный параметр
Мессенджеры и чаты
Обратите внимание, если к проекту подключено более одного бота в одном мессенджере и не передан параметр 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()
Внимание! Переменная text_to_merge_contact удаляется при новой генерации ссылки на объединение или перезаписывается, если генерация ссылки производится для инстаграм или whatsapp.

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

unmerge_client() - функция позволяет отвязать текущий контакт клиента от других чатов. Используется без параметров.

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

После успешного объединения контактов в карточке клиента вы увидите раздел Связанные диалоги:
После успешного перехода в новый мессенджер клиенту в старый придет колбек switch_to_ с припиской
Колбэк switch_to_(мессенджер,в который перешел клиент) приходит в диалог с ботом, в котором была ВЫДАНА ссылка для перехода в новый мессенджер)
Например: switch_to_telegram, если клиент перешел в телеграм