bldinit Naver Talktalk Rest API

The naver_talktalk-rest API from bldinit — 6 operation(s) for naver_talktalk-rest.

GitHub OpenAPI

Operations 6

POST /api/v1/naver_talktalk/chatbot/v1/event:send_text 텍스트 메시지 발송 (write — irreversible) #
POST /api/v1/naver_talktalk/chatbot/v1/event:send_image 이미지 메시지 발송 (write — irreversible) #
POST /api/v1/naver_talktalk/chatbot/v1/event:send_quick_reply 빠른응답 버튼 메시지 발송 (write — irreversible) #
POST /api/v1/naver_talktalk/chatbot/v1/event:set_persistent_menu 고정 메뉴 설정 (write — recoverable) #
POST /api/v1/naver_talktalk/chatbot/v1/event:set_typing typing indicator on/off (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-naver-talktalk-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-naver-talktalk-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Naver Talktalk Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: naver_talktalk-rest
paths:
  /api/v1/naver_talktalk/chatbot/v1/event:send_text:
    post:
      tags:
      - naver_talktalk-rest
      summary: 텍스트 메시지 발송 (write — irreversible)
      description: '네이버 톡톡 사용자에게 텍스트 메시지 발송.


        body 핵심:

        {

        "user": "al-2eGuGr5WQOnco1_V-FQ", /* 사용자 식별값 (open event 에서 받음) */

        "textContent": {"text": "안녕하세요!"},

        "options": {"notification": false} /* default false (push UX 부작용 회피) */

        }


        응답: {success: true, resultCode: "00"} ← 다른 connector 와 다른 envelope.


        ⚠️ ADR-028 §D2.A — 외부 수신자 도달 후 회수 불가 (irreversible).


        **Destructive write — money/PII**.'
      operationId: naver_talktalk_send_text_message
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - 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/naver_talktalk/chatbot/v1/event:send_image:
    post:
      tags:
      - naver_talktalk-rest
      summary: 이미지 메시지 발송 (write — irreversible)
      description: '이미지 URL 로 메시지 발송. 이미지는 네이버 측 / 외부 host (HTTPS 권장).


        body:

        {

        "user": "...",

        "imageContent": {"imageUrl": "https://..."}

        }


        ⚠️ ADR-028 §D2.A — 외부 수신자 도달.


        **Destructive write**.'
      operationId: naver_talktalk_send_image_message
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - 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/naver_talktalk/chatbot/v1/event:send_carousel:
    post:
      tags:
      - naver_talktalk-rest
      summary: 복합 메시지 (carousel) 발송 (write — irreversible)
      description: 'compositeContent — 제목 / 설명 / 이미지 / 버튼 (TEXT/LINK/OPTION/PAY) 조합.

        **최대 10항목 carousel**.


        body:

        {

        "user": "...",

        "compositeContent": {

        "compositeList": [

        {

        "title": "상품명",

        "description": "...",

        "image": {"imageUrl": "..."},

        "buttonList": [{"type": "LINK", "data": {...}}]

        }

        ]

        }

        }


        button.type enum:

        - TEXT : 사용자가 채팅창에 입력하는 효과 (code 활용 권장)

        - LINK : 외부 URL (PC/Mobile URL 별도 설정 — history.back() 주의)

        - OPTION: 다중 선택지

        - PAY : 네이버페이 통합 (Phase 2+ 후보)


        ⚠️ ADR-028 §D2.A — 외부 수신자 도달.


        **Destructive write**.'
      operationId: naver_talktalk_send_carousel
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - 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/naver_talktalk/chatbot/v1/event:send_quick_reply:
    post:
      tags:
      - naver_talktalk-rest
      summary: 빠른응답 버튼 메시지 발송 (write — irreversible)
      description: '텍스트 메시지 + quickReply 버튼 (사용자가 빠르게 선택 가능).


        body:

        {

        "user": "...",

        "textContent": {

        "text": "원하는 옵션을 선택해주세요",

        "quickReply": {

        "buttonList": [

        {"type": "TEXT", "data": {"title": "예", "code": "YES"}},

        {"type": "TEXT", "data": {"title": "아니오", "code": "NO"}}

        ]

        }

        }

        }


        ⚠️ ADR-028 §D2.A — 외부 수신자 도달.


        **Destructive write**.'
      operationId: naver_talktalk_send_quick_reply
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - 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/naver_talktalk/chatbot/v1/event:set_persistent_menu:
    post:
      tags:
      - naver_talktalk-rest
      summary: 고정 메뉴 설정 (write — recoverable)
      description: '대화창 하단 고정 메뉴 설정. 사용자 식별값 불필요 (전체 채널 적용).


        body:

        {

        "menuContent": [{

        "menus": [

        {"type": "TEXT", "data": {"title": "챗봇 안내", "code": "GUIDE"}},

        {"type": "LINK", "data": {"title": "이벤트", "url": "...", "mobileUrl": "..."}}

        ]

        }]

        }


        다시 호출하면 덮어쓰기 (recoverable, ADR-028 §D2 not irreversible).


        **Destructive write — 채널 전체 메뉴 변경**.'
      operationId: naver_talktalk_set_persistent_menu
      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
      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/naver_talktalk/chatbot/v1/event:set_typing:
    post:
      tags:
      - naver_talktalk-rest
      summary: typing indicator on/off (write)
      description: '대화창에 "작성중" 이미지 표시. 메시지 처리 중 자연스러운 UX.


        body:

        {

        "user": "...",

        "options": {"action": "typingOn"} /* or "typingOff" */

        }


        - typingOn: 10초 자동 만료. 이내 새 typingOn 보내면 갱신.

        - typingOff: 즉시 해제 (또는 send 이벤트가 자동 typingOff 효과).


        **Destructive write — UX 표시 (irreversible 아님)**.'
      operationId: naver_talktalk_set_typing
      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
      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)