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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ПриПосле ошибкеустранения доставкипричины доступнывыберите:

действия

• «Отправить повторно в первоначальный канал» и— повторить тот же путь;
• «Отправить повторно в текущий выбранный канал» — использовать канал из верхней полосы.

Полная последовательность диагностики приведена в статье «Почему не отправляется сообщение».

Второй

Если вариантпроблема используйтеотносится к MAX-инстансу

Сотрудник не должен изменять реквизиты подключения из диалога. Передайте администратору название канала и видимый статус. Подключение, QR-авторизация и замена устройства описаны в технической инструкции «MAX Green-API: подключение, авторизация и замена инстанса».

Готово: выбран фактический канал, правила клиента сохранены, а повтор выполнен только после проверки канала в верхней полосе диалога. При праве «Просматривать технические попытки сообщений» дополнительно доступна ссылка «Технические данные».статуса.

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

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