bldinit Channeltalk Rest API

The channeltalk-rest API from bldinit — 10 operation(s) for channeltalk-rest.

GitHub OpenAPI

Operations 12

GET /api/v1/channeltalk/open/v5/channel 현재 BYOC 등록된 Channel Talk 채널 정보 조회 #
GET /api/v1/channeltalk/open/v5/managers 운영자(상담사) 목록 조회 #
GET /api/v1/channeltalk/open/v5/groups 운영자 팀(group) 목록 조회 #
GET /api/v1/channeltalk/open/v5/user-chats 고객 상담(user-chat) 목록 조회 #
GET /api/v1/channeltalk/open/v5/user-chats/{userChatId} 상담 단건 조회 #
GET /api/v1/channeltalk/open/v5/user-chats/{userChatId}/messages 상담 내 메시지 목록 조회 #
POST /api/v1/channeltalk/open/v5/user-chats/{userChatId}/messages 상담에 봇/운영자 메시지 전송 (write) #
GET /api/v1/channeltalk/open/v5/user-chats/{userChatId}/messages/file 상담 첨부 파일의 단기 서명 URL 조회 (read, ADR-125) #
PATCH /api/v1/channeltalk/open/v5/user-chats/{userChatId}/close 상담 종료 처리 (write) #
GET /api/v1/channeltalk/open/v5/users/{userId} 사용자(고객) 단건 조회 #
PATCH /api/v1/channeltalk/open/v5/users/{userId} 사용자(고객) 업데이트 (write) #
POST /api/v1/channeltalk/open/v5/users/{userId}/events 사용자 이벤트 추적 (write) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-channeltalk-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-channeltalk-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Channeltalk Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: channeltalk-rest
paths:
  /api/v1/channeltalk/open/v5/channel:
    get:
      tags:
      - channeltalk-rest
      summary: 현재 BYOC 등록된 Channel Talk 채널 정보 조회
      description: 'BYOC 등록 직후 검증용으로도 호출되며, 이후 채널 이름 / domain /

        country / language 등 메타데이터 조회. Channel Talk Open API 의

        가장 단순한 endpoint — credential 유효성 점검 시 권장.


        Native pass-through: 응답은 Channel Talk 의 raw Channel object.'
      operationId: channeltalk_get_channel
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/managers:
    get:
      tags:
      - channeltalk-rest
      summary: 운영자(상담사) 목록 조회
      description: '채널에 소속된 모든 manager (운영자/상담사) list. CS workflow 자동화의

        foundation — 누가 누구에게 assign 됐는지 / online 상태 등 확인.

        최대 500개 (since cursor 로 페이지네이션).


        Native pass-through: 응답은 Channel Talk 의 raw Manager 배열.'
      operationId: channeltalk_list_managers
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: sortOrder
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sortorder
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/groups:
    get:
      tags:
      - channeltalk-rest
      summary: 운영자 팀(group) 목록 조회
      description: 'Public 그룹 list. 운영자들이 모여 있는 팀 (CS 팀 / 영업 팀 등).

        UserChat assign 시 group 단위로 라우팅 가능.


        Native pass-through.'
      operationId: channeltalk_list_groups
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: sortOrder
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sortorder
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/user-chats:
    get:
      tags:
      - channeltalk-rest
      summary: 고객 상담(user-chat) 목록 조회
      description: '고객(user)과 운영자 사이의 상담 list. state filter 로

        opened / closed / snoozed 분리 가능. **이 endpoint 만 별도 rate

        limit bucket** (100 토큰, 10/s refill) — 다른 endpoint 와 다름.


        가장 많이 호출하는 read endpoint. CS workflow 의 foundation.


        Native pass-through.'
      operationId: channeltalk_list_user_chats
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: state
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: State
      - name: sortOrder
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sortorder
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/user-chats/{userChatId}:
    get:
      tags:
      - channeltalk-rest
      summary: 상담 단건 조회
      description: 'user-chat ID 로 단건 조회. 상태 / 담당 manager / tag / 최초 메시지 등

        상세 정보 포함.


        Native pass-through.'
      operationId: channeltalk_get_user_chat
      parameters:
      - name: userChatId
        in: path
        required: true
        schema:
          type: string
          title: Userchatid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/user-chats/{userChatId}/messages:
    get:
      tags:
      - channeltalk-rest
      summary: 상담 내 메시지 목록 조회
      description: '특정 user-chat 안의 메시지(대화 history) list. AI 가 상담 내용 파악

        + 자동 응답 작성 시 가장 많이 호출.


        Native pass-through.'
      operationId: channeltalk_list_messages
      parameters:
      - name: userChatId
        in: path
        required: true
        schema:
          type: string
          title: Userchatid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: sortOrder
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sortorder
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    post:
      tags:
      - channeltalk-rest
      summary: 상담에 봇/운영자 메시지 전송 (write)
      description: 'AI 가 자동 응답을 보낼 때 가장 핵심 endpoint. **botName 은 query

        parameter** (Channel Talk swagger 명세). blocks 배열 schema 는

        Channel Talk 의 message format 그대로.


        예시:

        POST /open/v5/user-chats/{id}/messages?botName=mcpweave

        body: {

        "blocks": [

        { "type": "text", "value": "안녕하세요! 문의주신 내용 확인했습니다." }

        ]

        }


        botName 동작 (dogfood round 4 검증 — 2026-05-04):

        - query param 으로 명시하면 Channel Talk 가 해당 이름의 새 bot 자동

        등록 + 그 봇으로 발송 (close 와 동일 패턴).

        - 같은 이름은 idempotent — 매 호출마다 새 봇 만들지 않고 기존 봇

        재사용 (channel.bots 배열에 1개만 추가됨).

        - body 안에 botName 두면 무시됨 (Channel Talk 가 query 만 인식).

        - 미지정 시 mcpweave wrapper 가 default ``mcpweave`` 자동 채움.


        **이미지/파일 첨부 (ADR-125)**: body 는 additionalProperties 라 아래가

        스키마 변경 없이 그대로 통한다. ⚠️ Open API 에 **신규 파일 업로드

        endpoint 는 없다**(임의 이미지 업로드 후 첨부는 불가 — App 플랫폼 영역).

        가능한 2가지:

        - **공개 이미지 URL 프리뷰**: body 에 ``"webPage": {"url": "...",

        "title": "...", "imageUrl": "https://공개이미지"}`` 추가 → 링크/이미지

        프리뷰 카드. 운영자가 공개 HTTPS 이미지를 답장에 넣을 때.

        - **고객이 올린 파일 되보내기**: ``list_messages`` 의 ``files[]``

        {id,bucket,key,name,size} 를 그대로 body ``"files"`` 배열에 넣어 forward

        (고객 첨부를 봇이 재전송하는 좁은 용도, Desk 렌더는 dogfood 확인).


        **Destructive write** — MCP client 에 confirm 요청.'
      operationId: channeltalk_send_message
      parameters:
      - name: userChatId
        in: path
        required: true
        schema:
          type: string
          title: Userchatid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: botName
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Botname
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/user-chats/{userChatId}/messages/file:
    get:
      tags:
      - channeltalk-rest
      summary: 상담 첨부 파일의 단기 서명 URL 조회 (read, ADR-125)
      description: '``channeltalk_list_messages`` 응답 메시지의 ``files[]`` 에 담긴 파일

        (이미지·문서)을 **열람할 수 있는 서명 URL** 을 반환한다. 비공개

        (``privateFileScope: "chat"``) 파일은 https://bin.channel.io/{key} 직접

        접근이 막혀 있어 이 endpoint 의 서명 URL 이 있어야 열린다.


        - ``key`` = 메시지 ``files[].key`` 값 그대로 (예: ``pri-file/{channelId}/

        user-chats/{chatId}/...``). pub-file/pri-file 모두 허용.

        - 응답 ``{ "result": "https://...X-Amz-Signature=..." }`` — AWS 서명 URL,

        **약 15분 후 만료**(만료는 URL query 에 인코딩, 별도 expiresAt 없음).

        - 용도: 통합 CS 인박스가 고객이 올린 사진을 **저장 없이** ```` 로

        인라인 표시(PII 최소화). 서명 URL 자체는 redact 되지 않는다(ADR-056

        패턴 미매칭).


        ⚠️ ``key`` 에 ``/`` 가 포함된다 — 일부 클라이언트가 ``%2F`` 로 인코딩하니

        Channel Talk 가 거부하면 디코드된 key 로 재시도(dogfood 확인 항목).'
      operationId: channeltalk_get_file_url
      parameters:
      - name: userChatId
        in: path
        required: true
        schema:
          type: string
          title: Userchatid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: key
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Key
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/user-chats/{userChatId}/close:
    patch:
      tags:
      - channeltalk-rest
      summary: 상담 종료 처리 (write)
      description: '상담 상태를 closed 로 전환. **botName 은 query parameter (필수)** —

        Channel Talk 가 close 행위자를 기록하기 위해 요구. 미지정 시 422

        validationError ("비워둘 수 없습니다 / model: userChatsResource").


        예시:

        PATCH /open/v5/user-chats/{id}/close?botName=mcpweave


        **Destructive write**.


        Note: CT-CLOSE-FIX1 (2026-05-04 dogfood) — 이전 yaml 에 botName

        param 누락으로 dead tool 이었음. 수정.'
      operationId: channeltalk_close_user_chat
      parameters:
      - name: userChatId
        in: path
        required: true
        schema:
          type: string
          title: Userchatid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: botName
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Botname
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/users/{userId}:
    get:
      tags:
      - channeltalk-rest
      summary: 사용자(고객) 단건 조회
      description: '고객 정보 (이메일 / 휴대폰 / profile / language / unsubscribe 상태 등)

        조회. CRM segment 자동화 시 핵심 read.


        Native pass-through.'
      operationId: channeltalk_get_user
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
          title: Userid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    patch:
      tags:
      - channeltalk-rest
      summary: 사용자(고객) 업데이트 (write)
      description: 'profile / language / unsubscribe / tag 등 부분 수정 (PATCH).

        body 의 필드만 변경됨 — 빠진 필드는 유지.


        예시:

        { "profile": { "name": "홍길동" }, "language": "ko",

        "unsubscribeEmail": true }


        **Destructive write**.'
      operationId: channeltalk_update_user
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
          title: Userid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/channeltalk/open/v5/users/{userId}/events:
    post:
      tags:
      - channeltalk-rest
      summary: 사용자 이벤트 추적 (write)
      description: 'Channel Talk 의 event tracking — 사용자가 특정 행동을 했음을 기록.

        CRM segment 트리거 (특정 event 발생 → marketing campaign 자동 발송)

        에 활용.


        예시 body:

        { "name": "purchase_completed",

        "property": { "amount": 50000, "product_id": "abc123" } }


        **Destructive write** (server state 변경).'
      operationId: channeltalk_track_event
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
          title: Userid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)