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으로 보낼 때 필요하며, 지금 처리 중인 입력이어야 합니다. 다른 채팅과 origin=operator에서는 무시합니다.

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

Supabase JWT로 인증할 때 필요한 워크스페이스(organization_id) UUID입니다. 워크스페이스 API 키로 인증하면 그 키의 워크스페이스를 사용합니다.

Path Parameters

chat_id
string<uuid>
required

채팅 ID입니다.

Body

application/json

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

origin
enum<string>
required

메시지를 보내는 쪽입니다. 대화록과 응답의 role이 이 값이 됩니다. operator는 사람 상담사의 답장이며, 사람이 응대 중인 채팅에만 보낼 수 있습니다. 대시보드 로그인 사용자, 워크스페이스 API 키, 워크스페이스 범위 관리자가 보낼 수 있고, 대시보드 사용자가 상담사로 등록되어 있으면 그 상담사가 이 채팅을 응대 중이어야 합니다. system은 안내 메시지이며, 워크스페이스 API 키나 내부 관리자만 보낼 수 있습니다.

Available options:
operator,
system
Example:

"operator"

client_idempotency_key
string
required

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

Required string length: 1 - 128
text
string | null

보낼 메시지 텍스트입니다.

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

저장된 메시지 ID입니다. 대화록 메시지의 id와 같습니다.

chat_id
string
required

채팅 ID입니다.

role
enum<string>
required

대화록에 남는 메시지 역할입니다. origin에 따라 operator 또는 system입니다.

Available options:
operator,
system
content
string
required

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

delivery
ChatOutboundDeliveryResponse · object
required

채널 발송 결과입니다.

attachments
ChatMessageAttachment · object[] | null

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