bldinit Naver Talktalk Rest API
The naver_talktalk-rest API from bldinit — 6 operation(s) for naver_talktalk-rest.
The naver_talktalk-rest API from bldinit — 6 operation(s) for naver_talktalk-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-naver-talktalk-rest-api"
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.
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: 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)