새 소식: 웹훅이 업데이트되었습니다
이제 웹훅에서 향상된 구성, 전송 로그, 이벤트 재생, 서명 확인 기능을 사용할 수 있습니다. 2026년 8월 31일 이전에 웹훅을 구성했다면 기존 엔드포인트는 계속 작동하지만, 2027년 1월 15일 이전에 마이그레이션해야 합니다. 마이그레이션 단계를 따라 진행할 수 있습니다.
웹훅을 사용하면 Fax.Plus에서 보내거나 받은 팩스에 대한 실시간 업데이트를 바로 받을 수 있습니다. 웹훅을 구성하면 팩스 전송 모니터링을 자동화하고 상태 업데이트를 기존 시스템에 통합할 수 있습니다.
개발자 참고 자료: 이벤트 유형, 페이로드 구조, 서명 검증 등 전체 기술 세부 정보는 웹훅에 관한 Fax.Plus API 문서를 참조하세요.
웹훅 구성
- 웹훅 창 열기:
- Fax.Plus 계정에 로그인합니다.
- 설정에서 통합 섹션으로 이동합니다.
- 웹훅을 찾아 관리를 클릭합니다.
- 엔드포인트 추가:
- 엔드포인트 추가를 클릭하고 이벤트를 수신할 서버의 절대 URL을 입력합니다.
- 수신할 이벤트를 선택합니다. 모든 이벤트를 구독하거나 이벤트 카탈로그에서
필요한 이벤트만 선택할 수 있습니다. -
선택 사항: 팩스 번호로 필터링합니다. 보유한 팩스 번호를 하나 이상 연결하면 해당
번호의 이벤트만 수신합니다.
-
상태 업데이트 수신
- 구성이 완료되면 팩스 상태가 변경될 때마다 Fax.Plus가 지정한 URL로
웹훅을 보냅니다. - 웹훅 페이로드에는 팩스 ID, 상태, 타임스탬프, 수신자 정보와 같은 중요한
세부 정보가 포함됩니다.
참고: 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 목록에서 전송된 것인지 검증할 수 있습니다:
문제 해결 및 모니터링
- 로그 및 관측 가능성: 웹훅 패널에서 모든 이벤트와 전송 성공 여부를 확인할 수 있습니다.
- 재시도: 전송에 실패하면 웹훅이 자동으로 재시도됩니다.
- 재생: 패널에서 수동으로 재시도를 실행하거나, 선택한 기간 동안의 과거 이벤트를 재생할 수도 있습니다.