수신 payload

게이트웨이가 여러분의 URL로 보내는 요청의 형식입니다.

요청

POST <내 웹훅 URL>
Content-Type: application/json
X-Bridge-Signature:   v0=<hex>
X-Bridge-Event:       <kind>
X-Bridge-Timestamp:   <unix seconds>
X-Bridge-Delivery-Id: <uuid>

바디 — "신호"

{
  "brand":   "mybrand",
  "userKey": "user_ab12cd34",
  "kind":    "message",
  "seq":     42
}

필드	타입	설명
`brand`	string	브랜드(채널) 키
`userKey`	string	상담 고객 키. 발신 API의 `userKey`와 동일한 상관키
`kind`	string	이벤트 종류(아래 표)
`seq`	number	브랜드 저널의 단조증가 시퀀스. 순서·멱등 판단 기준

바디에 메시지 텍스트가 없습니다

payload는 "무슨 일이 있었다"는 신호이며 메시지 본문(text)을 포함하지 않습니다. 실제 대화 내용이 필요하면 수신 내용 조회 API로 가져오세요. 헤더 X-Bridge-Event는 바디의 kind와 동일합니다.

이벤트 종류 (`kind`)

`kind`	의미	일반적 처리
`message`	고객이 메시지를 보냄	본문 조회 → 처리/답장
`reference`	새 상담이 연결됨(세션 시작)	세션 시작 처리
`expired`	세션이 만료됨	세션 종료 처리
`ended`	상담이 종료됨	세션 종료 처리
`agent`	여러분(또는 상담사)의 발신이 반영됨(echo)	보통 무시

self-echo 필터링

kind: "agent" 는 여러분이 보낸 발신이 되돌아온 echo입니다. 답장 로직이 이 이벤트에 반응하면 무한 루프가 됩니다 — agent는 걸러내세요.

상관 관계

수신 신호의 userKey = 답장 발신(POST /api/agent/send)의 userKey.
brand = 발신·조회의 brandKey.
세션 단위 식별은 필요하지 않습니다 — userKey 하나로 대화를 잇습니다.

요청​

바디 — "신호"​

이벤트 종류 (kind)​

상관 관계​

요청

바디 — "신호"

이벤트 종류 (`kind`)

상관 관계