ИИ-продавец для Avito: сценарий, ограничения и честная проверка интеграции

Как подтвердить доступ аккаунта

Avito предоставляет официальный Messenger API для двусторонней интеграции переписки со сторонней системой. Доступ зависит от условий и тарифа конкретного бизнес-аккаунта, поэтому актуальное право на методы чтения и отправки проверяют в кабинете и официальной документации перед настройкой.

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

Что делает первая линия в сообщениях

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

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

• сопоставить чат с объявлением и владельцем аккаунта;
• найти ответ в опубликованных материалах;
• собрать только настроенные поля квалификации;
• не обещать скидку, наличие или срок вне источника;
• передать сложное обращение человеку.

Почему конфигурация общая, а адаптер отдельный

Роль, база знаний, ограничения и причины передачи общие для Telegram, сайта и Avito. Тогда изменение цены или запрета публикуется в одной версии сотрудника, а не копируется вручную в три независимых бота.

Канальный адаптер отвечает за другое: авторизацию, связь чата с объявлением, формат события, повторную доставку и ответ через официальный метод. Эти детали тестируются отдельно и не должны менять смысл ответа сотрудника.

Подключайте канал по этапам

Сначала владелец подтверждает официальный доступ и выдаёт минимально необходимые права. Затем выполняется безопасная проверка чтения аккаунта и тестового диалога без отправки клиентам. После этого на отдельном тестовом сообщении проверяются получение события, сопоставление объявления, один ответ и сохранение истории.

Последний этап - перезапуск приложения и повторная доставка того же события. В Inbox должен остаться один диалог, а клиент не должен получить дубль. Только после этого канал можно считать технически принятым для конкретного аккаунта.

Что означает запуск fail-closed

При просроченном токене, неизвестном типе события, неподтверждённом объявлении или недоступности API система сохраняет ошибку и не делает вид, что ответ отправлен. Повтор разрешается только с тем же идентификатором события, чтобы не создать второе сообщение.

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

Что можно подготовить до доступа к API

Можно заранее настроить роль, знания по объявлениям, поля квалификации, запреты, причины передачи и ответы в Test Room. Это сокращает запуск, но не подтверждает работу канала. Публично Avito следует показывать с прямой оговоркой: нужен официальный Messenger API-доступ и отдельная проверка аккаунта.

Настоящий экран ниже доказывает общую конфигурацию каналов в Builder. Он не является доказательством живого обмена с Avito. Для этого нужны логи сквозного теста на разрешённом аккаунте.