Skip to main content
POST
위젯 게시 해제

Authorizations

Authorization
string
header
required

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

Path Parameters

widget_id
string<uuid>
required

위젯 ID입니다. public_id가 아니라 GET /v3/widgets 응답의 id를 사용합니다.

Response

성공 응답

id
string<uuid>
required

위젯 ID입니다. UUID이며 경로 파라미터 widget_id에 사용합니다.

public_id
string
required

설치 코드의 data-widget-id입니다. wgt_… 형식이며 서버가 발급하고 읽기 전용입니다.

organization_id
string<uuid>
required

위젯을 소유한 조직 ID입니다.

agent
AgentMapping · object
required

agent_idagent_version으로 구성된 에이전트 매핑 객체입니다.

status
enum<string>
required

위젯 상태입니다. draft, published, archived 중 하나이며 생성·수정 요청에서는 바꿀 수 없습니다.

Available options:
draft,
published,
archived
mode
enum<string>
required

위젯 유형입니다. chat, voice, callback 중 하나입니다.

Available options:
chat,
voice,
callback
callback_from_number
string | null
required

발신번호입니다. 없으면 null입니다.

callback_presentation_number
string | null
required

수신자에게 표시할 번호입니다. null이면 callback_from_number가 표시됩니다.

allowed_domains
string[]
required

설치를 허용한 도메인 목록입니다.

rate_limit
WidgetRateLimit · object | null
required

대화 시작 한도입니다. null이면 standard(방문자 IP당 분당 5회)를 적용합니다.

branding
WidgetBranding · object
required

모양과 메시지 설정입니다. 설정하지 않은 키는 null입니다.

published_at
integer | null
required

마지막 게시 시각입니다. unix milliseconds 형식입니다. 게시를 해제한 뒤에도 유지됩니다. 게시한 적이 없으면 null입니다.

published_version_id
string<uuid> | null
required

마지막 게시 버전 ID입니다. 게시를 해제한 뒤에도 유지됩니다. 게시한 적이 없으면 null입니다.

created_at
integer
required

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

updated_at
integer
required

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