Skip to main content
POST
채팅 outbound 메시지 전송

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Headers

X-Vox-Chat-Turn-Id
integer | null
Required range: 1 <= x <= 9223372036854776000
X-Vox-Organization-Id
string<uuid>

Supabase JWT 인증을 사용할 때 필수인 organization UUID입니다. origin=human은 이 인증 경로만 허용합니다.

Path Parameters

chat_id
string<uuid>
required

Body

application/json

이 엔드포인트의 요청 데이터입니다.

origin
enum<string>
required

메시지를 만든 외부 주체입니다. Public role로 노출하지 않습니다. human은 Supabase JWT와 X-Vox-Organization-Id 헤더가 필요하며, 활성 상담원이 현재 responder인 Chat에서만 사용할 수 있습니다. system은 organization API key 또는 내부 admin만 사용할 수 있습니다.

Available options:
human,
system,
tool
Example:

"human"

client_idempotency_key
string
required

클라이언트가 생성한 outbound 메시지 멱등 키입니다. responder-notice namespace는 내부 전용이라 사용할 수 없습니다.

Required string length: 1 - 128
text
string | null

assistant-side outbound 메시지 텍스트입니다.

Minimum string length: 1
images
(ChatMessageFileKeyImageInput · object | ChatMessageBase64ImageInput · object | ChatMessageUrlImageInput · object)[] | null

선택 이미지 입력입니다. 최대 3장까지 지원합니다.

Maximum array length: 3
navertalk
NavertalkContentDto · object

네이버 전용 TEXT/LINK 버튼 또는 최대 10개 카드. text/images와 함께 지정할 수 없습니다.

Response

성공 응답

id
integer
required

저장된 assistant 메시지 ID입니다.

chat_id
string
required

채팅 ID입니다.

content
string
required

저장된 assistant 메시지 텍스트입니다.

delivery
ChatOutboundDeliveryResponse · object
required

채널 발송 결과입니다.

role
string
default:assistant
Allowed value: "assistant"
attachments
ChatMessageAttachment · object[] | null

저장된 이미지 첨부 목록입니다.