Авито: прямое подключение
Amobit Chats подключается к Авито напрямую через Avito Messenger API: сообщения из чатов Авито приходят в кабинет и в вашу CRM, ответы операторов уходят от имени вашего профиля Авито. Для внешней системы это обычный канал: события приходят в webhook с channel: "avito", ответы уходят тем же HTTP API.
Коротко. Avito Messenger API не продаёт доступ отдельно: он входит в подписку «Максимальный» (для Товаров и Работы) или «Расширенный»/«Максимальный» (для Услуг). Без такой подписки подключение вернёт «нет доступа к Messenger API» — это ограничение Авито, а не ошибка Amobit.
Что понадобится
- Профессиональный аккаунт Авито (личный кабинет продавца или компании) с подпиской, включающей Messenger API.
- Ключи приложения Авито:
client_idиclient_secret— их выдаёт раздел «Профиль и настройки» → «Интеграции и API» (в старом интерфейсе — «Для профессионалов» → «API»). - Рабочее пространство в Amobit Chats с правом подключать каналы.
Подключение в кабинете
-
Выберите канал
Кабинет → Настройки → Каналы → Добавить канал → Авито → Подключить. Выберите тариф канала и срок.
-
Вставьте ключи Авито
В диалоге выберите режим «Профиль Avito (client_id и client_secret)» и вставьте ключи из кабинета Авито.
client_secretпередаётся по HTTPS, хранится в Amobit в зашифрованном виде и не возвращается в API. -
Дождитесь проверки
Amobit обменивает ключи на токен (действует 24 часа, обновляется автоматически), читает профиль аккаунта и подписывает свой webhook на события Авито. При успехе канал получает статус «подключён».
-
Проверьте обмен
Напишите в чат вашему объявлению с другого аккаунта Авито (или попросите клиента): диалог появится в Amobit Chats → Сообщения. Ответьте из Chats и убедитесь, что сообщение пришло в чат Авито.
Как это работает
Amobit Chats хранит токены аккаунта Авито только в зашифрованном виде и не передаёт их внешним системам: CRM получает события и отправляет ответы через Amobit.
Клиент Авито → Avito Messenger → webhook Amobit Chats
│
webhook message.created (channel: "avito")
↓
ваша CRM / ERP / helpdesk
│
POST /api/v1/external-integrations/inbound/messages/
Authorization: Bearer amc_… (ответ в диалог)
↓
Amobit Chats → Avito → клиент
В webhook сообщения Авито приходят с thread.channel и channel_profile.channel равными avito. Поле phone обычно пустое: Авито не отдаёт телефон покупателя через Messenger API. Ответ отправляется по thread.id из события. Отдельного Авито-специфичного API нет.
Имя и аватар покупателя Amobit подтягивает из данных чата Авито. Изображения приходят вложениями и подгружаются локально, чтобы ссылки Авито не истекали; голосовые сообщения сохраняются отдельным заданием, потому что ссылка на файл живёт один час.
Ограничения
- Только ответы в существующих чатах: начать диалог первым через Messenger API нельзя — его создаёт покупатель.
- Текст до 1000 символов в одном сообщении; изображения — да, файлы, видео и голосовые исходящие — нет (таких методов в API Авито нет).
- Рассылки, кампании и массовые сообщения не поддерживаются.
- Нет групповых чатов, реакций, кнопок, шаблонов и индикатора «печатает».
- Нет квитанций доставки: после успешной отправки сообщение считается отправленным, отметка «прочитано» появляется, когда Авито сообщает о прочтении.
- Подписка Авито обязательна: без «Максимального»/«Расширенного» тарифа Messenger API недоступен.
- Ключи привязаны к аккаунту: если ключ отозван в кабинете Авито, канал перестаёт получать сообщения до переподключения.
Если что-то не работает
| Симптом | Что проверить |
|---|---|
| «Avito отклонил client_id и client_secret» | Ключи скопированы полностью, приложение принадлежит этому аккаунту Авито и имеет доступ к API. Перевыпустите ключи в кабинете и подключите заново. |
| «У аккаунта Avito нет доступа к Messenger API» | В кабинете Авито подключите подписку «Максимальный» (Товары/Работа) или «Расширенный»/«Максимальный» (Услуги). Ключи без подписки работать не будут. |
| «Ключи приняты, но подписка на события не подтверждена» | Повторите подключение: Amobit перерегистрирует webhook. Если повтор не помогает — напишите в поддержку, указав код обращения. |
| Сообщения не приходят | Проверьте, что канал в статусе «подключён», а в кабинете Авито нет ограничений для аккаунта. Неподтверждённый webhook означает, что входящие не дойдут. |
| «Для Avito нужен публичный HTTPS-адрес» | Платформе нужен публичный HTTPS для приёма событий Авито; обратитесь в поддержку. |
Перевод канала с прежнего подключения
Если канал Авито уже подключён через сторонний сервис-посредник, при подключении прямого профиля Amobit предложит перевести существующий канал: диалоги, контакты и связи с CRM сохраняются. Профиль в стороннем сервисе при этом не отключается и не оплачивается Amobit — это отдельная операция владельца кабинета.
Данные и безопасность
- Токены и
client_secretхранятся только зашифрованными (Fernet); в API и журналах они не появляются. - Webhook Авито не подписывается: вход защищён уникальным секретным путём канала и проверкой аккаунта в событии. Секрет пути не публикуется и не возвращается API.
- Повторные события не создают дублей: сообщения дедуплицируются по идентификатору Авито.
- Удаление канала отключает подписку и перестаёт принимать события; история диалогов в Amobit Chats сохраняется.