Webhook сообщений Avito: как получать чаты без постоянного опроса

Простыми словами: опрос и webhook

Опрос (polling) — сервис раз в несколько секунд спрашивает Avito: «есть новые чаты?». Пока клиентов мало, это терпимо. Когда кабинетов несколько, вопросов становится много, а лимит API не резиновый. Сообщение может прийти в паузу между опросами.

Webhook — обратная сторона. Вы один раз говорите Avito адрес, на который можно прислать событие. Появилось сообщение — площадка сама отправляет уведомление на этот адрес. Не нужно спрашивать «ну как, уже есть?» каждую секунду.

Это как домофон против привычки каждые десять секунд выглядывать в дверь. Оба способа могут открыть дверь. Домофон спокойнее для всех.

Что именно умеет webhook мессенджера Avito

Речь про Messenger API, не про XML-фид и не про статистику. Webhook подписан на события чатов: новое сообщение, изменение диалога. Объявления от этого сами не публикуются и ставки не меняются.

Чтобы подписка работала, у кабинета должен быть доступ к API мессенджера. Если Avito отвечает 402, webhook не спасёт: площадка не отдаёт чаты по API на текущем тарифе. Сначала доступ, потом адрес уведомлений.

Адрес должен быть доступен из интернета по HTTPS. Локальный компьютер «у меня на ноутбуке» площадка не достучится. Поэтому webhook обычно включает сервис с белым адресом, а не скрипт на домашнем Wi‑Fi.

Чем это лучше постоянного опроса

Меньше лишних запросов. Лимиты API остаются на полезные действия: прочитать историю, отправить ответ, отметить прочитанным. Не тратите квоту на пустые «ничего нового».

Меньше задержка до сигнала. Сообщение не ждёт следующего круга опроса. Для вечерних заявок это разница между ответом за минуту и «увидели, когда открыли ноутбук».

Опрос всё равно полезен как страховка. Сеть бывает, событие может не дойти с первого раза. Нормальная схема: webhook для быстрого сигнала, редкий опрос чтобы ничего не потерять. Не нужно выбирать «только одно навсегда».

Как это выглядит в FeedCRM

FeedCRM читает чаты Avito и может подписаться на webhook, если у сервиса настроен публичный адрес. Вам не нужно вручную собирать URL и вставлять его в консоль Avito: подписка делается из кабинета, когда интеграция это позволяет.

Дальше событие превращается в понятные вещи: чат в разделе «Чаты», при необходимости алерт в Telegram. Telegram здесь не заменяет webhook и не заменяет Avito. Это второй звонок вам в карман: клиент написал — бот коротко сообщил.

Если webhook по какой-то причине не активен, сервис продолжает опираться на опрос. Чаты не «выключаются». Просто сигнал может прийти чуть позже. Это важнее, чем идеальная схема на бумаге.

Telegram-алерты — рядом, но это другой канал

Push в приложении Avito привязан к телефону, в котором вы вошли в кабинет. Удобно одному человеку. Команде неудобно: не видно, кто взял диалог, звук выключен — лид потерян.

Алерт FeedCRM в Telegram приходит в личку или в рабочую группу. Это уведомление о заявке, а не полная копия переписки навсегда. Полную историю смотрите в чатах CRM или в самом Avito. Из уведомления можно быстро ответить, не держа кабинет открытым весь вечер.

Чтобы алерты пошли, нужны три вещи: доступ к messenger API, привязанный Telegram и включённая отправка заявок. Webhook ускоряет доставку сигнала. Он не включает тариф Avito и не привязывает бота за вас.

Что проверить, если «вебхук не работает»

Сначала напишите тестовое сообщение в объявление с другого профиля. Если в веб-интерфейсе Avito чата нет — дело не в webhook. Если чат есть в Avito и пусто в CRM — смотрите ключи, выбранный аккаунт и ошибку 402.

Дальше: привязан ли Telegram и включён ли переключатель заявок. Часто webhook на стороне сервиса живой, а бот просто не должен был писать, потому что заявки выключены.

Не путайте «не пришло в Telegram» и «CRM не видит чат». Это разные слои. Сначала раздел «Чаты» в FeedCRM, потом бот.

• Чаты доступны по API (не 402 и не 401)
• Выбран тот же аккаунт, куда написал клиент
• Telegram привязан, заявки включены
• Тестовое входящее с другого профиля Avito

Безопасность без страшилок

Webhook — это входящий запрос на адрес сервиса. Поэтому адрес не публикуют в открытых чатах, а доступ проверяют секретом в ссылке или подписью. Вам как пользователю FeedCRM достаточно не светить ключи API и не давать посторонним доступ в кабинет.

Не подключайте к кабинету Avito случайные боты с неизвестными правами. Официальный Messenger API плюс понятный сервис, из которого доступ можно отозвать, спокойнее серых скриптов.

Отзыв простой: сменили ключи, отключили приложение, убрали сотрудника из CRM. Не оставляйте бывших подрядчиков в списке пользователей «на всякий случай».

Когда хватит без webhook

Одно объявление, вы сами весь день в приложении Avito — включите push на телефоне. Webhook и CRM здесь избыточны. Скорость ответа важнее архитектуры.

Несколько кабинетов, смена, вечерние пики — вот здесь уведомление о чатах через API и алерт в Telegram начинают экономить сделки. Не потому что «так модно», а потому что иначе сообщение видит только тот, у кого открыт нужный профиль.

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

Как это выглядит для менеджера, без терминов

Клиент пишет в объявление. Avito фиксирует сообщение. Если webhook живой, CRM узнаёт об этом почти сразу: чат всплывает в списке, при необходимости бот пишет в Telegram короткое «новая заявка». Менеджер открывает диалог и отвечает.

Если webhook в эту минуту не дошёл, через короткий опрос чат всё равно появится. Разница — десятки секунд или пара минут, не «вечером когда откроем кабинет». Для клиента важнее сам ответ, чем название протокола.

Не держите два параллельных «источника правды» в голове. Рабочий список диалогов — раздел «Чаты». Telegram — будильник. Avito — площадка, если нужно посмотреть то же глазами клиента.

Команда, ночные дежурства и шум

Одному человеку достаточно личного чата с ботом. Двоим и больше — группа с правилом, кто берёт диалог. Иначе двое ответят одному клиенту, а webhook тут ни при чём: сигнал пришёл нормально, процесс — нет.

Не мешайте в одной ленте заявки, служебные алерты и личные переписки. Отдельная тема или группа «только лиды» снижает шанс, что вечернее сообщение скроется под стикерами.

Ночью имеет смысл либо дежурный с алертом, либо честный автоответ «ответим с утра» в Avito. Webhook не обязан будить всю компанию в три часа, если вы это не настроили.

Чего ждать по задержке

Секунды и пара минут — нормальный коридор. Часы — уже поломка: 401, 402, выключенные заявки, выбран другой аккаунт. Не путайте «сеть моргнула» и «чаты по API закрыты».

После смены тарифа Avito права на мессенджер иногда включаются не мгновенно. Подождите, обновите ключи, повторите тест. Новый webhook на мёртвом доступе не заработает.

Если сомневаетесь, что сигнал идёт, сделайте одно входящее и засеките время до появления в CRM и в Telegram. Это честнее, чем гадать по ощущению «вроде тормозит».