Рабочие группы MAX

Подключение MAX — экспериментальная функция. В настройках оно отмечено пометкой «Экспериментально»; этот статус также показан при подключении бота.

PROChat передаёт новые обращения Авито в группы MAX, чтобы команда видела сообщения без постоянного наблюдения за сайтом. Настройки находятся в Уведомления → Рабочие группы MAX и доступны владельцу и администраторам пространства.

Подключить бота

1. Создайте бота в MAX для бизнеса, получите его токен и добавьте бота администратором в нужный групповой чат. Официальная инструкция MAX (откроется в новой вкладке) описывает подключение бота к группе.
2. Уточните ID группы по официальной инструкции получения chat_id (откроется в новой вкладке). Нужен числовой ID, не ссылка или название. Текущий этап использует ручной ввод ID: автоматического обнаружения групп через Webhook в PROChat пока нет. Устаревший общий список чатов для этого не используется.
3. В PROChat нажмите Добавить бота MAX, укажите название, выберите Рабочий режим и введите токен. Нажмите Подключить бота. Сервис проверит токен. Он хранится зашифрованным и больше не показывается в интерфейсе.

Если рабочий режим недоступен, администратору сервера нужно настроить интеграцию. Токен принадлежит вашему боту и вводится в форме, отправлять его в поддержку не нужно. Бот MAX здесь служит для рабочих групп; клиентские диалоги MAX в «Каналы связи» на этом этапе не добавляются.

Создать маршрут

1. Нажмите Создать маршрут MAX.
2. Задайте название, выберите аккаунт Авито, подключённого бота MAX и введите ID группы. Источник и бот должны быть одного режима: оба рабочие или оба демонстрационные.
3. При необходимости раскройте Условия распределения: ID объявлений, теги и приоритет.
4. Подтвердите, что участникам группы разрешён доступ к обращениям этого аккаунта. Проверьте состав группы MAX: PROChat не управляет её участниками и не выдаёт им автоматически учётные записи или права на сайте.
5. Включите маршрут и сохраните. Бот и его членство администратора в указанной группе проверяются до сохранения рабочего маршрута. Личные чаты и каналы не подходят.

Новый маршрут изначально выключен. Без включённого маршрута пересылки не будет. Изменить настройки или удалить маршрут можно через Действия в его строке. Аккаунт, бот и группа закреплены за маршрутом: для другой группы создайте новый. Удаление бота удаляет его маршруты и отменяет неотправленные уведомления; история подтверждённых и неизвестных доставок сохраняется.

Условия и резервная группа

Несколько ID объявлений означают любое из перечисленных. Для тегов можно выбрать Все выбранные теги или Любой выбранный тег. Если одновременно заданы объявления и теги, должны подходить обе части. Учитываются теги, которые текущий автоответ успел назначить до выбора маршрута.

Сначала проверяются маршруты с условиями: меньшее число приоритета раньше, затем порядок создания. Выбирается одна группа MAX для сообщения. Если ни один условный маршрут не подошёл, используется один маршрут без условий — резервная группа. Даже выключенный резервный маршрут занимает это место до удаления или добавления условий. Одна группа одного бота закрепляется за одним маршрутом пространства.

Изменение тегов, маршрута, назначения или прав после получения обращения может отменить ещё не отправленное уведомление. Старое событие не перенаправляется в другую группу. Если выбранная группа недоступна, резервная автоматически не используется. При одновременных маршрутах Telegram и MAX каждая площадка получает отдельную копию; внутри каждой выбирается одна группа.

Что приходит в группу

Уведомление содержит пространство, исходный аккаунт, имя клиента, ID объявления при наличии, ограниченный текст сообщения и ссылку на обращение в PROChat. Для вложений показывается описание, без публикации файлов или закрытых ссылок. Открытие ссылки требует обычной авторизации и доступа к исходному аккаунту.

Это пересылка новых входящих. Старая история, дубли событий, внутренние заметки, поля карточки, исходящие ответы и обращения в поддержку не пересылаются. Ответ из MAX клиенту не отправляется: отвечайте в PROChat. Удалить уже доставленную копию последующим отзывом доступа на сайте невозможно.

Рабочие маршруты используют действующие условия подписки с функцией работы из групп и общий лимит маршрутов Telegram/MAX. Демонстрационная подписка не разрешает отправку по реальным аккаунтам Авито. Подключённые рабочие боты сами по себе не дают права отправлять сообщения.

Журнал, пауза и восстановление

В Журнале доставки видны последние 20 доступных записей, состояние и текст уведомления. Нажмите Обновить маршруты MAX для актуального состояния. Пропущено означает отмену или отсутствие подходящего маршрута; Ошибка — подтверждённый отказ. При Результат неизвестен проверьте группу MAX: автоматического повтора нет, чтобы не создать дубль.

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

Если после сохранения пропал ответ сервера, нажмите Проверить состояние в форме. Если изменение не найдено, доступен Повторить тот же запрос с прежним идентификатором. Новый запрос автоматически не отправляется. При конфликте двух вкладок обновите список и проверьте актуальную версию.

Проверить без MAX

В локальной среде с включённым симулятором добавьте Демонстрационного бота. Токен не нужен. Выберите демонстрационный аккаунт Авито, укажите тестовый ID, например -123456, включите маршрут и отправьте тестовое входящее через симулятор. В журнале появится результат обработки с пометкой ДЕМО. Настоящие запросы к MAX не выполняются.

Если рабочая пересылка недоступна

Попросите администратора сервиса проверить, разрешена ли экспериментальная интеграция MAX и не приостановлена ли отправка. Не нужно менять общую паузу ради учебной проверки: демонстрационный режим работает без настоящих сообщений.