Skip to main content
POST
메시지 직접 전송

Authorizations

Authorization
string
header
required

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

Headers

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

AI 에이전트가 응답 중인 고객 메시지의 ID입니다. 네이버톡톡과 위챗 채팅에 origin=system으로 보낼 때 필요하며, 누락되면 400 NAVERTALK_SOURCE_REQUIRED 또는 WECHAT_SOURCE_REQUIRED를 반환합니다. AI 에이전트가 더 이상 해당 메시지를 처리하지 않거나 그 뒤에 고객 메시지, 안내, 상담사 답장이 들어왔으면 409 CHAT_TURN_SUPERSEDED를 반환합니다. 다른 채널에서는 무시합니다. AI 에이전트가 응답 중인 고객 메시지의 ID입니다. 네이버톡톡과 위챗 채팅에 origin=system으로 보낼 때 필요하며, ID가 없으면 400 NAVERTALK_SOURCE_REQUIRED 또는 WECHAT_SOURCE_REQUIRED를 반환합니다. AI 에이전트가 더 이상 해당 메시지를 처리하지 않거나 그 뒤에 고객 메시지, 안내, 상담사 답장이 들어왔으면 409 CHAT_TURN_SUPERSEDED를 반환합니다. 다른 채널에서는 무시합니다.

Required range: 1 <= x <= 9223372036854776000
X-Vox-Organization-Id
string<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

같은 메시지를 두 번 보내지 않도록 메시지마다 정하는 멱등 키입니다. responder-notice:로 시작하거나 :responder-notice:를 포함하는 값은 쓸 수 없습니다.

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

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