Перейти к основному контенту

Каналы диалога и MAX-инстанс

Для кого эта инструкция

Для сотрудника, который отвечает клиенту в мессенджере, и администратора, который поддерживает подключение MAX Green-API.

Где находится

Для канала в диалоге: внизу левого меню нажмите кнопку с иконкой сообщения → откройте диалог → используйте полосу каналов под шапкой чата. Для MAX-инстанса: шестерёнка внизу левого меню → «Общие настройки» → карточка «Настройки оповещений» → карандаш → «MAX: Green-API интеграции».

Как DoCRM выбирает канал в открытом диалоге

Откройте мессенджер кнопкой с иконкой сообщения внизу боковой панели и выберите диалог. Под шапкой чата находится полоса каналов и кнопка «Настройка каналов».

DoCRM берёт канал, выбранный у клиента, и его настройки мессенджера: тип связи, провайдер и канал провайдера. Затем система проверяет комбинацию на сервере. Если проверка не нашла рабочий путь, канал в чате помечается красным как недоступный.

Нажмите на неактивный ярлык канала, чтобы выбрать его для следующего сообщения. Нажатие на уже активный ярлык открывает подсказку «Будет отправлено через:» с названием провайдера и канала. Звёздочка показывает предпочтение, сохранённое в карточке клиента: для самого типа канала, провайдера или конкретного канала провайдера.

Измените настройки связи клиента

В открытом диалоге нажмите «Настройка каналов». В форме «Настройка каналов общения» проверьте и при необходимости измените данные, по которым DoCRM связывает клиента с мессенджером: телефон, Telegram-ник или UserId, MAX UserId, VK-ник или UserId. Сохраните форму, затем снова выберите нужный ярлык канала в чате.

Это действие относится к конкретной карточке клиента. Оно не изменяет параметры самого подключённого провайдера для всей школы.

Что такое MAX-инстанс

MAX Green-API использует инстанс устройства. Для DoCRM это значение idInstance в настройке канала; именно по нему система определяет, в какой настроенный канал отнести входящий webhook MAX. В карточке клиента хранится не idInstance, а внутренний идентификатор канала, провайдер и данные диалога.

Поэтому при замене подключённого устройства сохраняйте прежний «Идентификатор канала», если это тот же рабочий канал школы, и заменяйте только данные нового инстанса. Тогда карточки, уже связанные с этим внутренним каналом, сохраняют привязку; новые входящие события будут распознаны по новому idInstance.

Замените или авторизуйте MAX-инстанс

  1. Нажмите шестерёнку внизу боковой панели и откройте «Общие настройки».
  2. В карточке «Настройки оповещений» нажмите карандаш.
  3. Раскройте блок «MAX: Green-API интеграции» и откройте нужный канал.
  4. Проверьте «Название канала», «Идентификатор канала», apiUrl, mediaUrl, idInstance и apiTokenInstance.
  5. Нажмите «Обновить статус». Если состояние notAuthorized, нажмите «Авторизоваться» и отсканируйте QR-код в окне «Авторизация MAX по QR». При успешной авторизации окно закрывается автоматически.
  6. Сохраните настройки оповещений.

Важно: webhook от старого или неверно указанного idInstance DoCRM не привяжет к каналу и пропустит. После замены инстанса проверьте статус и выполните тестовый входящий диалог.

Готово: в чате виден реальный маршрут отправки, а MAX-инстанс сопоставлен с одним настроенным каналом DoCRM.