Каналы диалога и 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-инстанс
- Нажмите шестерёнку внизу боковой панели и откройте «Общие настройки».
- В карточке «Настройки оповещений» нажмите карандаш.
- Раскройте блок «MAX: Green-API интеграции» и откройте нужный канал.
- Проверьте «Название канала», «Идентификатор канала»,
apiUrl,mediaUrl,idInstanceиapiTokenInstance. - Нажмите «Обновить статус». Если состояние
notAuthorized, нажмите «Авторизоваться» и отсканируйте QR-код в окне «Авторизация MAX по QR». При успешной авторизации окно закрывается автоматически. - Сохраните настройки оповещений.
Важно: webhook от старого или неверно указанного
idInstanceDoCRM не привяжет к каналу и пропустит. После замены инстанса проверьте статус и выполните тестовый входящий диалог.
Готово: в чате виден реальный маршрут отправки, а MAX-инстанс сопоставлен с одним настроенным каналом DoCRM.