Как с помощью вебхуков проверить статус отправленного или полученного fax?

Вебхуки позволяют получать из Fax.Plus обновления в реальном времени об отправленных и полученных fax. Настроив вебхуки, вы можете автоматизировать мониторинг передачи fax и добавить обновления статусов в свои существующие системы.

Настройка вебхуков

1. Откройте панель вебхуков:
   • Войдите в свою учётную запись Fax.Plus.
   • Перейдите в раздел «Интеграции» в меню Настройки.
   • Найдите пункт «Вебхуки» и нажмите Управление.
2. Добавьте эндпоинт:
   • Нажмите Добавить эндпоинт и введите абсолютный URL на вашем сервере, на который будут поступать события.
   • Выберите события, которые хотите получать. Подпишитесь на все события или выберите только нужные из
     каталога событий.
   • Необязательно: настройте фильтр по номеру fax. Привяжите один или несколько своих номеров fax, чтобы получать события только по
     этим номерам.

3. Получайте обновления статуса

   • После настройки Fax.Plus будет отправлять вебхук на указанный вами URL при каждом изменении статуса
     fax.
   • Полезная нагрузка вебхука содержит важные сведения: идентификатор fax, статус, временную метку и
     данные получателя.

   Примечание: если hook.id не равен data.id, выполняется повторная отправка fax. Если hook.id равен data.id, fax отправляется впервые.

4. Проверьте подпись
   • Для каждого созданного эндпоинта автоматически создаётся секрет подписи. С его помощью можно проверять каждый входящий запрос. Подробнее о проверке подписей вебхуков.
5. (Необязательно) Проверьте IP-адреса источника:
   • Можно убедиться, что получаемые вами вебхуки приходят с одного из наших авторизованных IP-адресов:
     • 52.215.16.239
     • 54.216.8.72
     • 63.33.109.123
     • 2a05:d028:17:8000::/56

Устранение неполадок и мониторинг

• Журналы и наблюдаемость: на панели вебхуков отображаются все события и сведения о том, успешно ли они доставлены.
• Повторные попытки: если доставка не удалась, вебхуки автоматически отправляются повторно.
• Повторное воспроизведение: на панели можно также запустить повторную отправку вручную или воспроизвести любые прошлые события за выбранный период.