Вебхуки
Вебхуки (webhooks) позволяют APX Chat сообщать вашим внешним системам о событиях в реальном времени. Когда происходит что-то важное — например, приходит новое сообщение или меняется сделка, — платформа сама отправляет данные на указанный вами адрес.
Чем вебхуки отличаются от API
- API — вы сами запрашиваете данные, когда они нужны.
- Вебхуки — платформа присылает данные сама, как только наступило событие. Не нужно опрашивать систему в цикле.
Вебхуки удобны, когда важна скорость реакции: например, чтобы мгновенно отразить новое обращение в вашей системе.
Где найти
Откройте Управление → Webhooks. Здесь вы добавляете адреса (endpoint), на которые платформа будет отправлять события.
Как настроить
Откройте раздел
Перейдите в Управление → Webhooks и нажмите «Добавить webhook».
Укажите URL
Введите адрес вашего обработчика — туда будут приходить HTTP-запросы с данными события.
Выберите события
Отметьте, о каких событиях присылать уведомления, чтобы не получать лишний трафик.
Выберите формат
Payload v1 оставлен для совместимости. После активации v2 выбирайте его для новых интеграций: он добавляет ID события и время возникновения и требует secret для подписи.
Сохраните и проверьте
Сохраните настройку и убедитесь, что ваш обработчик принимает запросы и отвечает успехом.
Полный список событий, формат запросов и примеры обработки описаны в технической документации: /docs/webhook.
Адрес вебхука должен быть доступен из интернета и отвечать быстро. Если ваш сервер недоступен или долго не отвечает, система повторит доставку. Обработчик должен дедуплицировать v2-события по ID.
Пример использования
Магазин настраивает вебхук на событие «новое обращение». Как только клиент пишет в любой канал, данные мгновенно уходят во внутреннюю систему магазина — и менеджер видит лид в привычном интерфейсе, не открывая APX Chat.