Интеграция с MAX Bot¶

Интеграция с MAX Bot позволяет автоматически создавать сделку в CRM, когда клиент впервые пишет вашему боту в MAX. Это помогает не терять обращения и сохранять номер визита Roistat (roistat_visit) для дальнейшей аналитики.

Возможности интеграции¶

• Автоматическое создание сделки в CRM при первом входящем сообщении в MAX Bot
• Передача номера визита Roistat в поле roistat, если клиент перешел по ссылке вида https://max.ru/<botName>?start={roistat_visit}
• Добавление последующих сообщений в комментарий уже существующей сделки
• Идентификация клиента по телефону, если номер передан
• Идентификация по username, если телефона нет
• Идентификация по user_id, если отсутствуют телефон и username
• Передача в CRM данных клиента: username, user_id, ссылка на чат, текст первого сообщения
• Автоматическая генерация псевдо-номера телефона, если реальный номер недоступен

Как работает интеграция¶

1. Клиент переходит в MAX Bot по ссылке https://max.ru/<botName>?start={roistat_visit} или пишет боту напрямую.
2. При первом входящем сообщении Roistat проверяет, есть ли клиент и активная сделка в CRM.
3. Если подходящей сделки нет, Roistat создает новую сделку в воронке, указанной в настройках CRM-интеграции.
4. Если в первом сообщении передан параметр start={roistat_visit}, значение записывается в поле roistat в CRM.
5. Все последующие сообщения по этому диалогу добавляются в комментарий к уже созданной сделке.

Идентификация клиента¶

При первом сообщении клиент определяется в таком порядке:

1. По номеру телефона
2. По username
3. По user_id

Если клиент уже найден, новая сделка не создается: новые сообщения добавляются в комментарий существующей сделки.

Формирование псевдо-номера номера¶

Если MAX не передал номер телефона клиента, система создает псевдо-номер номер в корректном формате российского номера. Так формируется стабильный номер, который можно использовать для создания сделки в CRM, если реальный номер телефона недоступен:

+7(940)xxx-xx-xx

Какие данные передаются в CRM¶

При создании сделки из первого сообщения в MAX Bot в CRM передаются:

Настройка интеграции¶

В проекте Roistat откройте раздел Интеграции, нажмите Добавить интеграцию, найдите MAX Bot и откройте настройки интеграции.

Шаг 1. Авторизация MAX Bot¶

На первом шаге укажите параметры подключения:

• Токен бота — токен, полученный на платформе MAX в разделе Чат-боты -> Интеграция -> Получить токен
• Ник бота — публичное имя бота без дополнительных параметров, например id123456_bot
• Текст сообщения — приветственное сообщение, которое бот отправит при первом запуске. Поле можно оставить пустым.

По умолчанию можно использовать текст:

Здравствуйте! Напишите ваш вопрос, мы скоро ответим

Нажмите Сохранить.

Если токен указан неверно, появится ошибка: Неверный токен. Пожалуйста, проверьте и попробуйте снова.

Шаг 2. Установка кода на сайт¶

Этот шаг нужен, чтобы Roistat автоматически подставлял номер визита в ссылки на MAX Bot и мог записать roistat_visit в CRM при первом сообщении.

1. Скопируйте скрипт из шага Установка кода на сайт.
2. Вставьте его на сайт сразу после кода счетчика Roistat.
3. Убедитесь, что на сайте используются ссылки, которые начинаются с https://max.ru/ и содержат ник вашего бота.

Пример ссылки на сайте:

<a href="https://max.ru/id123456_bot">Напишите нам в MAX</a>

Скрипт:

• находит ссылки по селектору querySelectorAll('[href*="max.ru/"]')
• отбирает ссылки на того бота, имя которого указано на шаге 1
• заменяет их на формат https://max.ru/<botName>?start={roistat_visit}

Это позволяет передать номер визита в параметр start при первом переходе клиента в MAX.

Шаг 3. Настройки поведения¶

На шаге Настройки поведения можно включить автоматическую отправку заявок в CRM и при необходимости настроить дополнительные сценарии обработки.

Если включена опция Отправлять заявки в CRM, то:

• при первом сообщении создается сделка в CRM
• сделка создается в статусе и воронке, которые заданы в подключенной CRM-интеграции
• последующие сообщения в этом диалоге не создают новые сделки

На этом же шаге можно:

• задать сценарии отправки заявок по условиям
• настроить отправку целей в подключенные системы аналитики

Если дополнительные сценарии не нужны, оставьте стандартные настройки и нажмите Сохранить.

Шаг 4. Настройка доп. полей¶

На шаге Настройка доп. полей можно задать шаблоны для названия сделки, комментария и сопоставить значения с полями CRM.

Для MAX Bot доступны системные переменные:

Используйте эти переменные, если нужно:

• сформировать название сделки по шаблону
• заполнить комментарий сделки
• передать значения в дополнительные поля CRM

После настройки нажмите Сохранить.

Проверка работы¶

1. Разместите на сайте ссылку на MAX Bot в формате https://max.ru/<botName>.
2. Перейдите по этой ссылке как новый пользователь.
3. Отправьте первое сообщение в бот.
4. Проверьте, что в CRM появилась новая сделка.
5. Убедитесь, что в сделке заполнены канал, ссылка на чат, данные клиента и комментарий с первым сообщением.
6. Если переход был с сайта, проверьте, что поле roistat заполнено номером визита.
7. Отправьте еще одно сообщение и убедитесь, что оно добавилось в комментарий той же сделки, а новая сделка не создалась.

Пример созданной сделки:

Частые вопросы¶

Связанные статьи¶

• Интеграция с Telegram Bot
• Интеграция с WhatsApp