범용 웹훅
Zapier · Make · n8n · 자체 서버로 JSON POST
웹훅자동화공식
소개
이벤트가 발생하면 등록한 HTTPS URL 로 JSON 을 POST 합니다. 시크릿을 설정하면 모든 요청에 X-Tabple-Signature (HMAC-SHA256) 서명이 붙어 수신 서버가 위조를 걸러낼 수 있습니다. 실패 시 3회까지 재시도하고 전달 로그를 남깁니다.
연결 방법
‘프로젝트에 설치’ 를 누르고 프로젝트를 고른 뒤, 아래 순서대로 받은 주소를 붙이면 끝이에요.
Zapier(Catch Hook) · Make(Webhooks) · n8n(Webhook 노드) 이나 자체 서버에서 JSON POST 를 받을 HTTPS 주소를 만들어요.
주소를 붙이고 받을 이벤트를 골라요. 시크릿을 생성해 두면 요청마다 서명이 붙어요.
수신 측은 X-Tabple-Timestamp 가 ±5분 안인지 보고 v1=HMAC-SHA256(secret, "<ts>.<rawBody>") 를 X-Tabple-Signature 와 비교해요.
- 본문은 모양의 JSON 이고 User-Agent 는 Tabple-Webhook/1.0 이에요.
- 실패하면 2초 · 8초 뒤 최대 3회 다시 보내요. 429 를 뺀 4xx 는 재시도하지 않아요. 시도마다 전달 로그에 남아요.
- 설치 직후 "테스트 메시지 보내기" 로 수신 서버가 200 을 돌려주는지 확인할 수 있어요.