Как подключить Avito к Chatix

Подключение Avito передаёт новые сообщения покупателей из ваших объявлений AI-агенту Chatix. Агент отвечает в том же чате, а диалог появляется в общем helpdesk вместе с обращениями из других каналов.

Chatix поддерживает два способа подключения: вход через Avito в отдельном окне и ручное подключение по client_id и client_secret. Для ручного способа ключи выдаёт сам Avito в профессиональном профиле. Логин и пароль от аккаунта передавать Chatix не нужно.

Что понадобится#

Перед настройкой проверьте:

• у вас профессиональный профиль Avito;
• подключён тариф, в который входит доступ к API сообщений;
• вы вошли под основным аккаунтом компании, а не под профилем сотрудника;
• в Chatix создан и настроен AI-агент;
• в базе знаний есть актуальные ответы о товарах, услугах, доставке и условиях работы.

Avito отдельно указывает, что сообщения можно получать во внешней системе через API, а ключи доступны в разделе для профессионалов. Актуальное описание этой возможности находится на официальной странице Avito о работе с сообщениями.

Если раздел API отсутствует, сначала проверьте тип профиля и состав тарифа. Наличие обычного аккаунта или платного продвижения объявления само по себе не гарантирует доступ к Messenger API.

1. Откройте канал Avito в Chatix#

Откройте нужного агента Chatix, перейдите в раздел Каналы, найдите карточку Avito и нажмите Подключить.

В окне подключения будут доступны два сценария:

1. Продолжить с Avito — авторизация в отдельном окне без ручного копирования ключей.
2. Подключить по API-ключам — ввод client_id и client_secret из кабинета Avito.

Начните с первого варианта. Если в вашей конфигурации Avito авторизация через окно недоступна или вы хотите использовать ключи личного доступа, раскройте ручное подключение.

2. Подключите профиль через окно Avito#

Нажмите Продолжить с Avito. Браузер откроет отдельное окно авторизации. Войдите в основной профессиональный профиль и подтвердите доступ Chatix к профилю и сообщениям.

Для работы канала Chatix запрашивает доступ на чтение и отправку сообщений, а также чтение данных профиля. После подтверждения Avito возвращает одноразовый код. Chatix обменивает его на токены и привязывает канал к выбранному агенту.

Если окно не открылось, разрешите всплывающие окна для Chatix и повторите попытку. Не отключайте защиту браузера целиком: достаточно разрешения для текущего сайта.

3. Получите client_id и client_secret для ручного подключения#

В кабинете Avito откройте раздел Для профессионалов → Интеграции и API. В некоторых версиях интерфейса пункт называется просто API. Прямая страница личного доступа — avito.ru/professionals/api.

Нажмите кнопку получения ключей. Avito покажет два значения:

• client_id — идентификатор доступа;
• client_secret — секрет, который подтверждает право использовать этот доступ.

Скопируйте оба значения без дополнительных пробелов. Не публикуйте client_secret в базе знаний, задачах, переписке или скриншотах. Он даёт программный доступ к профилю в пределах выданных прав.

Если ключи уже использует другая интеграция, не перевыпускайте их без проверки: старое подключение может перестать работать. Для Chatix достаточно действующей пары ключей с доступом к сообщениям.

4. Вставьте ключи в Chatix#

Вернитесь в окно подключения Avito и нажмите Подключить по API-ключам. Заполните поля client_id и client_secret, затем нажмите Подключить по ключам.

Chatix автоматически:

1. Получит временный access token по паре ключей.
2. Запросит данные текущего профиля Avito и проверит, что доступ работает.
3. Сохранит идентификатор и название аккаунта для отображения канала.
4. Зашифрует переданные реквизиты на сервере.
5. Зарегистрирует webhook для новых сообщений.

Вручную создавать webhook, указывать URL сервера или копировать ID профиля не требуется. Если Avito отклонит ключи или не разрешит работу с сообщениями, Chatix покажет ошибку и не оставит канал в частично подключённом состоянии.

5. Проверьте подключение в реальном чате#

После успешного подключения откройте одно из активных объявлений и отправьте сообщение с другого аккаунта Avito. Не проверяйте канал сообщением из того же профиля, к которому привязана интеграция: собственные исходящие события Chatix намеренно пропускает, чтобы не создать цикл ответов.

Для проверки задайте вопрос, который действительно встречается по выбранному объявлению и раскрыт в базе знаний: о наличии, цене, характеристиках, доставке или условиях сделки. Отдельно проверьте уточняющий вопрос в продолжение диалога.

Проверьте четыре результата:

• обращение появилось в helpdesk Chatix;
• в карточке диалога отображаются имя собеседника и объявление, если Avito вернул эти данные;
• агент ответил в чат Avito;
• ответ соответствует опубликованной конфигурации агента и базе знаний.

Какие сообщения обрабатывает канал#

Chatix принимает обычный текст, текст из поддерживаемого сообщения-ссылки и изображения. Входящая картинка сохраняется как вложение, если проходит ограничения Chatix по размеру и MIME-типу.

Системные события, голосовые сообщения, видео, геопозиция и другие типы без извлекаемого текста или поддерживаемого изображения сейчас не запускают ответ агента. Это важно учитывать при тестировании: сначала отправьте обычный текст.

Ответ агента отправляется текстом. Если он длиннее лимита Avito, Chatix автоматически делит его на сообщения до 1000 символов. После обработки канал также пытается отметить чат прочитанным.

Каждый чат по объявлению считается отдельным адресом доставки. Поэтому один покупатель, написавший по двум объявлениям, может появиться в двух разных диалогах — Chatix не смешивает контекст разных сделок.

Что делать, если Avito не подключается#

В кабинете нет API или ключей#

Проверьте, что профиль профессиональный и текущий тариф включает API сообщений. Если пункта всё равно нет, уточните доступность Messenger API у поддержки Avito для вашей категории и тарифа.

Avito отклоняет client_id или client_secret#

Скопируйте ключи заново и проверьте, что не захватили пробел. Убедитесь, что это ключи основного профиля и они не были перевыпущены после копирования.

Окно авторизации не появляется#

Разрешите всплывающие окна для Chatix, отключите блокировку только для текущей попытки и снова нажмите Продолжить с Avito. Если сценарий недоступен, используйте ручное подключение.

Канал подключён, но на сообщение нет ответа#

Отправьте обычный текст с другого аккаунта, проверьте статус канала и наличие кредитов в Chatix. Затем убедитесь, что агент опубликован и нужная информация действительно есть в базе знаний. Для проверки поиска используйте чек-лист диагностики базы знаний.

Чек-лист перед запуском#

• Профиль Avito профессиональный, тариф включает API сообщений.
• Подключён основной аккаунт компании.
• client_secret не попал в документы и скриншоты.
• Тест выполнен с другого аккаунта Avito.
• Входящее сообщение появилось в helpdesk Chatix.
• Ответ вернулся в правильный чат и относится к нужному объявлению.
• Агент знает актуальные условия по объявлениям и не придумывает отсутствующие сведения.
• Команда понимает, какие типы вложений канал пока не обрабатывает.

Описание канала и его задач доступно на странице Avito для Chatix. Перед массовым запуском проверьте несколько объявлений и разные формулировки вопросов.