Инструкции по использованию

Полное руководство по настройке и использованию ShopDialog для Авито

Что такое ShopDialog?

ShopDialog — это интеллектуальный помощник для автоматизации работы с клиентами на Авито. Он отвечает на сообщения покупателей, помогает с выбором товаров и повышает конверсию ваших магазинов.

ИИ-консультант

Умные ответы на основе вашего каталога и промпта

Аналитика

Подробная статистика работы и подсказки по оптимизации

Уведомления

Email-уведомления о важных событиях

24/7

Работает круглосуточно без выходных

1 Создание магазина

Перейдите в раздел "Мои магазины" и нажмите "Создать магазин". Введите название вашего магазина Авито.

2 Настройка авторизации

В настройках магазина введите данные API Авито или пройдите OAuth авторизацию для подключения вашего аккаунта.

3 Настройка промпта

Создайте уникальный промпт для ИИ-консультанта, который будет отвечать вашим клиентам на Авито в вашем стиле.

4 Загрузка каталога

Загрузите CSV каталог ваших товаров с Авито для более точных ответов консультанта на вопросы покупателей.

5 Активация

Активируйте магазин и начните получать автоматические ответы на сообщения клиентов.

Готово! Ваш ИИ-консультант теперь работает и отвечает клиентам автоматически.

Настройка магазина Avito

Особенности Avito: Полная интеграция с каталогом товаров, OAuth2 авторизация, загрузка CSV каталога.

1 Регистрация приложения

Перейдите на developers.avito.ru и создайте новое приложение:

Название: "ShopDialog"
Описание: "Автоматический консультант для магазина"
Redirect URI: https://shopdialog.shop/marketplace//oauth/callback/

Доступы приложения. Оставьте messenger (чтение и запись), items:info, user:read, stats:read. Снимите job:*, short_term_rent:*, items:apply_vas, user_balance:read и user_operations:read — это не оплата покупателя и бот ими не пользуется.

Текст для поля «Зачем вам нужен доступ»:

Приложение avito_bot — ИИ-консультант продавца в мессенджере Авито. Оно отвечает покупателям по объявлениям магазина от имени владельца: читает входящие сообщения, подставляет карточку текущего лота и отправляет ответ в тот же чат.

Нужны доступы:
• messenger:read и messenger:write — получать сообщения покупателей и отвечать в чатах объявлений;
• items:info — брать название, цену, описание и статус объявления, по которому идёт диалог, чтобы не выдумывать характеристики;
• user:read — определить аккаунт продавца и привязать магазин в нашем сервисе;
• stats:read — показывать владельцу статистику объявлений в личном кабинете сервиса.

Приложение не работает с вертикалью «Работа», краткосрочной арендой и не применяет платные услуги к объявлениям, поэтому job:*, short_term_rent:* и items:apply_vas не запрашиваем.

user_balance:read и user_operations:read — это кошелёк продавца и история списаний за услуги Авито, а не оплата товара покупателем. Для консультанта в чате они не нужны. Оплату покупателя бот видит по служебным сообщениям мессенджера (Авито Доставка), без доступа к операциям кошелька.

Персональные данные из чатов используем только чтобы ответить покупателю и при готовой сделке уведомить владельца магазина. Данные не продаём и не передаём третьим лицам.

2 Получение данных

После создания приложения скопируйте:

Client ID: abc123...
Client Secret: def456...
                

3 Настройка в системе

В настройках магазина введите полученные данные и нажмите "Авторизоваться через Avito".

4 Загрузка каталога

Подготовьте CSV файл с товарами в формате:

Название,Цена,Описание,Категория,Фото
Товар 1,1000,Описание товара,Категория 1,https://example.com/photo1.jpg
Товар 2,2000,Описание товара,Категория 2,https://example.com/photo2.jpg
                

Важно: Токены Avito обновляются автоматически. Не нужно обновлять их вручную.

Баланс токенов ИИ и тариф

Как устроено сейчас. Запросы к нейросети выполняются через инфраструктуру сервиса одним платформенным API-ключом. Отдельный ключ модели в настройках магазина не вводится. Вы пополняете баланс магазина в рублях, с него списывается стоимость по факту использованных токенов. Тариф: 500 ₽ за 1 000 000 токенов суммарного расхода (входящие и исходящие вместе). Отдельной ежемесячной абонентской платы за сам сервис нет. На первый магазин нового аккаунта начисляется 200 ₽ пробного баланса ИИ.

Шаг 1 — Пополните баланс

1 Страница оплаты магазина

В панели управления откройте магазин и перейдите в раздел оплаты / пополнения баланса ИИ. Выберите сумму в допустимых пределах и оплатите удобным способом (карта, СБП и т.д. — в зависимости от платёжного провайдера). После успешной оплаты рубли зачисляются на баланс токенов ИИ магазина.

2 Следите за остатком

На дашборде и в настройках магазина отображается текущий баланс. При нулевом или недостаточном балансе ответы покупателям не отправляются — пополните баланс заранее.

Шаг 2 — Проверка работы

3 Тестовое сообщение

Убедитесь, что магазин активен, OAuth Avito настроен и на балансе есть средства. Напишите тестовое сообщение с другого аккаунта Avito — если бот ответил, цепочка работает. Расход токенов и списания в рублях отражаются в статистике магазина.

Возврат: средства, зачисленные на баланс токенов ИИ, возврату не подлежат, кроме случаев, прямо предусмотренных законом — см. пользовательское соглашение (раздел 4.3).

Вопросы по оплате и настройке: +7 (967) 731-11-55 (Пн–Пт 9:00–18:00), email: AvitoBot-AI@yandex.ru

Частые вопросы и решения

Как бот защищён от глюков: он отвечает не чаще одного раза в минуту на один чат, не отвечает на системные уведомления Авито (статусы доставки и оплаты — только короткое подтверждение оплаты один раз), не отправляет один и тот же ответ дважды и игнорирует сообщения старше суток.

1 Бот не отвечает покупателям

Проверьте по порядку:

Баланс ИИ — при нуле ответы останавливаются (придёт уведомление). Пополните баланс;
Магазин активен — статус в разделе «Мои магазины»;
Токен Avito — в настройках магазина нажмите «Обновить токен», если он истёк;
Объявление активно — бот отвечает только по активным объявлениям;
Последнее сообщение в чате — от покупателя: если вы уже ответили вручную, бот не будет дублировать ответ;
Свежесть — сообщения старше 24 часов бот не трогает, чтобы не пугать клиентов.

2 Покупатель пишет несколько сообщений подряд

Это нормальная ситуация. Бот ждёт 12 секунд, собирает все сообщения в одну мысль и отвечает на всё сразу — как живой человек, который дочитал и ответил одним сообщением. Первое «привет, а ещё...» подождёт чуть дольше обычного.

3 Оплата через Авито прошла — что напишет бот?

На оплату бот реагирует один раз: коротко благодарит и говорит, что дальше — самовывоз, ваша отправка или Авито Доставка (по правилам из вашего промпта). Дальнейшие служебные статусы доставки («соберите заказ», «курьер заберёт») бот не комментирует, чтобы не спамить покупателя.

4 Можно ли отвечать вручную параллельно с ботом?

Да. Если вы ответили в чате сами, бот видит, что последнее сообщение — ваше, и не вмешивается, пока покупатель снова не напишет. Это работает в реальном времени.

5 Как пользоваться с телефона

Панель адаптирована для смартфона: мобильное меню, крупные кнопки, уведомления всплывают снизу экрана. Управляйте магазином, балансом и настройками прямо из телефона — тема оформления (светлая/тёмная) переключается кнопкой с луной в шапке.

Важно: бот не выдумывает факты. Нет информации в объявлении или промпте — он так и скажет покупателю. Заполните описание объявлений и промпт магазина, чтобы ответы были точнее.

Не нашли решение? Напишите в чат поддержки (кнопка «Чат» в шапке) — ответим быстро.

Полезные советы

Настройка промпта

Создайте уникальный промпт, который отражает стиль общения вашего магазина. Используйте JSON формат для структурирования:

{
  "role": "Консультант магазина",
  "style": "Дружелюбный и профессиональный",
  "knowledge": "Товары и услуги магазина",
  "instructions": [
    "Отвечай кратко и по делу",
    "Предлагай альтернативы",
    "Всегда будь вежливым"
  ]
}
                

Мониторинг работы

Регулярно проверяйте дашборд для анализа работы консультанта. Обращайте внимание на подсказки системы по оптимизации.

Email-уведомления

Укажите email для уведомлений в настройках магазина. Карточка заказа также появляется в личном кабинете (колокольчик на «Мои магазины»). При необходимости можно добавить Telegram Chat ID как дополнительный канал.

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