API мессенджера Авито: как подключить чаты к боту или CRM

API мессенджера Авито позволяет читать и отправлять сообщения в чатах объявлений из внешних сервисов: CRM, чат-ботов, своих скриптов. Разберём, что нужно для подключения.

Какой тариф Авито нужен для API чатов

Доступ к сообщениям через API Авито даёт не на всех тарифах. Обычно это:

• «Расширенный» — в категории Услуги;
• «Максимальный» — в категориях Товары и Работа.

Условия меняются, поэтому перед подключением проверьте актуальный тариф в личном кабинете Авито.

Где взять client_id и client_secret

1. Войдите в профиль компании на Авито с компьютера.
2. Откройте раздел «Интеграции» → «API».
3. Скопируйте client_id и client_secret.

По ним сервис получает токен доступа. Не передавайте ключи тем, кому не доверяете: с ними можно читать переписку.

Есть второй способ — вход через Авито (OAuth). Вы нажимаете кнопку в сервисе, Авито спрашивает, разрешить ли доступ к сообщениям, и сервис получает доступ без ваших ключей и пароля. Так подключается, например, Менеджерыч.

Как работают вебхуки сообщений

Чтобы бот узнавал о новых сообщениях сразу, сервис подписывается на вебхук: Авито присылает уведомление на адрес сервиса каждый раз, когда в чате появляется сообщение. Адрес должен работать по HTTPS.

В уведомлении есть ID чата, автор сообщения и текст. Дальше сервис решает, что ответить, и отправляет ответ через API.

Что важно учесть при разработке своего бота

• Отличайте свои сообщения. В вебхук приходят и входящие, и исходящие. Ответ бота не должен запускать новый ответ.
• Склеивайте сообщения. Клиенты часто пишут тремя короткими сообщениями подряд. Подождите несколько секунд, прежде чем отвечать.
• Дайте человеку перехватить диалог. Если менеджер ответил сам, бот должен замолчать.
• Обновляйте токен. Токен доступа живёт ограниченное время, его нужно перевыпускать.

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

Частые вопросы

Где найти API Авито для сообщений?

В профиле компании: «Интеграции» → «API». Там client_id и client_secret.

Почему API Авито не отдаёт сообщения?

Чаще всего на аккаунте нет тарифа с доступом к API чатов. Нужен «Расширенный» (Услуги) или «Максимальный» (Товары, Работа).

Можно ли подключить чаты Авито без ключей API?

Да, через вход по OAuth: сервис попросит разрешение на доступ к сообщениям прямо на сайте Авито.