Webhook

상담원 연결, 새 메시지, 대화 종료, 티켓 및 문서 처리 등의 이벤트 푸시와 서명 검증 및 재시도 규칙을 다룹니다.

백오피스의 「봇 설정」에서 webhook 주소를 입력하세요. 요청 헤더:

헤더	설명
`X-AICS-Event-Id`	이벤트 ID, 이를 기준으로 중복 제거
`X-AICS-Timestamp` / `X-AICS-Signature`	서명 검증 방법은 주문 조회 인터페이스와 동일

요청 본문: {"id", "type", "created_at", "data"}.

이벤트	발생 시점
`conversation.handoff`	상담원 연결 (상담원 연결 방식에서 「내 시스템으로 푸시」 또는 「양쪽 모두 알림」을 선택한 경우)
`conversation.message`	상담원 모드에서 고객이 새 메시지를 보낸 경우
`conversation.closed`	대화 종료 (`data.conversation.closed_by`는 누가 종료했는지 나타냄)
`conversation.rated`	고객이 종료된 대화를 평가한 경우: `data.rating`, `data.comment`
`ticket.created`	새 티켓 (상담원 부재 시 고객의 메시지 포함): `data.ticket`, `data.description`
`ticket.updated`	티켓 상태, 우선순위, 담당자 등 변경: `data.changes`는 `{字段: [旧, 新]}` 형식
`ticket.replied`	상담원이 고객에게 답변한 경우: `data.reply`
`document.ready` / `document.failed`	문서 처리 완료 또는 실패

2xx를 반환하면 성공으로 간주하며, 그렇지 않으면 30초, 2분, 10분…… 최대 12시간까지 백오프 재시도하며 총 8회 수행합니다. 순서는 보장되지 않습니다.

이 페이지가 도움이 되었나요?

마지막 업데이트: 2026년 10월 31일