Новое: обновление веб-хуков
Теперь веб-хуки поддерживают расширенную настройку, журналы доставки, повторную отправку событий и проверку подписи. Если вы настроили веб-хуки до 31 августа 2026 года, ваши конечные точки продолжат работать, но их необходимо перенести до октября 2026 года. Ознакомьтесь с шагами по переносу.
Веб-хуки позволяют получать обновления в режиме реального времени об отправленных и полученных факсах напрямую от Fax.Plus. Настроив веб-хуки, вы можете автоматизировать отслеживание передачи факсов и интегрировать обновления статуса в свои существующие системы.
Настройка веб-хуков
- Откройте панель веб-хуков:
- Войдите в свою учётную запись 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-адресов:
Устранение неполадок и мониторинг
- Журналы и мониторинг: на панели веб-хуков вы можете видеть все события и статус их доставки — успешно или нет.
- Повторные попытки: в случае сбоя доставки Fax.Plus автоматически повторяет отправку веб-хука.
- Повторная отправка: вы также можете запускать повторную отправку вручную с панели или повторно отправлять любые прошлые события за выбранный период времени.