Avito

Avito — переписка с покупателями Авито в общем списке чатов. Сообщения из мессенджера Авито приходят в Lalexi, ответы оператора уходят обратно в Авито, причём в диалоге видно, по какому объявлению написал покупатель.

Подключение делится на две части, и первая — не техническая. Доступ к мессенджеру Авито по API открывается не всем аккаунтам: нужен профиль компании с проверенными реквизитами и платная подписка определённого уровня. Пока этого нет, подключать нечего — Авито просто не отдаст чаты.

Часть первая: подготовка на стороне Авито

Всё в этом разделе делается в вашем кабинете Авито, до того как вы откроете Lalexi. Обычно это самая долгая часть: проверка реквизитов идёт несколько дней.

1. Профиль компании

Нужен аккаунт Авито, оформленный как компания или ИП, а не как частное лицо. Заводится он в кабинете: Профиль и настройки → Для профессионалов, дальше Авито спросит тип организации и ИНН и подтянет остальные данные из базы налоговой.

2. Проверка реквизитов

После заполнения данных Авито просит оплатить счёт с расчётного счёта компании — так площадка убеждается, что счёт принадлежит той же организации. Проверка занимает до нескольких рабочих дней, после неё у профиля появляется статус «Компания» и отметка «Реквизиты проверены».

3. Подписка нужного уровня

Это тот пункт, на котором подключение чаще всего останавливается: Messenger API входит не во все подписки Авито, и уровень зависит от того, что вы продаёте.

Это условие самого Авито, а не Lalexi, и оно описано в их документации Messenger API. Правила пользования API — в условиях использования Авито API для бизнеса.

4. Основной аккаунт компании

Подключать нужно основной аккаунт компании, а не профиль сотрудника. Авито ограничивает API для сотрудников: часть чатов по объявлениям компании в список не попадёт, а отправка, отметка прочитанным и вложения будут отклоняться. Отличить это заранее нельзя — ошибка придёт уже после подключения.

Адрес обратного вызова: готовить не нужно

Отдельный вопрос, который обычно возникает: какой callback-адрес указать Авито. Ответ — никакой:

• Адрес вебхука, на который Авито доставляет входящие сообщения, Lalexi регистрирует сам в момент подключения. Вводить его куда-либо не нужно, и он у каждого подключения свой.
• Адрес возврата после входа через Авито уже зарегистрирован в нашем приложении. Если он всё-таки у вас спрашивают — например, вы регистрируете в кабинете разработчика Авито собственное приложение, — это https://api.lalexi.com/link/callback.
• Ключи API, если вы идёте этим путём, выдаются в кабинете Авито сразу и никакого адреса при выдаче не требуют.

Часть вторая: подключение в Lalexi

1. Откройте Настройки → Источники (Settings → Inboxes), нажмите Добавить источник (Add Inbox) и выберите плитку Avito.

   

2. Нажмите Connect — откроется вкладка со страницей привязки.

   

3. Дальше — один из двух путей, они равноценны.

Путь 1: вход через Авито (обычный)

Нажмите Sign in with Avito. Откроется страница Авито, где нужно войти в основной аккаунт компании и разрешить доступ. Запрашиваются ровно три права: читать сообщения, отправлять сообщения и читать профиль аккаунта — ничего про объявления, кошелёк или платежи.

После подтверждения вкладка сама скажет «Connected» — её можно закрыть и вернуться в Lalexi.

Путь 2: свои ключи API

Подойдёт, если ключи Авито у вас уже есть или вы не хотите проходить через экран согласия.

1. В кабинете Авито откройте Профиль и настройки → Интеграции и API (в разделе «Для профессионалов») и нажмите Получить ключи.
2. Скопируйте client_id и client_secret.
3. На странице привязки раскройте I have API keys, вставьте оба значения и нажмите Connect.

Ключи проверяются сразу: если они не подойдут или у аккаунта нет доступа к мессенджеру, форма скажет об этом, и источник не создастся.

Когда привязка прошла, источник появится в списке под именем Avito · «название вашей компании» со статусом Подключено. Оно берётся из профиля Авито — вводить его не нужно.

По какому объявлению пишут

На маркетплейсе покупатель обращается не «в компанию», а по конкретному объявлению, поэтому Lalexi подписывает им диалог: название объявления с ценой показано в шапке диалога (название кликабельно и ведёт на объявление) и в строке списка чатов, чтобы разбирать входящие, не открывая каждое.

На скриншоте замазаны данные покупателей: имена чатов, названия объявлений и текст сообщений.

Строки не будет у переписок, заведённых не по объявлению (Авито разрешает писать и прямо в профиль).

Что канал умеет и чего не умеет

Ограничения тут не наши, а самого Авито:

• Отвечает только тем, кто написал первым. Чат на маркетплейсе всегда открывает покупатель, метода «начать переписку» в API нет. Поэтому канал недоступен в «Новом сообщении», рассылках и прогреве.
• Список чатов и история есть — в отличие от ботов. Можно выбрать, какие чаты зеркалировать, и импортировать прежнюю переписку, см. Настройки синхронизации.
• Телефона покупателя Авито не отдаёт: контакт опознаётся по номеру аккаунта Авито и не объединяется с контактом из WhatsApp или Telegram.
• Наружу уходят только картинки. Документ, видео, архив или аудио канал отклонит с ошибкой прямо в чате: у Авито нет метода, чтобы их отправить. Подписи к картинке в Авито тоже нет, поэтому текст уходит отдельным сообщением перед изображением.
• Длинный ответ режется на части по 1000 символов — это ограничение Авито.
• Входящие приходят все, но не всё умеет показать: голосовые зеркалируются как аудиофайл, ссылка, геометка, карточка объявления и пропущенный звонок — строкой с тем, что в них было. Типы, которые Авито не отдаёт по API вовсе (файл, видео, звонок в приложении), появятся пометкой, чтобы сам факт сообщения не потерялся.
• Автоответы Авито (персональные предложения, ответы на частые вопросы) видны в переписке с пометкой «Автоответ Авито ·» — чтобы оператор не здоровался второй раз. Служебные уведомления Авито продавцу в чаты не попадают.
• Ответ оператора помечает чат прочитанным в кабинете Авито. Пока никто не ответил, чат там остаётся непрочитанным — это честный сигнал о неотвеченном обращении.

Подключение занимает слот в лимите подключений.

Если что-то не так