비볼디 Webhook — 실시간 이벤트 전달
링크 클릭, 쿠폰 사용, 스탬프 적립 이벤트 데이터를 대규모 트래픽 환경에서도 실시간으로 안정적으로 전달합니다.
HMAC-SHA256 서명 검증, 중복 이벤트 방지, 자동 재시도까지 — 별도 설정 없이 엔터프라이즈 수준의 안정성을 바로 사용할 수 있습니다.
비볼디 Webhook이란?
비볼디 Webhook은 이벤트가 발생하는 순간 귀사의 엔드포인트로 데이터를 직접 푸시하는 서버 간 실시간 연동 방식입니다.
별도의 API polling 없이 비볼디에 등록된 엔드포인트로 이벤트 데이터를 즉시 전달하므로 실시간 데이터 연동이 가능합니다.
💡 Webhook을 사용하는 이유는?
API polling 방식은 주기적으로 서버에 요청을 보내야 하므로 불필요한 API 호출이 누적되고 이벤트 감지에 지연이 발생합니다.
비볼디 Webhook은 이벤트가 발생한 그 순간에만 귀사 서버를 호출하므로 불필요한 호출 없이 즉각적인 반응이 가능합니다.
CRM 업데이트, 결제 처리, 마케팅 자동화 등 시간이 중요한 워크플로우에 적합합니다.
비볼디의 Webhook 시스템은 자동 재시도와 전송 보장을 통해 모든 이벤트를 안정적으로 전달합니다.
엔터프라이즈 환경에 맞춰 설계되어 있으며, 모든 페이로드는 HMAC-SHA256 서명 검증을 통해 데이터 위·변조를 원천 차단합니다.
Webhook 동작 방식
비볼디 Webhook은 이벤트 발생 → 서명 생성 → 전송 → 수신 확인의 4단계로 동작합니다.
-
1단계 — 이벤트 감지
링크 클릭, 쿠폰 사용, 스탬프 적립 등 설정한 이벤트가 발생하면 비볼디 시스템이 즉시 감지합니다. -
2단계 — 서명 생성
전송 전 페이로드에 HMAC-SHA256 서명을 생성하여 요청 헤더에 포함합니다.
귀사 서버는 이 서명을 검증해 비볼디에서 발송한 정상 요청인지 확인할 수 있습니다. -
3단계 — HTTPS 전송
서명이 포함된 페이로드를 귀사 엔드포인트로 POST 요청합니다. 전송 실패 시 최대 5회 Exponential Backoff 방식으로 자동 재시도합니다. -
4단계 — 수신 확인 (ACK)
귀사 서버가 200 응답을 반환하면 수신 성공으로 처리됩니다. 응답이 없거나 오류 코드가 반환되면 재시도 큐에 등록됩니다.
Webhook 주요 기능
비볼디 Webhook은 세 가지 핵심 기능으로 엔터프라이즈 환경에서도 안정적으로 운영할 수 있도록 설계되었습니다.
-
실시간 자동화
이벤트 발생 시점과 귀사 시스템의 처리 시점 사이의 지연을 최소화합니다.
사용자가 쿠폰을 사용한 순간 CRM이 업데이트되고, 스탬프가 적립된 즉시 리워드 로직이 실행되는 완전 자동화 파이프라인을 구축할 수 있습니다. -
엔터프라이즈 보안
HMAC-SHA256 서명 외에도 타임스탬프 기반 만료 검증과 고유 이벤트 ID를 조합하여 동일 요청이 두 번 처리되는 재전송 공격을 원천 차단합니다.
서명 검증 구현 방법은 Developer Guide를 참고하세요. -
운영 친화성
엔드포인트 응답 오류 시 재시도 이력, 실패 알림, 자동 비활성화까지 운영 관리 기능이 내장되어 있습니다.
별도 모니터링 시스템 없이도 Webhook 전송 상태를 안정적으로 관리할 수 있습니다.
실시간 자동화
링크 접속, 쿠폰 사용, 스템프 적립 및 혜택 사용을 즉시 반영해 마케팅, CRM, 결제 워크플로우를 자동화하세요.
엔터프라이즈 보안
HMAC-SHA256 서명, 콘텐츠 해시, 타임스탬프 검증으로 링크, 쿠폰, 스템프 이벤트의 위변조와 재생 공격을 차단합니다.
운영 친화성
최소 1회 이상 전달 보장, 자동 재시도, 알림 메일, 비활성화 로직을 통해 링크, 쿠폰, 스템프 이벤트를 장애 상황에서도 안정적으로 처리합니다.
✨ 엔터프라이즈급 실시간 연동
대량의 링크·쿠폰·스탬프 이벤트를 처리하는 엔터프라이즈 환경에 최적화되어 있습니다.
고가용성 인프라와 안정적인 큐잉 메커니즘을 기반으로, 트래픽 급증 상황에서도 이벤트 유실 없이 귀사의 CRM, 결제, 분석 시스템과 안정적으로 연동됩니다.