Skip to main content
POST
메뉴얼 생성

Authorizations

Authorization
string
header
required

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

Body

application/json

생성할 메뉴얼입니다.

POST /v3/manuals 생성 요청.

name
string
required

사용자에게 표시할 메뉴얼 이름입니다. 1~128자여야 합니다.

Required string length: 1 - 128
trigger
string
default:""

통화 중 이 메뉴얼을 불러오는 자연어 트리거입니다.

content
string
default:""

메뉴얼 지침이며, 이 메뉴얼에서 사용할 항목의 유일한 정본입니다. 조직의 도구와 다른 메뉴얼은 @tool:<uuid>, @manual:<uuid>, @tool:<built-in name> 토큰으로 참조합니다. 이 토큰에서 tool_idslinked_manual_ids를 계산합니다. 모든 built_in_tools 항목은 여기에서 @tool:<name> 토큰으로 호출해야 합니다.

built_in_tools
(EndCallTool · object | TransferCallTool · object | TransferAgentTool · object | SendSmsTool · object | SendDtmfTool · object | SkillTool · object)[]

메뉴얼에 속한 built-in 도구 설정입니다. 각 name^[a-zA-Z_][a-zA-Z0-9_]*$ 형식에 맞고 메뉴얼 안에서 고유해야 합니다. content에서 @tool:<name> 토큰으로 참조해야 합니다.

통화 종료 built-in 도구 설정입니다.

Response

성공 응답

manual 단건 응답(생성·조회·수정). organization_id·is_deleted 미노출.

id
string<uuid>
required

메뉴얼 UUID입니다.

name
string
required

메뉴얼 이름입니다.

trigger
string
required

트리거 문구입니다.

content
string
required

참조 토큰을 원문 그대로 유지한 메뉴얼 지침입니다.

tool_ids
string<uuid>[]
required

연결된 custom 도구 UUID입니다. content@tool:<uuid> 참조에서 계산합니다.

built_in_tools
(EndCallTool · object | TransferCallTool · object | TransferAgentTool · object | SendSmsTool · object | SendDtmfTool · object | SkillTool · object)[]
required

메뉴얼에 속한 built-in 도구 설정입니다.

통화 종료 built-in 도구 설정입니다.

linked_manual_ids
string<uuid>[]
required

연결된 메뉴얼 UUID입니다. content@manual:<uuid> 참조에서 계산합니다.

created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

updated_at
integer
required

리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.