Подключить свой ИИ к чатам: вебхук + ответ

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

Ваш ИИ может работать на вашем сервере, в n8n, Make или вашем боте.

1. В разделе «Интеграции» создайте отдельный ключ. Выберите нужные кабинеты и права: уведомления, чтение чатов, ответы покупателям. Передавайте ключ только своему серверу.
2. Создайте подписку на new_message через create_webhook. Укажите публичный адрес HTTPS вашего сервера. Сохраните секрет подписи: он показывается один раз.
3. Ваш сервер принимает уведомление, проверяет подпись и запоминает номер доставки. По уведомлению прочитайте сохранённый диалог через MCP. Уведомление не содержит текст покупателя.
4. Передайте модели переписку и ваши правила ответа. Через draft_chat_message сохраните предложенный ответ. Передайте владельцу ссылку approval_url.
5. Владелец открывает ссылку на сайте, проверяет текст и отправляет его покупателю.

Схема: вебхук → ваш сервер → модель с нашим MCP → ответ черновиком → ваша проверка → покупатель.

Пример запроса: draft_chat_message, тело {"account_id":2,"chat_id":17,"text":"Здравствуйте! Да, товар в наличии."}, заголовок Idempotency-Key: reply-example-0001. Номера в примере вымышлены. Возьмите номера кабинета и сохранённого диалога из разрешённых вам данных.

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

По умолчанию ответ остаётся черновиком. Автоматическую отправку через send_chat_message разрешаете только вы: «Интеграции» → «Настроить ответы по кабинетам». Задайте пределы за час и сутки отдельно для кабинета и диалога. Если разрешение отсутствует или предел достигнут, ответ останется черновиком. В диалоге или объявлении с включённым ИИ-менеджером внешний ИИ готовит только черновики. Для отправки по ссылке сначала выключите ИИ-менеджера для диалога и объявления.

Длина ответа — до 1000 знаков. Вложения этим способом не отправляются. Доступность переписки зависит от кабинета и доступа Авито. Доступ определяется включёнными возможностями и правами вашего подключения. Модель не может подтверждать сообщения или менять разрешение на автоматическую отправку.

Проверка подписи: sha256= + HMAC-SHA256 от timestamp.delivery_id.event.raw_body с секретом подписки. Проверяйте время с допуском 300 секунд. После проверки подписи атомарно сохраняйте номер доставки минимум на сутки. Повторную доставку подтверждайте ответом 2xx, повторно модель не вызывайте. При отложенном повторе подпись и время меняются, номер доставки сохраняется.

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

Проверьте соединение через test_webhook и журнал list_webhooks. Постановка в очередь ещё не означает доставку. Подписку можно удалить; уже начатая доставка может завершиться. Секрет и ключ не помещайте в текст модели, переписку или общедоступные сценарии.