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

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

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

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

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

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

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

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

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

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

Настройте приоритет и блокировки для клиента

В открытом диалоге нажмите «Настройка каналов». В окне «Настройки каналов» можно управлять правилами именно этой карточки клиента:

  1. «Запрет на автоматические уведомления» выключает автоматические уведомления клиенту целиком.
  2. В «Запрещённые каналы для уведомлений» отметьте каналы, куда нельзя посылать автоматические уведомления. Исключение — PIN для входа в личный кабинет: этот запрет на него не распространяется.
  3. В «Запрещённые каналы для сообщений» отметьте каналы, через которые сотрудникам нельзя писать клиенту вручную. Нельзя одновременно заблокировать и выбрать как «Приоритетный канал для общения» один и тот же канал: форма не даст сохранить такую комбинацию.
  4. В «Приоритетный канал для общения» выберите основной канал. SMS и Email в этом выборе не предлагаются.
  5. В блоке «Провайдеры по каналам» при необходимости задайте провайдера и его конкретный канал для клиента. Затем нажмите «Сохранить».

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

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

Если сообщение не отправилось

Откройте детали неотправленного исходящего сообщения. DoCRM показывает понятный статус, например «Все каналы клиента заблокированы», «Клиент заблокировал возможность общения по этому каналу», ошибку авторизации провайдера или превышение лимита.

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

Важно: красный ярлык означает, что выбранный канал недоступен для текущего клиента. Не пытайтесь отправлять повторно в него вслепую — измените канал или настройки клиента, затем повторите отправку.

Что такое 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.

Наверх