Подключение Avito
Как подключить Avito по client_id и client_secret, выбрать загрузку бесед и проверить результат
Подключите аккаунт Avito, чтобы получать его сообщения в А5Клиент. В этой инструкции используется способ «Личный Avito» — подключение с Вашими ключами client_id и client_secret.
Что понадобится
- client_id и client_secret нужного аккаунта Avito. Первый идентифицирует подключение, второй подтверждает доступ. В форме рядом с типом аккаунта есть ссылка «от avito», по которой можно перейти к приложениям Avito.
- Включённая учётная запись А5Клиент и свободное место в лимите аккаунтов Avito. Проверить лимит можно на странице «Аккаунты сообщений».
Ключи и вход в Avito
В поля client_id и client_secret нужно вставить ключи доступа, а не логин и пароль от Avito. На скриншотах эти поля оставлены пустыми.
Как добавить аккаунт по ключам
Откройте форму
В боковом меню выберите «Аккаунты сообщений», затем нажмите «Добавить Avito». Откроется страница «Avito аккаунт».
Укажите название и ключи
В поле «Название аккаунта» введите понятное Вам название, например «Основной аккаунт Avito». Оно используется внутри А5Клиент.
В блоке «Тип аккаунта» оставьте «Личный Avito». Вставьте client_id и client_secret в одноимённые поля.
Выберите, какую историю загрузить
В блоке «Загружать последние беседы» выберите один из вариантов:
- «Загрузить все беседы» — загрузить историю с учётом ограничений по количеству и возрасту, указанных ниже.
- «Не загружать беседы старше момента создания аккаунта» — получать только новые сообщения с момента добавления аккаунта в А5Клиент.
Если нужна история, настройте оба ограничения:
| Поле | Как выбрать значение |
|---|---|
| Количество бесед для синхронизации | Примерное число последних бесед. По умолчанию — 100. Для сохранения допустимо значение от 1 до 2000. |
| После скольки дней не синхронизировать беседы | Максимальный возраст бесед при первой загрузке. По умолчанию — 60 дней, допустимо от 1 до 3650. Более старые беседы будут пропущены. |
Например, при значениях 100 и 60 сервис запросит около 100 последних бесед и пропустит беседы старше 60 дней. Если загрузка истории выключена, эти ограничения не используются; значения полей можно оставить по умолчанию.
Настройте отчёт о прочтении
В блоке «Отчет о прочтении» выберите «Отмечать прочитанным» или «Не отмечать прочитанным».
В первом случае сообщение будет отмечено прочитанным на Avito после доставки в А5Клиент. Во втором автоматическая отправка отчёта при обработке сообщения сервисом отключается.
Доставка не равна просмотру
Отметка о прочтении может появиться раньше, чем сотрудник откроет беседу в А5Клиент. При отключении отчётов интерфейс предупреждает о возможном неверном расчёте среднего времени ответа продавца на Avito.
Настройте заказы и этикетки
При подключении по ключам доступны «Включить API заказов» и «Автоматическая печать этикеток». Для работы с заказами нужна активная Авито Доставка для бизнеса.
Автоматическая печать создаёт этикетку для подтверждённого заказа с доставкой в пункт выдачи. Выберите «Выключена», если хотите запускать печать вручную. Ручная печать доступна независимо от этого переключателя; уже запущенные задачи продолжат выполняться.
При подключении через OAuth обе настройки недоступны. Подробнее — в руководстве по заказам.
Проверьте настройку сотрудника и продолжите
В поле «Иерархия аккаунтов avito: является сотрудником» оставьте «Нет», если подключаете обычный аккаунт. «Да» используется только для аккаунта сотрудника в иерархии Avito для бизнеса.
Нажмите «Продолжить...». Чтобы выйти без добавления, нажмите «Отменить».
Как проверить результат
После сохранения сервис вернёт Вас к списку аккаунтов и сообщит, что аккаунт сохранён и отправлен на обработку. Подключение не обязательно завершается сразу.
Найдите аккаунт в списке
Проверьте название и статус. Если отображается «регистрируется», проверьте список позднее. Рабочий статус — «всё в порядке».
Проверьте доставку сообщений
Нажмите «Подробнее». В блоке «Вебхуки / интеграция» проверьте «Вебхук сообщений»: ожидаемое состояние — «установлен». Вебхук доставляет события о сообщениях из Avito в А5Клиент.
Откройте беседы
Перейдите в «Беседы» и проверьте сообщения подключённого аккаунта. Если Вы отказались от загрузки истории, старые сообщения не должны появиться в результате первоначальной загрузки.
Подключение по ключам также позволяет использовать работу с заказами. Для неё в настройках аккаунта указаны дополнительные условия: активный Avito для бизнеса и подключённая Авито.Доставка. Подробнее — в руководстве по заказам.
Если для Вашей учётной записи доступен бот, поля «Логин и пароль от аккаунта avito для бота» могут отображаться уже при добавлении. После сохранения потребуется выполнить удалённый вход в Avito: откройте «Подробнее» в карточке аккаунта и проверьте блок «Бот». Подробнее о доступных действиях — в руководстве по странице аккаунтов.
Как изменить настройки аккаунта
В списке аккаунтов нажмите «изменить». Для подключения по ключам можно обновить client_id и client_secret, настройки API заказов и автоматической печати этикеток. Тип подключения существующего аккаунта в этой форме не меняется. Сохраните изменения кнопкой «Продолжить...».
Если подключение не получилось
| Что видно | Что проверить |
|---|---|
| «Достигнут лимит аккаунтов» | Посмотрите лимит на странице аккаунтов. Для расширения обратитесь в техподдержку. |
| «Ваша учетная запись отключена, функционал ограничен» | Проверьте тариф и оплату и предупреждение вверху страницы. |
| «Этот client_id уже зарегистрирован в системе, операцию невозможно завершить» | Аккаунт с таким ключом уже добавлен. Найдите его в списке вместо повторного подключения. |
| Форма не сохраняется | Проверьте обязательные поля, выбор отчёта о прочтении и ограничения истории. Для количества бесед используйте число не больше 2000. |
| После добавления показана ошибка | Прочитайте пояснение в строке аккаунта и проверьте, что ключи относятся к нужному аккаунту и скопированы полностью. |
| Сообщения не приходят | Проверьте статус аккаунта и вебхук сообщений в «Подробнее». При необходимости нажмите «переустановить» рядом с вебхуком сообщений и проверьте результат позднее. |
Если используется OAuth
В форме есть альтернативная кнопка «Настроить через Avito OAuth» — она позволяет подключить аккаунт через разрешение доступа на стороне Avito. Это отдельный способ подключения; работа с API заказов для него недоступна. Для подключения по ключам оставьте «Личный Avito».