Skip to main content
POST

Authorizations

Authorization
string
header
required

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

Path Parameters

chat_id
string<uuid>
required

채팅 ID입니다.

Body

application/json

AI 에이전트가 응답할 고객 메시지입니다.

text
string
required

고객 메시지 텍스트입니다.

Minimum string length: 1
client_idempotency_key
string
required

채팅 안에서 고객 메시지를 구분하는 멱등 키입니다. 같은 키와 같은 본문을 다시 보내면 AI 에이전트를 다시 실행하지 않고 저장된 결과를 반환합니다. 그 메시지를 아직 처리 중이거나 처리에 실패했으면 409 오류를 반환합니다.

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

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

Required array length: 1 - 3 elements

Response

성공 응답

chat_id
string<uuid>
required

채팅 ID입니다.

chat_status
enum<string>
required

응답 뒤의 채팅 상태입니다. ended면 이번 응답으로 채팅이 끝났습니다.

Available options:
active,
ended
input_message_id
integer
required

AI 에이전트가 처리한 고객 메시지 ID입니다.

output
(ChatTurnAgentMessageResponse · object | ChatToolCallInvocationResponse · object | ChatToolCallResultResponse · object)[]
required

이번 메시지를 처리하며 나온 도구 호출, 도구 결과, AI 에이전트 메시지를 생성 순서대로 담습니다. 이 메시지로 채팅이 끝났으면 AI 에이전트 메시지가 없을 수 있습니다.

Minimum array length: 1