웹훅을 사용해 보내거나 받은 fax의 상태를 확인하려면 어떻게 해야 하나요?

웹훅을 사용하면 Fax.Plus에서 보내거나 받은 fax에 대한 실시간 업데이트를 직접 받을 수 있습니다. 웹훅을 구성하면 fax 전송 모니터링을 자동화하고 상태 업데이트를 기존 시스템에 통합할 수 있습니다.

웹훅 구성

1. 웹훅 패널 열기:
   • Fax.Plus 계정에 로그인합니다.
   • 설정의 통합 섹션으로 이동합니다.
   • 웹훅을 찾아 관리를 클릭합니다.
2. 엔드포인트 추가:
   • 엔드포인트 추가를 클릭하고 이벤트를 수신할 서버의 절대 URL을 입력합니다.
   • 수신할 이벤트를 선택합니다. 모든 이벤트를 구독하거나, 이벤트 카탈로그에서
     필요한 이벤트만 선택할 수 있습니다.
   • 선택 사항: fax 번호별로 필터링합니다. 하나 이상의 fax 번호를 연결하면 해당
     번호의 이벤트만 수신합니다.

3. 상태 업데이트 수신

   • 구성이 완료되면 fax 상태가
     변경될 때마다 Fax.Plus가 지정한 URL로 웹훅을 보냅니다.
   • 웹훅 페이로드에는 fax ID, 상태, 타임스탬프,
     수신자 정보와 같은 중요한 세부 정보가 포함됩니다.

   참고: 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

문제 해결 및 모니터링

• 로그 및 관찰 가능성: 웹훅 패널에서 모든 이벤트와 전송 성공 여부를 확인할 수 있습니다.
• 재시도: 전송에 실패하면 웹훅이 자동으로 재시도됩니다.
• 재생: 패널에서 수동으로 재시도를 실행하거나, 선택한 기간 동안의 과거 이벤트를 재생할 수도 있습니다.