Webhooks란 무엇인가요?
웹훅은 Mercateer 프런트오피스 이벤트를 실시간으로 사용자가 제어하는 URL로 푸시하므로 자체 시스템이 API 폴링 없이 반응할 수 있습니다. 각 전달은 HMAC으로 서명된 JSON 페이로드이며, 엔드포인트는 API 또는 대시보드에서 등록 및 관리됩니다. 전달 실패 시 백오프와 함께 재시도됩니다.
Webhooks으로 할 수 있는 일
신규 리드 수집 및 연락처 생성
대화 시작, 종료 또는 상담원 연결 요청
통화 완료
약속 예약 및 약속 재예약
견적 수락
수신 시 HMAC 서명된 페이로드를 검증
API 또는 대시보드에서 엔드포인트 등록 및 관리
몇 분 만에 설치
1
엔드포인트 생성하기
API 또는 [설정] > [개발자]에서 URL을 등록하고 구독할 이벤트를 선택하세요. Mercateer는 해당 엔드포인트의 서명 비밀키를 반환합니다. API 접근 권한은 Crew 및 Fleet 요금제에 포함되어 있습니다.
2
서명 검증하기
전달될 때마다 서명 헤더에서 타임스탬프(t)와 서명(v1)을 읽고, 서명 시크릿으로 "{timestamp}.{raw request body}" 문자열의 HMAC-SHA256을 계산해 v1 값과 비교하세요. 값이 맞지 않거나 타임스탬프가 5분 넘게 지난 요청은 거부해서, Mercateer에서 실제로 온 최신 페이로드에만 반응하도록 하세요. (저희 SDK의 verify 헬퍼가 이 과정을 대신 처리해 줍니다.)
3
재시도를 멱등하게 처리하기
전달을 확인하기 위해 빠르게 2xx 응답을 반환하세요. 전달 실패 시 백오프와 함께 재시도되므로, 핸들러를 이벤트 ID 기준으로 구성해 중복을 무시하고 각 이벤트를 한 번만 처리하세요.
자주 묻는 질문
전체 스택과 호환됩니다
Mercateer는 이미 사용 중인 도구들과 동일한 프로토콜을 지원합니다.