Подключение Avito

Подключите мессенджер Авито к Excella за 6 минут. Бот отвечает покупателям от имени продавца 24/7, подтягивает контекст объявления и эскалирует сложные вопросы оператору.

Обзор

Интеграция с Авито позволяет принимать сообщения покупателей внутри обычной ленты Excella — рядом с Telegram, VK и почтой. AI-бот отвечает на вопросы, ссылаясь на конкретное объявление и его атрибуты (цена, наличие, доставка), а оператор подключается одним кликом, когда нужен живой человек.

Для каких аккаунтов работает

• Авито Профи и выше — полный доступ к API мессенджера
• Авито Бизнес — отдельные мессенджеры на каждое объявление
• Авито для автодилеров — поддержка через тариф «Максимум»

Быстрый старт

OAuth-подключение

Excella запрашивает у Авито scope messenger:read и messenger:write. Refresh-токен обновляется автоматически каждые 22 часа — переподключение не требуется.

Через REST API

curl -X POST https://api.excella.ru/v3/channels/avito/connect \
  -H "Authorization: Bearer $EXCELLA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "abc123",
    "client_secret": "secret_xyz",
    "redirect_uri": "https://app.excella.ru/oauth/callback"
  }'

import { Excella } from "@excella/sdk";

const excella = new Excella(process.env.EXCELLA_TOKEN);

const channel = await excella.channels.avito.connect({
  clientId: "abc123",
  clientSecret: process.env.AVITO_SECRET,
  redirectUri: "https://app.excella.ru/oauth/callback"
});

console.log("Channel:", channel.id);

from excella import Excella

excella = Excella(token=os.environ["EXCELLA_TOKEN"])

channel = excella.channels.avito.connect(
    client_id="abc123",
    client_secret=os.environ["AVITO_SECRET"],
    redirect_uri="https://app.excella.ru/oauth/callback",
)

print(f"Channel: {channel.id}")

Параметры канала

Поля, доступные при настройке канала Avito:

Webhooks

Excella отправляет события на ваш URL. Запросы подписаны HMAC-SHA256 заголовком X-Excella-Signature. Ретраи: 3 попытки с задержкой 5/15/45 секунд.

Пример обработчика

import crypto from "crypto";

app.post("/webhooks/excella", (req, res) => {
  const sig = req.headers["x-excella-signature"];
  const expected = crypto
    .createHmac("sha256", process.env.WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest("hex");

  if (sig !== expected) return res.sendStatus(401);

  const { type, payload } = req.body;
  if (type === "avito.message.received") {
    console.log("New Avito message:", payload.text);
  }
  res.sendStatus(200);
});

Типовые сценарии

Антиспам и лимиты

Тестовый стенд

У Авито есть sandbox-аккаунт sandbox.avito.ru с тестовыми объявлениями. Используйте его, чтобы протестировать сценарии без рисков для боевого профиля.

curl -X POST https://sandbox-api.avito.ru/v1/items \
  -H "Authorization: Bearer $AVITO_TOKEN" \
  -d '{
    "title": "Тестовое объявление",
    "price": 1000,
    "category_id": 24
  }'

curl -X POST https://sandbox-api.avito.ru/v1/messenger/simulate \
  -H "Authorization: Bearer $AVITO_TOKEN" \
  -d '{
    "item_id": "123",
    "text": "А по доставке как?",
    "from": "test_buyer"
  }'

Коды ошибок

FAQ

История изменений

v3.2 · 25.04.2026 — добавлен webhook avito.deal.closed, поддержка sandbox-окружения, улучшено антиспам-перефразирование.

v3.1 · 12.03.2026 — расписание работы бота (office_hours), задержка ответа для имитации живого набора.

v3.0 · 15.01.2026 — первая версия интеграции. OAuth, базовые webhooks, контекст объявления.