Кому доступна эта функция?
Доступна на тарифе Enterprise.
Доступна владельцам и администраторам в веб-приложении.
Новое: обновление вебхуков
В вебхуках появились улучшенная настройка, журналы доставки, повторное воспроизведение событий и проверка подписи. Если вы настроили вебхуки до 31 августа 2026 года, ваши эндпоинты продолжают работать. Однако перенести их нужно до 15 января 2027 года. Воспользуйтесь инструкцией по переносу.
Вебхуки позволяют получать из Fax.Plus уведомления в режиме реального времени об отправленных и полученных факсах. Настройте вебхуки, чтобы автоматизировать мониторинг передачи факсов и передавать обновления статусов в ваши системы.
Справочник для разработчиков: полное техническое описание, включая типы событий, структуру полезной нагрузки и проверку подписи, приведено в документации Fax.Plus API по вебхукам.
Настройка вебхуков
- Откройте раздел вебхуков:
- Войдите в свою учётную запись Fax.Plus.
- Перейдите в раздел «Интеграции» в меню Настройки.
- Найдите пункт «Вебхуки» и нажмите Управление.
- Добавьте конечную точку:
- Нажмите Добавить конечную точку и введите абсолютный URL на вашем сервере, на который будут поступать события.
- Выберите события для получения. Можно подписаться на все события или выбрать только нужные в
каталоге событий. -
Необязательно: фильтрация по номеру факса. Привяжите один или несколько своих номеров факса, чтобы получать события только по
этим номерам.
-
Получайте обновления статуса
- После настройки Fax.Plus будет отправлять вебхук на указанный вами URL при каждом изменении
статуса факса. - Полезная нагрузка вебхука содержит основные сведения: идентификатор факса, статус, временную метку и
данные о получателе.
Примечание: если hook.id не равен data.id, факс отправляется повторно. Если hook.id равен data.id, факс отправляется впервые.
- После настройки Fax.Plus будет отправлять вебхук на указанный вами URL при каждом изменении
- Проверьте подпись
- Для каждой созданной конечной точки автоматически создаётся секрет подписи. С его помощью можно проверять каждый входящий запрос. Подробнее о проверке подписей вебхуков.
- (Необязательно) Проверьте IP-адреса источника:
- Можно убедиться, что получаемые вебхуки поступают с одного из наших авторизованных IP-адресов:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- Можно убедиться, что получаемые вебхуки поступают с одного из наших авторизованных IP-адресов:
Устранение неполадок и мониторинг
- Журналы и мониторинг: в панели вебхуков отображаются все события и результат их доставки.
- Повторные попытки: при сбое доставки вебхуки автоматически отправляются повторно.
- Повторное воспроизведение: из панели также можно запустить повторную отправку вручную или воспроизвести любые прошлые события за выбранный период.