Webhook 개요
ClawOps의 Status Callback, Message Webhook, Transcript Webhook의 동작 방식을 안내합니다.
개요
ClawOps는 통화 및 메시지 관련 이벤트를 실시간으로 알려주는 알림을 제공합니다.
이벤트가 발생하면 설정된 URL로 HTTP POST 요청이 전송되며, 서버는 200 또는 204로 응답합니다.
수신 전화 처리(VoiceML 응답)는 VoiceML 문서를 참고하세요.
종류
Status Callback
통화 상태가 변경될 때마다 (initiated → ringing → answered → completed) 이벤트가 전송됩니다.
calls.create()의 status_callback 파라미터로 통화별 설정합니다.
Message Webhook
문자 메시지(SMS) 관련 이벤트(발송 완료, 실패, 수신)가 발생하면 알림이 전송됩니다.
REST API /v1/accounts/{accountId}/webhooks로 계정 레벨 등록합니다.
Transcript Webhook
통화 전사(STT)가 완료되거나 실패했을 때 알림이 전송되며, 전사 결과 JSON의 GCS 서명 URL이 포함됩니다.
조직 설정 → 통화 받아쓰기 옵션을 활성화해야 동작하는 유료 기능입니다.
REST API /v1/accounts/{accountId}/webhooks로 계정 레벨 등록합니다.
Summary Webhook
통화 받아쓰기 후 LLM 이 생성한 구조화된 요약(Structured Output) 이 완료되거나 실패했을 때 알림이 전송되며, 요약 결과 JSON 문자열이 포함됩니다.
받아쓰기 와 요약 Add-on 이 모두 활성화되어 있어야 동작하는 유료 기능입니다.
REST API /v1/accounts/{accountId}/webhooks로 계정 레벨 등록합니다.
서명 검증
모든 요청에는 X-Signature 헤더가 포함됩니다. 프로덕션 환경에서는 반드시 서명을 검증하세요.
자세한 내용은 서명 검증 가이드를 참고하세요.