Подключение AI-агента
Что делает. К переписке на Авито можно подключить AI-агента или свою программу. Виджет даёт ей три вещи: сообщения из чатов в реальном времени, историю переписки и отправку ответов покупателям. Что с этим делать, решаете вы. Например:
- квалифицировать заявки — агент читает первые сообщения и отмечает, кто готов купить;
- отвечать покупателям — на типовые вопросы о наличии, цене и доставке;
- контролировать менеджеров — кто долго не отвечает, где потеряли клиента;
- выгружать переписку в свою CRM, таблицу или BI-отчёт.
Самого агента виджет не содержит. Его пишет ваш разработчик или нейросеть по нашей инструкции. В инструкции одним файлом собраны весь API, готовый код и правила, которые защищают от дублей, потери сообщений и ответов агента самому себе.
Как настроить.
- Проверьте тариф. Живой поток сообщений и история переписки работают на тарифе «Профессиональный». Отправка сообщений через API работает на любом тарифе. Тариф видно на вкладке «Подписка».
- Скачайте инструкцию. Откройте виджет → вкладка «API» → карточка «Инструкция для AI-агента» → «Скачать .md». Кнопка «Открыть» показывает её в браузере. Прямая ссылка: https://av.3fv.ru/docs/avito-3fsoft-api-agent.md
- Выпустите API-ключ на той же вкладке и отметьте права под задачу (таблица ниже). Как это сделать, описано в статье API-ключи и отправка сообщений.
- Заведите подписку на webhook'и, если агенту нужны сообщения в реальном времени: блок «Webhooks» → «Добавить подписку». Адрес сервера даст разработчик. Подробно — в статье Webhooks: события о сообщениях.
- Передайте инструкцию. Загрузите файл в Claude, ChatGPT или Cursor и опишите задачу своими словами, например: «Напиши сервер, который получает сообщения покупателей с Авито и отвечает на вопросы о наличии». Или отправьте файл разработчику.
- Ключ и секрет подписи передайте отдельно (см. предупреждение ниже).
Какие права выдать ключу. Выдавайте только то, что нужно для задачи.
| Задача | Права ключа |
|---|---|
| Отправлять сообщения из своей CRM по контакту amoCRM | «Чтение чатов», «Отправка сообщений» |
| Выгрузка переписки, отчёты, контроль менеджеров (только чтение) | «Чтение чатов», «Чтение истории сообщений» |
| Агент, который читает переписку и отвечает покупателям | «Чтение чатов», «Чтение истории сообщений», «Отправка сообщений» |
| Программа сама заводит и меняет подписки на webhook'и | дополнительно «Управление webhook-подписками» |
Подписку лучше завести самому в виджете, а право «Управление webhook-подписками» не выдавать. С этим правом ключ может перенаправить всю переписку на любой адрес.
⚠️ Не вставляйте ключ и секрет в чат с нейросетью. Ключ ak_…, секрет подписи whsec_… и токен подписки — это доступ к переписке ваших покупателей. Всё, что вы вставили в чат с нейросетью, остаётся в истории этого сервиса. Попросите агента написать код, который берёт ключ из переменной окружения, а сам ключ впишите на сервере или передайте разработчику лично. Если ключ всё же попал в чат, отзовите его на вкладке «API» и выпустите новый.
Ограничения и частые вопросы.
- История нужна, если есть webhook'и? Да, но для другого. История отдаётся медленно, один запрос в секунду: выгрузка 50 чатов занимает около 17 минут. Она нужна для первичной загрузки и сверки. Сообщения в реальном времени приходят только через webhook'и.
- Агент будет отвечать сам себе? Нет, если соблюдать правила из инструкции. Ответ агента возвращается к нему событием, и в инструкции описано, как отличить его от сообщения покупателя.
- Что может отправить агент? Только текст и картинки, это ограничение Авито. Отправленное сообщение появляется в чате amoCRM, менеджер его видит.
- Нужен ли свой сервер? Для webhook'ов да: события приходят на адрес
https://, доступный из интернета. Для выгрузки истории и отправки сообщений хватит программы, которая сама ходит в API. - Персональные данные. В переписке имена и сообщения покупателей. Отправляя их во внешний AI-сервис, вы отвечаете за обработку этих данных.
- Что делать, если что-то не работает? Напишите в техподдержку и приложите время и номер события из журнала доставок.