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

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Headers

X-Vox-Chat-Turn-Id
integer | null

에이전트가 지금 처리 중인 입력 ID입니다. 네이버톡톡 채팅에 origin=system으로 보낼 때 필요하고 그 밖의 요청에서는 쓰지 않으며, 에이전트 도구에서는 시스템 변수 {{chat_turn_id}}를 넣습니다.

Required range: 1 <= x <= 9223372036854776000
X-Vox-Organization-Id
string<uuid>

Supabase JWT로 인증할 때 필요한 워크스페이스(organization_id) UUID입니다. origin=human은 이 인증 방식만 허용합니다.

Path Parameters

chat_id
string<uuid>
required

메시지를 보낼 채팅 ID입니다.

Body

application/json

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

origin
enum<string>
required

메시지를 만든 주체입니다. human은 Supabase JWT와 X-Vox-Organization-Id 헤더가 필요하고 이 채팅을 지금 응대 중인 활성 상담사만 쓸 수 있으며, system은 워크스페이스 API 키나 내부 관리자 인증으로만 쓸 수 있습니다.

Available options:
human,
system,
tool
Example:

"human"

client_idempotency_key
string
required

클라이언트가 만든 메시지 멱등 키입니다. responder-notice:로 시작하거나 :responder-notice:가 들어간 키는 내부 전용이라 쓸 수 없습니다.

Required string length: 1 - 128
text
string | null

보낼 메시지 텍스트입니다. navertalk을 쓰지 않으면 text와 images 중 하나 이상이 필요합니다.

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

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

Maximum array length: 3
navertalk
NavertalkContentDto · object

네이버톡톡 전용 메시지입니다. 퀵 버튼을 붙인 텍스트나 카드(최대 10개)를 보낼 때 쓰며, text·images와 함께 지정할 수 없습니다.

Response

성공 응답

id
integer
required

저장된 메시지 ID입니다.

chat_id
string
required

채팅 ID입니다.

content
string
required

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

delivery
ChatOutboundDeliveryResponse · object
required

채널 발신 결과입니다.

role
string
default:assistant

저장된 메시지의 역할입니다. 항상 assistant입니다.

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

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