Webhook 생성
- 설정 → API 및 웹훅 → 웹훅으로 이동
- + Webhook 생성 클릭
- 웹훅 URL을 입력하세요(공개적으로 액세스 가능해야 함)
- 저장 클릭
웹훅 관리
편집: 웹훅을 클릭 → URL 업데이트 → 저장 삭제: 웹훅을 클릭 → 삭제 → 확인이벤트
Twenty는 다음 이벤트 유형에 대해 웹훅을 전송합니다:
모든 이벤트 유형은 귀하의 웹훅 URL로 전송됩니다. 이벤트 필터링은 향후 릴리스에서 추가될 수 있습니다.
페이로드 형식
각 웹훅은 JSON 본문을 포함한 HTTP POST를 전송합니다:수신을 확인하기 위해 2xx HTTP 상태(200-299)로 응답하세요. 2xx가 아닌 응답은 전달 실패로 기록됩니다.
웹훅 검증
Twenty는 보안을 위해 각 웹훅 요청에 서명합니다. 요청의 진위를 보장하기 위해 서명을 검증하세요.헤더
검증 단계
X-Twenty-Webhook-Timestamp에서 타임스탬프를 가져옵니다- 다음 문자열을 생성합니다:
{timestamp}:{JSON payload} - 웹훅 비밀을 사용하여 HMAC SHA256을 계산합니다
X-Twenty-Webhook-Signature와 비교합니다
예시(Node.js)
웹훅 vs 워크플로
외부 데이터를 수신하려면 웹훅 트리거 설정을 참조하세요.