Инструкция по настройке интеграции Max с Intradesk. Статья обновляется...
В новом релизе Intradesk реализована интеграция с мессенджером MAX (Макс). Теперь ваши клиенты и сотрудники могут создавать заявки и общаться с технической поддержкой напрямую через чат-бота.
Создавать заявки посредством бота можно будет клиентам без авторизации. Это означает, что при начале "чата с ботом" от нового пользователя в Intradesk-е будет создан новый клиент и заявка от него.
*На текущий момент данный функционал пока что находится в beta-версии. В дальнейшем планируется доработка следующих функций:
- Добавление канала "Max" в правила создания заявок (и другие правила тоже)
- Добавление в фильтр по "каналам" на списке заявок значения "Max"
Чтобы связать две системы, вам понадобится создать чат-бота на стороне мессенджера, скопировать его уникальный ключ (токен) и перенести его в настройки Intradesk. Ниже приведена подробная инструкция.
Содержание:
Этап1. Настройка на стороне Max
- Шаг 1.1. Регистрация организации и авторизация
- Шаг 1.2. Создание карточки чат-бота
- Шаг 1.3. Копирование токена (API-ключа)
Этап2. Настройка на стороне Intradesk
Этап 1. Создание чат-бота и получение токена в мессенджере MAX
⚠️Важное ограничение платформы: Согласно правилам MAX, создавать чат-ботов могут только верифицированные организации (юридические лица или ИП, являющиеся резидентами РФ). Физическим лицам эта опция недоступна. Подробнее о требованиях читайте в документации MAX для разработчиков.
Шаг 1.1. Регистрация организации и авторизация
Перейдите на официальный портал MAX для разработчиков или в кабинет партнера и пройдите процедуру авторизации по номеру телефона. Если ваша компания еще не верифицирована, вам потребуется подтвердить профиль организации через Госуслуги или банковские сервисы ID.
Шаг 1.2. Создание карточки чат-бота
- Перейдите в профиль вашей организации на платформе и откройте раздел «Чат-боты».
- Нажмите кнопку «Создать» (или «Создать бота»).
- Заполните обязательные поля профиля: укажите публичное Название (Имя) бота, которое увидят пользователи, добавьте краткое описание и загрузите квадратный аватар.
- Примечание: Уникальный никнейм бота сгенерируется автоматически по шаблону
id[ваш_ИНН]_bot. - Отправьте созданного бота на модерацию (проверка регламентируется инструкцией по созданию чат-ботов MAX и обычно занимает до 48 часов).
Шаг 1.3. Копирование токена (API-ключа)
- После того как статус вашего бота в панели управления изменится на «Одобрен», кликните по его имени.
- Перейдите в настройки бота (вкладка «Интеграция» или карточка управления ботом).
- Найдите строку «Токен» (Token) — она содержит длинный буквенно-цифровой ключ.
- Нажмите кнопку «Копировать» и сохраните значение. Этот ключ потребуется для интеграции на стороне Intradesk.
Этап 2. Настройка на стороне Intradesk
Шаг 2.1. Создание интеграции с Max в Intradesk
- В Intradesk откройте Настройки -> Интеграции -> Max
- Нажмите кнопку «Создать»
- В поле "Токен доступа" вставьте токен, который получили на прошлом этапе
- Введите название
- Нажмите «Сохранить»
Готово, интеграция с ботом настроена!
На данном этапе вы так же можете настроить следующие поля:
- Приветствие бота - сообщение, которое будет приходите пользователю в начале общения с ботом
- Пользователь по умолчанию - пользователь, который будет подставляться заявителем во всех заявках по чатам с Max
- Сообщение после создания заявки - сообщение, которое вернется пользователю после успешного создания заявки
- Обязательное заполнение телефона при создании заявки - если данная настройка включена, то при отправке сообщения будут будет отправлен запрос на получение номера телефона. Заявка не создастся, пока пользователь не поделится своим номером. Если по номеру найдется ранее созданный пользователь, то он подставится заявителем. Если пользователи с таким номером не найдется, то создастся новый, с указанным номером телефона.
Шаг 2.2. Проверка создания заявки через Max
- Откройте приложение Max
- В поиске найти бота, созданного на прошлых этапах
- Напишите в чат
- Если на прошлом шаге вы включили "Обязательное заполнение телефона при создании заявки", то нажмите на кнопку отправки номера телефона
Готово, заявка создана!
Важно!
- У разных ботов не должно быть одинаковых токенов доступа! Если при создании/настройке бота добавить токен, использующийся в другом боте, интеграция будет работать нестабильно
- При обращении нового пользователя через бот, Intradesk создает нового клиента и сохраняет для него значение "MaxId". При повторном обращении от этого же клиента он определится по "MaxId" и подставится заявителем в заявке.
- Если после общения с клиентом через бот сотрудник закрывает заявку, то по следующему сообщению от этого клиента будет создана новая заявка.
- Мы рекомендуем в БП сделать обязательным заполнение поля "Комментарий" при переводе в статусы "Требует уточнения" и "Выполнена", чтобы исполнитель был обязан добавить комментарий при переводе заявки в эти статусы. Т. к. уведомления по интеграции с Max отправляются по добавлению комментария, а не по настройкам уведомлений. В противном случае клиент не узнает о выполнении заявки.