비볼디 Webhook — 실시간 이벤트 전달

비볼디 Webhook은 이벤트 발생 → 서명 생성 → HTTPS 전송 → 수신 확인의 4단계로 동작합니다.

전역 Webhook을 설정하는 것만으로는 이벤트가 전송되지 않습니다. 전역 설정에서는 이벤트를 전송할 기본 Callback URL과 Secret Key를 등록합니다. 실제 Webhook은 링크·쿠폰·스탬프 카드에서 Webhook을 활성화한 경우에만 전송됩니다.

링크 그룹·쿠폰 그룹·스탬프 카드에 별도의 Webhook이 설정되어 있다면 해당 설정이 전역 설정보다 우선 적용됩니다. 전역 설정과 개별 설정이 모두 활성화되어 있어도 동일한 이벤트는 한 번만 전송됩니다.

응답 상태 코드가 2xx가 아니거나 5초 이내에 응답하지 않으면 전송 실패로 처리합니다. 실패한 요청은 응답 상태 코드와 관계없이 재시도하므로, 한 번의 전송 실패만으로 Webhook이 중지되지는 않습니다.

전송 실패가 발생해도 Webhook을 즉시 중지하지 않습니다.
먼저 이메일로 실패 사실을 안내한 후 60분의 유예 시간을 제공합니다. 이 시간 안에 수신 서버가 정상화되면 Webhook을 중지하지 않고 전송을 계속합니다.

같은 수신 주소에서 지속적으로 실패가 발생하면 일시적으로 전송을 중단하고, 상태 확인을 위한 테스트 전송으로 서버 복구 여부를 확인합니다.
응답하지 않는 수신 서버에 요청이 계속 누적되지 않도록 관리하며, 고객사의 배포나 일시적인 장애처럼 짧은 중단 상황은 자동으로 정상화됩니다.

쿠폰 사용·스탬프 적립 이벤트는 유실되지 않습니다.
한 번만 발생하는 중요한 이벤트이므로 전송 재시도 또는 호출 제한 상황에서는 대기열에 보관한 후 순서대로 전달합니다.
링크 클릭 이벤트는 반복적으로 발생하며 모든 통계 데이터가 비볼디에 저장되므로, 일시적인 전송 제한 상황에서는 추가 전달하지 않습니다.

대상 Webhook 상태는 3가지로 관리됩니다. 목록 화면의 Webhook 필터를 사용하면 상태별로 대상을 확인할 수 있습니다.

• 사용 중 정상적으로 이벤트가 전송되고 있는 상태입니다.
• 사용 안함 사용자가 직접 비활성화한 상태입니다.
• 시스템 중지 반복적인 전송 실패로 비볼디가 자동으로 중지한 상태입니다. 중지 시점에는 이메일로 안내합니다.

시스템 중지 상태는 수신 서버의 장애 원인을 해결한 후 대시보드에서 다시 활성화할 수 있습니다.
활성화 후에는 새로운 이벤트부터 전송이 재개되며, 중지 상태에서 발생한 이벤트는 이전 정책에 따라 처리됩니다.

Webhook은 프리미엄 요금제 이상에서 사용할 수 있습니다. 제공 개수는 Webhook을 적용할 수 있는 대상 수 기준으로 제한됩니다.

Webhook 호출 한도는 API 호출 한도의 80%로 적용됩니다.
비즈니스 플러스 요금제는 선택한 월 링크 생성 한도에 따라 Webhook 적용 가능 개수가 함께 증가합니다.
엔터프라이즈 요금제는 사용 규모에 따라 별도로 협의하여 제공합니다.
자세한 값은 요금제별 호출 한도에서 확인하세요.

링크 그룹 Webhook은 엔터프라이즈 전용 기능입니다.
그룹 단위로 Webhook을 활성화하면 해당 그룹에 포함된 모든 링크에 동일하게 적용됩니다.

상위 요금제로 변경하면 Webhook 사용 범위가 즉시 확장됩니다.
하위 요금제로 변경하여 현재 한도를 초과하는 대상이 있는 경우, 오래된 대상부터 자동으로 해제되며 해제된 목록은 이메일로 안내합니다.
이용 기간 만료로 무료 요금제로 전환되어도 Webhook 설정은 유지되며, 다시 유료 요금제를 이용하면 별도 설정 없이 재개됩니다.