Пользовательская инструкция по подключению Max-бота в CRM 4DEV

1. Что позволяет интеграция

После подключения Max-бота сотрудник может получать в личном чате уведомления из CRM 4DEV, например о создании сделки.

В текущей реализации уведомления отправляются через одного активного Max-бота, аналогично Telegram. Если необходимо использовать отдельных ботов для разных городов или подразделений, потребуется дополнительная доработка.

2. Что потребуется

Перед началом настройки подготовьте:

• учётную запись в Max;
• созданного Max-бота;
• токен бота;
• внешний HTTPS-адрес опубликованной информационной базы CRM 4DEV;
• права на настройку интеграций и персональных уведомлений.

Токен является секретным. Не отправляйте его в открытых чатах и не прикладывайте к скриншотам или задачам.

3. Создание бота в Max

1. Откройте приложение Max.
2. Найдите бота @MasterBot.
3. Отправьте команду /newbot.
4. Укажите название создаваемого бота.
5. Укажите уникальное имя бота.
6. Сохраните полученный токен.

Если бот уже создан и токен имеется, переходите к следующему разделу.

4. Подключение бота в CRM

1. Откройте CRM 4DEV.
2. Перейдите в Персональные настройки CRM.
3. Откройте вкладку Бот оповещений.
4. В разделе подключения Max вставьте токен бота.
5. Нажмите Сохранить и подключить.
6. Убедитесь, что CRM сформировала адрес webhook без ошибки.

После успешной настройки должна появиться информация о подключённом Max-боте.

5. Привязка пользователя к боту

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

1. В персональных настройках нажмите Подключить Max-бот.
2. CRM покажет ссылку на бота, QR-код и код привязки.
3. Откройте бота по ссылке или отсканируйте QR-код.
4. Нажмите Старт в чате с ботом.
5. Дождитесь сообщения об успешном подключении.
6. Вернитесь в CRM и убедитесь, что отображается состояние «Подключено».

Код привязки действует ограниченное время. Если срок истёк, сформируйте новый код.

6. Проверка ID пользователя

В списке ID пользователей для оповещений должна появиться запись:

• пользователь: нужный сотрудник CRM;
• тип мессенджера: Max;
• ID: идентификатор пользователя Max.

ID должен храниться строкой без пробелов и разделителей.

• Правильно: 323047640
• Неправильно: 323 047 640

Если ID содержит пробелы, удалите их и сохраните запись.

7. Включение уведомлений

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

1. Откройте Настройки оповещений.
2. Выберите нужное оповещение, например «Создание сделки».
3. Убедитесь, что оповещение активно.
4. Включите флаг «Оповещать через бота Max».
5. Выберите или проверьте шаблон сообщения.
6. Убедитесь, что сотрудник, подключённый к Max, является получателем этого оповещения.
7. Сохраните настройки.

8. Проверка отправки

1. Создайте тестовую сделку.
2. Заполните данные, необходимые для выбранного вида оповещения.
3. Запишите сделку.
4. Проверьте личный чат с Max-ботом.

Ожидаемый результат: в чат приходит одно сообщение с данными созданной сделки.

9. Если сообщение не пришло

Последовательно проверьте:

• Max-бот подключён и активен;
• пользователь нажал Старт в нужном боте;
• в CRM отображается состояние «Подключено»;
• в списке ID пользователей есть запись с типом Max;
• ID пользователя записан без пробелов;
• нужное оповещение активно;
• включён флаг «Оповещать через бота Max»;
• подключённый пользователь указан получателем;
• заполнен шаблон сообщения;
• выполнено именно то действие, которое является триггером оповещения;
• активен только один Max-бот.

Если в истории оповещений запись создана, но сообщения в Max нет, передайте администратору:

• дату и время проверки;
• номер тестовой сделки;
• имя пользователя CRM;
• название подключённого бота;
• скриншот состояния подключения без токена.

10. Краткий чек-лист

• [ ] Бот создан, токен получен.
• [ ] Токен сохранён в CRM.
• [ ] В CRM нет ошибки регистрации webhook.
• [ ] Пользователь нажал Старт в Max-боте.
• [ ] В CRM отображается состояние «Подключено».
• [ ] ID пользователя записан без пробелов.
• [ ] Нужное оповещение активно.
• [ ] Включена отправка через Max.
• [ ] Пользователь является получателем оповещения.
• [ ] Тестовое сообщение успешно получено.

Автор инструкции: Кирилл Озорнин.