> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 메시지 직접 전송

> AI 에이전트 응답 없이 고객에게 메시지 한 건을 채팅의 채널로 보냅니다.

- `origin=operator`는 상담사 답장을 보냅니다. 워크스페이스 API 키를 사용할 때는 API 키로 `POST /chats/{chat_id}/takeover`를 호출한 뒤이거나 `initial_responder_type=operator`로 생성된 경우처럼 지정된 상담사 없이 사람이 응대 중인 채팅이어야 합니다. AI 에이전트나 지정된 상담사가 응대 중인 채팅은 403 CHAT_RESPONDER_MISMATCH를 반환합니다. 이미 처리된 요청은 응답 담당이 바뀐 뒤에도 같은 `client_idempotency_key`에 대해 저장된 결과를 반환합니다.
- `origin=system`은 안내를 보내며 워크스페이스 API 키가 필요합니다.

보낸 메시지는 대화록에 `origin`과 같은 `role`로 남습니다.



## OpenAPI

````yaml /api-reference/v3/openapi.json post /chats/{chat_id}/outbound-messages
openapi: 3.1.0
info:
  title: vox.ai API
  description: >
    vox.ai API v3


    ### v3 공개 계약 규칙


    - 인증은 `Authorization: Bearer <token>` 헤더를 사용합니다. 워크스페이스 API 키를 Bearer 토큰으로
    전달합니다.

    - 요청과 응답 필드는 기본적으로 `snake_case`를 사용합니다.

    - 에이전트 `data`는 `callSettings`, `toolIds`, `builtInTools`,
    `presetDynamicVariables` 같은 `camelCase` 필드 이름을 사용합니다.

    - `_at`으로 끝나는 타임스탬프는 unix milliseconds입니다. 일부 입력값은 호환성을 위해 10~11자리 unix
    seconds도 허용하고 milliseconds로 정규화합니다.

    - 대량 발신 통화 가능 시간은 분 단위 정수(`start_min` / `end_min`)를 사용합니다. 알림 스케줄은 `HH:MM`
    문자열(`start_time` / `end_time`)을 사용합니다.

    - 응답 객체 자신의 식별자는 `id`입니다. 다른 리소스를 참조하는 필드와 path parameter는 `agent_id`,
    `call_id`, `telephone_line_id`처럼 명시적인 이름을 사용합니다.

    - 실패 응답은 `{ "error": { "code", "message", "details" } }` 형태입니다. 가능한 경우
    `details.field`, `details.reason`, `details.allowed_values`를 함께 제공합니다.
  version: 3.0.0
servers:
  - url: https://client-api.tryvox.co/v3
    description: 운영
security: []
paths:
  /chats/{chat_id}/outbound-messages:
    post:
      tags:
        - Chats
      summary: 메시지 직접 전송
      description: >-
        AI 에이전트 응답 없이 고객에게 메시지 한 건을 채팅의 채널로 보냅니다.


        - `origin=operator`는 상담사 답장을 보냅니다. 워크스페이스 API 키를 사용할 때는 API 키로 `POST
        /chats/{chat_id}/takeover`를 호출한 뒤이거나 `initial_responder_type=operator`로
        생성된 경우처럼 지정된 상담사 없이 사람이 응대 중인 채팅이어야 합니다. AI 에이전트나 지정된 상담사가 응대 중인 채팅은 403
        CHAT_RESPONDER_MISMATCH를 반환합니다. 이미 처리된 요청은 응답 담당이 바뀐 뒤에도 같은
        `client_idempotency_key`에 대해 저장된 결과를 반환합니다.

        - `origin=system`은 안내를 보내며 워크스페이스 API 키가 필요합니다.


        보낸 메시지는 대화록에 `origin`과 같은 `role`로 남습니다.
      operationId: createChatOutboundMessage
      parameters:
        - name: chat_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Chat Id
            description: 채팅 ID입니다.
          description: 채팅 ID입니다.
        - name: X-Vox-Chat-Turn-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 9223372036854776000
                minimum: 1
              - type: 'null'
            description: >-
              AI 에이전트가 응답 중인 고객 메시지의 ID입니다. 네이버톡톡과 위챗 채팅에 `origin=system`으로 보낼 때
              필요하며, ID가 없으면 400 NAVERTALK_SOURCE_REQUIRED 또는
              WECHAT_SOURCE_REQUIRED를 반환합니다. AI 에이전트가 더 이상 해당 메시지를 처리하지 않거나 그 뒤에
              고객 메시지, 안내, 상담사 답장이 들어왔으면 409 CHAT_TURN_SUPERSEDED를 반환합니다. 다른
              채널에서는 무시합니다.
            title: X-Vox-Chat-Turn-Id
          description: >-
            AI 에이전트가 응답 중인 고객 메시지의 ID입니다. 네이버톡톡과 위챗 채팅에 `origin=system`으로 보낼 때
            필요하며, 누락되면 400 NAVERTALK_SOURCE_REQUIRED 또는 WECHAT_SOURCE_REQUIRED를
            반환합니다. AI 에이전트가 더 이상 해당 메시지를 처리하지 않거나 그 뒤에 고객 메시지, 안내, 상담사 답장이 들어왔으면
            409 CHAT_TURN_SUPERSEDED를 반환합니다. 다른 채널에서는 무시합니다.
        - name: X-Vox-Organization-Id
          in: header
          required: false
          description: API 키로 인증하면 보내지 않아도 됩니다. 그 키의 워크스페이스를 사용합니다.
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateChatOutboundMessageRequest'
        description: 이 엔드포인트의 요청 데이터입니다.
      responses:
        '201':
          description: 성공 응답
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateChatOutboundMessageResponse'
        '400':
          description: 요청 검증 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                validationError:
                  summary: 요청 검증 오류
                  value:
                    error:
                      code: VALIDATION_ERROR
                      message: Request validation failed.
                      details:
                        field: name
                        reason: must not be blank
        '401':
          description: 인증이 필요합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unauthorized:
                  summary: Bearer 토큰 누락 또는 오류
                  value:
                    error:
                      code: UNAUTHORIZED
                      message: Authentication is required.
                      details: {}
        '403':
          description: 권한이 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                forbidden:
                  summary: 권한이 없습니다.
                  value:
                    error:
                      code: FORBIDDEN
                      message: Permission denied.
                      details: {}
        '404':
          description: 리소스를 찾을 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                notFound:
                  summary: 채팅을 찾을 수 없음
                  value:
                    error:
                      code: CHAT_NOT_FOUND
                      message: 채팅을 찾을 수 없습니다.
                      details:
                        chat_id: 22222222-2222-4222-8222-222222222222
        '409':
          description: 충돌이 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                conflict:
                  summary: 상태 충돌이 발생했습니다.
                  value:
                    error:
                      code: CONFLICT
                      message: The requested operation conflicts with current state.
                      details:
                        current_status: draft
        '413':
          description: 요청 본문이 너무 큽니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                payloadTooLarge:
                  summary: 채팅 JSON 요청 본문이 10 MiB 제한을 초과함
                  value:
                    error:
                      code: PAYLOAD_TOO_LARGE
                      message: 요청 본문이 허용 크기를 초과했습니다.
                      details:
                        content_length: 11534336
                        max_bytes: 10485760
        '422':
          description: 요청 검증 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unprocessableEntity:
                  summary: 처리할 수 없는 요청입니다.
                  value:
                    error:
                      code: CONVERTED_FILE_TOO_LARGE
                      message: Converted image size exceeds the 1 MB limit.
                      details:
                        converted_size_bytes: 1258291
                        max_bytes: 1048576
        '429':
          description: >-
            요청 한도를 초과했습니다. 워크스페이스 API 키는 워크스페이스 플랜의 요청 한도를 공유하며, 플랜 한도가 없으면 기본값은
            초당 5회·분당 120회입니다. 이 공용 한도로 발생한 429 응답에는 X-RateLimit-Limit,
            X-RateLimit-Window, Retry-After 헤더가 포함됩니다. 엔드포인트별 한도에서는 이 헤더 중 일부 또는
            전체가 없을 수 있습니다.
          headers:
            Retry-After:
              description: 재시도하기 전에 기다려야 하는 시간입니다. 단위는 초입니다.
              schema:
                type: integer
                minimum: 1
            X-RateLimit-Limit:
              description: 윈도우에서 허용되는 최대 요청 수입니다.
              schema:
                type: integer
                minimum: 1
            X-RateLimit-Window:
              description: 윈도우의 길이입니다. 단위는 초입니다.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                rateLimited:
                  summary: 요청 한도를 초과했습니다.
                  value:
                    error:
                      code: RATE_LIMIT_EXCEEDED
                      message: Too many requests.
                      details:
                        limit: 5
                        window_seconds: 1
                        scope: org
        '500':
          description: 서버 내부 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                internalError:
                  summary: 서버 내부 오류가 발생했습니다.
                  value:
                    error:
                      code: INTERNAL_ERROR
                      message: Internal server error.
                      details: {}
        '503':
          description: 서비스를 일시적으로 사용할 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                serviceUnavailable:
                  summary: 서비스를 일시적으로 사용할 수 없습니다.
                  value:
                    error:
                      code: SERVICE_UNAVAILABLE
                      message: Service temporarily unavailable.
                      details: {}
      security:
        - BearerAuth: []
components:
  schemas:
    CreateChatOutboundMessageRequest:
      properties:
        origin:
          type: string
          enum:
            - operator
            - system
          title: Origin
          description: >-
            메시지를 보내는 쪽이며 대화록과 응답의 `role`이 이 값이 됩니다. `operator`는 상담사의 답장입니다.
            워크스페이스 API 키로는 배정된 상담사 없이 사람이 응대 중인 채팅에만 보낼 수 있습니다. `system`은 안내
            메시지이며 워크스페이스 API 키로 보냅니다.
          examples:
            - operator
        text:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          title: Text
          description: 보낼 메시지 텍스트입니다.
        images:
          anyOf:
            - items:
                oneOf:
                  - $ref: '#/components/schemas/ChatMessageFileKeyImageInput'
                  - $ref: '#/components/schemas/ChatMessageBase64ImageInput'
                  - $ref: '#/components/schemas/ChatMessageUrlImageInput'
                discriminator:
                  propertyName: type
                  mapping:
                    base64: '#/components/schemas/ChatMessageBase64ImageInput'
                    file_key: '#/components/schemas/ChatMessageFileKeyImageInput'
                    url: '#/components/schemas/ChatMessageUrlImageInput'
              type: array
              maxItems: 3
            - type: 'null'
          title: Images
          description: 선택 이미지 입력입니다. 최대 3장까지 지원합니다.
        navertalk:
          anyOf:
            - $ref: '#/components/schemas/NavertalkContent'
            - type: 'null'
          description: 네이버 전용 TEXT/LINK 버튼 또는 최대 10개 카드입니다. text/images와 함께 지정할 수 없습니다.
        client_idempotency_key:
          type: string
          maxLength: 128
          minLength: 1
          title: Client Idempotency Key
          description: >-
            같은 메시지를 두 번 보내지 않도록 메시지마다 정하는 멱등 키입니다. `responder-notice:`로 시작하거나
            `:responder-notice:`를 포함하는 값은 쓸 수 없습니다.
      additionalProperties: false
      type: object
      required:
        - origin
        - client_idempotency_key
      title: CreateChatOutboundMessageRequest
    CreateChatOutboundMessageResponse:
      properties:
        id:
          type: integer
          title: Id
          description: 저장된 메시지 ID입니다. 대화록 메시지의 id와 같습니다.
        chat_id:
          type: string
          title: Chat Id
          description: 채팅 ID입니다.
        role:
          type: string
          enum:
            - operator
            - system
          title: Role
          description: 대화록에 남는 메시지 역할입니다. `origin`에 따라 `operator` 또는 `system`입니다.
        content:
          type: string
          title: Content
          description: 저장된 메시지 텍스트입니다.
        attachments:
          anyOf:
            - items:
                $ref: '#/components/schemas/ChatMessageAttachment'
              type: array
            - type: 'null'
          title: Attachments
          description: 저장된 이미지 첨부 목록입니다.
        delivery:
          $ref: '#/components/schemas/ChatOutboundDeliveryResponse'
          description: 채널 발신 결과입니다.
      type: object
      required:
        - id
        - chat_id
        - role
        - content
        - delivery
      title: CreateChatOutboundMessageResponse
    ErrorResponse:
      type: object
      required:
        - error
      title: ErrorResponse
      description: 모든 실패 요청에서 반환되는 오류 본문입니다.
      examples:
        - error:
            code: VALIDATION_ERROR
            message: Request validation failed.
            details:
              field: name
              reason: must not be blank
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: 오류 payload입니다.
    ChatMessageFileKeyImageInput:
      properties:
        type:
          type: string
          const: file_key
          title: Type
          description: 기존 업로드 파일 키를 사용하는 이미지 입력입니다.
        file_key:
          type: string
          minLength: 1
          title: File Key
          description: '`POST /files`에서 받은 기존 업로드 파일 키입니다.'
          examples:
            - file_abc123
      type: object
      required:
        - type
        - file_key
      title: ChatMessageFileKeyImageInput
    ChatMessageBase64ImageInput:
      properties:
        type:
          type: string
          const: base64
          title: Type
          description: base64 데이터를 직접 보내는 이미지 입력입니다.
        mime_type:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          title: Mime Type
          description: 클라이언트가 선언한 MIME 타입입니다.
          examples:
            - image/jpeg
        data:
          type: string
          minLength: 1
          title: Data
          description: base64 이미지 데이터입니다.
      type: object
      required:
        - type
        - data
      title: ChatMessageBase64ImageInput
    ChatMessageUrlImageInput:
      properties:
        type:
          type: string
          const: url
          title: Type
          description: vox.ai가 HTTPS URL에서 내려받는 이미지 입력입니다.
        url:
          type: string
          minLength: 1
          title: Url
          description: vox.ai가 내려받을 HTTPS 이미지 URL입니다.
          examples:
            - https://example.com/photo.jpg
      type: object
      required:
        - type
        - url
      title: ChatMessageUrlImageInput
    NavertalkContent:
      oneOf:
        - properties:
            text_content:
              type: object
            composite_content:
              type: 'null'
          required:
            - text_content
        - properties:
            text_content:
              type: 'null'
            composite_content:
              type: object
          required:
            - composite_content
      properties:
        text_content:
          anyOf:
            - $ref: '#/components/schemas/NavertalkTextContent'
            - type: 'null'
          description: >-
            빠른 답장 버튼을 붙일 수 있는 텍스트 메시지입니다. `text_content`와 `composite_content`
            가운데 하나만 넣습니다.
        composite_content:
          anyOf:
            - $ref: '#/components/schemas/NavertalkCompositeContent'
            - type: 'null'
          description: 카드 메시지입니다. `text_content`와 `composite_content` 가운데 하나만 넣습니다.
      additionalProperties: false
      type: object
      title: NavertalkContentDto
    ChatMessageAttachment:
      properties:
        file_key:
          type: string
          title: File Key
          description: 첨부 파일 키입니다.
        mime_type:
          type: string
          title: Mime Type
          description: 첨부 MIME 타입입니다.
      type: object
      required:
        - file_key
        - mime_type
      title: ChatMessageAttachment
    ChatOutboundDeliveryResponse:
      properties:
        channel:
          anyOf:
            - type: string
              enum:
                - api
                - widget
                - sms
                - kakao
            - type: string
          title: Channel
          description: 메시지를 보낸 채널입니다.
        status:
          type: string
          enum:
            - stored
            - pending
            - sent
            - failed
          title: Status
          description: >-
            채널 발신 결과입니다. API·위젯 채팅은 따로 보낼 곳이 없어 `stored`, 문자는 발신 결과가 확정될 때까지
            `pending`, 카카오는 `sent`입니다. 카카오 발신 결과를 확인할 수 없으면 이 응답 대신
            `CSTALK_SEND_UNKNOWN` 오류를 반환합니다.
        provider_message_ids:
          items:
            type: string
          type: array
          title: Provider Message Ids
          description: 채널 쪽에서 매긴 메시지 식별자입니다.
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Code
          description: 발신에 실패했을 때의 기계 판독용 오류 코드입니다.
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
          description: 발신에 실패했을 때 사람이 읽을 수 있는 오류 메시지입니다.
      type: object
      required:
        - channel
        - status
      title: ChatOutboundDeliveryResponse
    ErrorDetail:
      type: object
      required:
        - code
        - message
        - details
      title: ErrorDetail
      description: 기계가 읽을 수 있는 v3 오류 상세 정보입니다.
      examples:
        - code: VALIDATION_ERROR
          message: Request validation failed.
          details:
            field: name
            reason: must not be blank
      properties:
        code:
          type: string
          title: Code
          description: 기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.
          examples:
            - VALIDATION_ERROR
        message:
          type: string
          title: Message
          description: 사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.
          examples:
            - Request validation failed.
        details:
          type: object
          title: Details
          additionalProperties: true
          description: 구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.
    NavertalkTextContent:
      properties:
        text:
          type: string
          maxLength: 10000
          minLength: 1
          title: Text
          description: 메시지 텍스트입니다. 최대 10,000자입니다.
        quick_reply:
          anyOf:
            - $ref: '#/components/schemas/NavertalkQuickReply'
            - type: 'null'
          description: 메시지와 함께 보이는 빠른 답장 버튼입니다. 선택 항목입니다.
      additionalProperties: false
      type: object
      required:
        - text
      title: NavertalkTextContent
    NavertalkCompositeContent:
      properties:
        composite_list:
          items:
            $ref: '#/components/schemas/NavertalkComposite'
          type: array
          maxItems: 10
          minItems: 1
          title: Composite List
          description: 메시지에 담을 카드입니다. 1~10개입니다.
      additionalProperties: false
      type: object
      required:
        - composite_list
      title: NavertalkCompositeContent
    NavertalkQuickReply:
      properties:
        button_list:
          items:
            oneOf:
              - $ref: '#/components/schemas/NavertalkTextButton'
              - $ref: '#/components/schemas/NavertalkLinkButton'
            discriminator:
              propertyName: type
              mapping:
                LINK: '#/components/schemas/NavertalkLinkButton'
                TEXT: '#/components/schemas/NavertalkTextButton'
          type: array
          maxItems: 10
          minItems: 1
          title: Button List
          description: 각 버튼의 data.title은 10자 이하여야 합니다.
      additionalProperties: false
      type: object
      required:
        - button_list
      title: NavertalkQuickReply
    NavertalkComposite:
      properties:
        title:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Title
          description: >-
            카드 제목입니다. 최대 200자입니다. 카드에는 `title`이나 `description`이 있어야 하고, `title`,
            `description`, `image`, `button_list` 가운데 두 가지 이상이 필요합니다.
        description:
          anyOf:
            - type: string
              maxLength: 1000
              minLength: 1
            - type: 'null'
          title: Description
          description: 사람이 읽을 수 있는 설명입니다.
        image:
          anyOf:
            - $ref: '#/components/schemas/NavertalkImage'
            - type: 'null'
          description: 카드 이미지입니다. 선택 항목입니다.
        button_list:
          anyOf:
            - items:
                oneOf:
                  - $ref: '#/components/schemas/NavertalkTextButton'
                  - $ref: '#/components/schemas/NavertalkLinkButton'
                discriminator:
                  propertyName: type
                  mapping:
                    LINK: '#/components/schemas/NavertalkLinkButton'
                    TEXT: '#/components/schemas/NavertalkTextButton'
              type: array
              maxItems: 10
              minItems: 1
            - type: 'null'
          title: Button List
          description: 카드 버튼입니다. 선택 항목이며, `TEXT`나 `LINK` 버튼을 1~10개 넣습니다.
      additionalProperties: false
      type: object
      title: NavertalkComposite
    NavertalkTextButton:
      properties:
        type:
          type: string
          const: TEXT
          title: Type
          description: 버튼 종류입니다. `TEXT`는 `data.code`를 담을 수 있는 답장 버튼입니다.
        data:
          $ref: '#/components/schemas/NavertalkTextButtonData'
          description: 텍스트 버튼의 이름과 코드입니다. 코드는 선택 항목입니다.
      additionalProperties: false
      type: object
      required:
        - type
        - data
      title: NavertalkTextButton
    NavertalkLinkButton:
      properties:
        type:
          type: string
          const: LINK
          title: Type
          description: 버튼 종류입니다. `LINK`는 `data`의 URL을 엽니다.
        data:
          $ref: '#/components/schemas/NavertalkLinkButtonData'
          description: 링크 버튼의 이름과 URL입니다.
      additionalProperties: false
      type: object
      required:
        - type
        - data
      title: NavertalkLinkButton
    NavertalkImage:
      properties:
        file_key:
          type: string
          maxLength: 255
          minLength: 1
          title: File Key
          description: 워크스페이스가 업로드한 이미지 파일의 키입니다. JPEG, PNG, GIF 이미지여야 하고 최대 20 MiB입니다.
      additionalProperties: false
      type: object
      required:
        - file_key
      title: NavertalkImage
    NavertalkTextButtonData:
      properties:
        title:
          type: string
          maxLength: 18
          minLength: 1
          title: Title
          description: 버튼 이름입니다. 최대 18자이고, 빠른 답장에서는 최대 10자입니다.
        code:
          anyOf:
            - type: string
              maxLength: 1000
              minLength: 1
            - type: 'null'
          title: Code
          description: >-
            고객이 버튼을 누르면 보내는 코드입니다. 에이전트는 고객 입력과 함께 이 코드를 받습니다. 예약 코드
            `voxai:handover`는 대화를 네이버 파트너센터로 넘기고, `voxai:resume`은 AI에게 되돌립니다.
      additionalProperties: false
      type: object
      required:
        - title
      title: NavertalkTextButtonData
    NavertalkLinkButtonData:
      properties:
        title:
          type: string
          maxLength: 18
          minLength: 1
          title: Title
          description: 버튼 이름입니다. 최대 18자이고, 빠른 답장에서는 최대 10자입니다.
        url:
          type: string
          maxLength: 2083
          minLength: 1
          format: uri
          title: Url
          description: 버튼이 여는 링크입니다. HTTP나 HTTPS URL이어야 합니다.
        mobile_url:
          type: string
          maxLength: 2083
          minLength: 1
          format: uri
          title: Mobile Url
          description: 모바일에서 버튼이 여는 링크입니다. HTTP나 HTTPS URL이어야 하고, `url`과 같아도 넣어야 합니다.
      additionalProperties: false
      type: object
      required:
        - title
        - url
        - mobile_url
      title: NavertalkLinkButtonData
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Organization API key
      description: '워크스페이스 API 키를 `Authorization: Bearer <token>` 형식으로 보냅니다.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.