새 소식: 웹훅이 업데이트되었습니다
이제 웹훅은 더 나은 구성, 전송 로그, 이벤트 재생, 서명 검증 기능을 제공합니다. 2026년 8월 31일 이전에 웹훅을 구성하셨다면 엔드포인트는 계속 작동하지만 2026년 10월 전까지 마이그레이션해야 합니다. 마이그레이션 단계를 따라 진행하실 수 있습니다.
웹훅을 사용하면 Fax.Plus로부터 직접 보낸 fax 및 받은 fax에 대한 실시간 업데이트를 받을 수 있습니다. 웹훅을 구성하면 fax 전송 모니터링을 자동화하고 상태 업데이트를 기존 시스템에 통합할 수 있습니다.
웹훅 구성
- 웹훅 창 열기:
- Fax.Plus 계정에 로그인합니다.
- 설정 아래의 통합 섹션으로 이동합니다.
- 웹훅을 찾아 관리를 클릭합니다.
- 엔드포인트 추가:
- 엔드포인트 추가를 클릭하고 이벤트를 수신할 서버의 절대 URL을 입력합니다.
- 수신할 이벤트를 선택합니다. 모든 이벤트를 구독하거나 이벤트 카탈로그에서 필요한 이벤트만
선택할 수 있습니다. -
선택 사항: fax 번호로 필터링합니다. 하나 이상의 fax 번호를 연결하여 해당 번호에 대한
이벤트만 받을 수 있습니다.
-
상태 업데이트 수신
- 구성이 완료되면 fax 상태가 변경될 때마다 Fax.Plus가 지정한 URL로 웹훅을
보냅니다. - 웹훅 페이로드에는 fax ID, 상태, 타임스탬프, 수신자 정보 등 중요한 세부 정보가
포함됩니다.
참고: hook.id가 data.id와 같지 않으면 fax가 재시도되고 있는 것입니다. hook.id가 data.id와 같으면 fax가 처음으로 전송되고 있음을 나타냅니다.
- 구성이 완료되면 fax 상태가 변경될 때마다 Fax.Plus가 지정한 URL로 웹훅을
- 서명 검증
- 생성된 각 엔드포인트에 대해 서명 시크릿이 자동으로 생성되며, 이를 사용하여 모든 수신 요청을 검증할 수 있습니다. 웹훅 서명 검증에 대해 자세히 알아보세요.
- (선택 사항) 원본 IP 주소 확인:
- 수신한 웹훅이 당사의 승인된 IP 목록에서 발송되었는지 확인할 수 있습니다:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- 수신한 웹훅이 당사의 승인된 IP 목록에서 발송되었는지 확인할 수 있습니다:
문제 해결 및 모니터링
- 로그 및 가시성: 웹훅 패널에서 모든 이벤트와 전송 성공 여부를 확인할 수 있습니다.
- 재시도: 전송에 실패한 경우 웹훅이 자동으로 재시도됩니다.
- 재생: 패널에서 수동으로 재시도를 실행하거나, 선택한 시간 범위 내의 과거 이벤트를 재생할 수도 있습니다.