{"id":503,"date":"2022-05-03T08:36:04","date_gmt":"2022-05-02T23:36:04","guid":{"rendered":"https:\/\/wp.msghub.uplus.co.kr\/guide\/?post_type=docs&p=503"},"modified":"2026-02-20T14:17:20","modified_gmt":"2026-02-20T05:17:20","slug":"06-%ec%b9%b4%ec%b9%b4%ec%98%a4-%ec%97%b0%eb%8f%99-%ea%b4%80%eb%a6%ac","status":"publish","type":"docs","link":"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/06-%ec%b9%b4%ec%b9%b4%ec%98%a4-%ec%97%b0%eb%8f%99-%ea%b4%80%eb%a6%ac\/","title":{"rendered":"api\uac00\uc774\ub4dc-\ucc44\ub110\uad00\ub9ac-\uce74\uce74\uc624 \uc5f0\ub3d9 \uad00\ub9ac"},"content":{"rendered":"\n

\uce74\uce74\uc624 \uce74\ud14c\uace0\ub9ac \uc815\ubcf4 \ub9ac\uc2a4\ud2b8<\/h2>\n\n\n\n
\uce74\uce74\uc624 \uce74\ud14c\uace0\ub9ac \uc815\ubcf4 \ub9ac\uc2a4\ud2b8\ub97c \uc870\ud68c\ud569\ub2c8\ub2e4<\/pre>\n\n\n\n
\u25b6 Request<\/strong><\/p>\n\n\n\n
URL<\/strong><\/p>\n\n\n\n
POST \/kko\/v2\/channel\/category\/all HTTP\/1.1\nAuthorization: Bearer {token}\nContent-Type: application\/json\nHost: mnt-api.msghub.uplus.co.kr<\/pre>\n\n\n\n
Header<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
Authorization<\/td>String<\/td>true<\/td>\uc0ac\uc6a9\uc790 \uc778\uc99d \ud1a0\ud070<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\u25b6 Response<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
code<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc<\/td><\/tr>
message<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc \uc124\uba85<\/td><\/tr>
data<\/td>List<\/td>\uacb0\uacfc \ub370\uc774\ud130 \ubaa9\ub85d<\/td><\/tr>
data.code<\/td>String<\/td>\uce74\ud14c\uace0\ub9ac \ucf54\ub4dc<\/td><\/tr>
data.name<\/td>String<\/td>\uce74\ud14c\uace0\ub9ac \uba85<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\u25b6 Sample<\/strong><\/p>\n\n\n\n
Curl<\/strong><\/p>\n\n\n\n
curl -X POST \"https:\/\/mnt-api.msghub.uplus.co.kr\/kko\/v2\/channel\/category\/all\"\n-H  \"accept: *\/*\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiYWNjZXNzVXJsIjoiYXV0aCIsImlzcyI6ImNtLmxndXBsdX...\"\n-d \"\"<\/pre>\n\n\n\n
Response<\/strong><\/p>\n\n\n\n
{\n    \"code\": \"10000\",\n    \"message\": \"\uc131\uacf5\",\n    \"data\": [\n        {\n        \"code\": \"00100010001\",\n        \"name\": \"\uac74\uac15,\ubcd1\uc6d0,\uc885\ud569\ubcd1\uc6d0\"\n        },\n        ...\n    ]\n}<\/pre>\n\n\n\n
\ucc38\uace0<\/p>\n\n\n\n
\uacb0\uacfc \ucf54\ub4dc<\/a> \ucc38\uace0<\/pre>\n\n\n\n
\uce74\uce74\uc624 \ucc44\ub110\ub4f1\ub85d \uc0ac\uc804\uc815\ubcf4 \uc694\uccad\ud558\uae30 <\/h2>\n\n\n\n
\uc54c\ub9bc\ud1a1 \ucc44\ub110\ub4f1\ub85d \uc0ac\uc804\uc815\ubcf4 \uc694\uccad. (\uce74\uce74\uc624 \ucc44\ub110 \ub4f1\ub85d\uc2dc \uc0ac\uc804 \uc694\uccad \ud544\uc694)<\/p>\n\n\n\n
\u25b6 Request<\/strong><\/p>\n\n\n\n
URL<\/strong><\/p>\n\n\n\n
POST \u200b\/kko\/v2\/channel\/relayinfo HTTP\/1.1\nAuthorization: Bearer {token}\nContent-Type: application\/json\nHost: mnt-api.msghub.uplus.co.kr<\/pre>\n\n\n\n
Header<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
Authorization<\/td>String<\/td>true<\/td>\uc0ac\uc6a9\uc790 \uc778\uc99d \ud1a0\ud070<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u25b6 Response<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
code<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc<\/td><\/tr>
message<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc \uc124\uba85<\/td><\/tr>
data.relayInfo<\/td>List<\/td>relay ID<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u25b6 Sample<\/strong><\/p>\n\n\n\n
Curl<\/strong><\/p>\n\n\n\n
curl -X POST \"https:\/\/mnt-api.msghub.uplus.co.kr\/kko\/v2\/channel\/relayinfo\"\n-H  \"accept: *\/*\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiYWNjZXNzVXJsIjoiYXV0aCIsImlzcyI6ImNtLmxndXBsdX...\"\n-H  \"Content-Type: application\/json\"\n-d ''\"<\/pre>\n\n\n\n
Response<\/strong><\/p>\n\n\n\n
{\n  \"code\": \"10000\",\n  \"message\": \"\uc131\uacf5\",\n  \"data\": [\n      \"r01\",\n      \"r02\"\n  ]\n}<\/pre>\n\n\n\n
\ucc38\uace0<\/p>\n\n\n\n
\uacb0\uacfc \ucf54\ub4dc<\/a> \ucc38\uace0<\/pre>\n\n\n\n
\uce74\uce74\uc624 \uc778\uc99d \ud1a0\ud070 \uc694\uccad\ud558\uae30<\/h2>\n\n\n\n
\uc778\uc99d \ud1a0\ud070\uc774 \ub2e8\ub9d0\ub85c \uc804\ub2ec\ub429\ub2c8\ub2e4. (\uce74\uce74\uc624 \ucc44\ub110 \ub4f1\ub85d\uc2dc \uc0ac\uc804 \uc694\uccad \ud544\uc694)<\/pre>\n\n\n\n
\u25b6 Request<\/strong><\/p>\n\n\n\n
URL<\/strong><\/p>\n\n\n\n
POST \u200b\/kko\/v2\/channel\/token HTTP\/1.1\nAuthorization: Bearer {token}\nContent-Type: application\/json\nHost: mnt-api.msghub.uplus.co.kr<\/pre>\n\n\n\n
Header<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
Authorization<\/td>String<\/td>true<\/td>\uc0ac\uc6a9\uc790 \uc778\uc99d \ud1a0\ud070<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Requeset body<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
phoneNumber<\/td>String<\/td>true<\/td>\ud734\ub300\ud3f0 \ubc88\ud638<\/td><\/tr>
kkoChId<\/td>String<\/td>true<\/td>\uce74\uce74\uc624 \ucc44\ub110 ID
(\uce74\uce74\uc624\ube44\uc988\ub2c8\uc2a4\uc758 “\ub0b4 \ucc44\ub110” \ubaa9\ub85d\uc5d0 \uc788\ub294 \ucc44\ub110 \uc544\uc774\ub514 ex) @\ub0b4\ucc44\ub110)<\/td><\/tr>
relay<\/td>String<\/td>true<\/td>\uce74\uce74\uc624\ucc44\ub110 \ub4f1\ub85d relay ID<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\u25b6 Response<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
code<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc<\/td><\/tr>
message<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc \uc124\uba85<\/td><\/tr>
data<\/td>Object<\/td>\uacb0\uacfc\ub370\uc774\ud130\ubaa9\ub85d<\/td><\/tr>
data.phoneNumber<\/td>String<\/td>\ud734\ub300\ud3f0 \ubc88\ud638<\/td><\/tr>
data.yellowId<\/td>String<\/td>\uce74\uce74\uc624 \ucc44\ub110 ID<\/td><\/tr>
data.kkoChId<\/td>String<\/td>\uce74\uce74\uc624 \ucc44\ub110 ID<\/td><\/tr>
data.relay<\/td>String<\/td>\uce74\uce74\uc624\ucc44\ub110 \ub4f1\ub85d relay ID<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\u25b6 Sample<\/strong><\/p>\n\n\n\n
Curl<\/strong><\/p>\n\n\n\n
curl -X POST \"https:\/\/mnt-api.msghub.uplus.co.kr\/kko\/v2\/channel\/token\"\n-H  \"accept: *\/*\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiYWNjZXNzVXJsIjoiYXV0aCIsImlzcyI6ImNtLmxndXBsdX...\"\n-H  \"Content-Type: application\/json\"\n-d '\n    {\n        \"phoneNumber\": \"01099999999\",\n        \"kkoChId\": \"@kkoChId\",\n        \"relay\":\"r01\"\n    }\n'<\/pre>\n\n\n\n
Response<\/strong><\/p>\n\n\n\n
{\n    \"code\": \"10000\",\n    \"message\": \"\uc131\uacf5\"\n}<\/pre>\n\n\n\n
\ucc38\uace0<\/p>\n\n\n\n
\uacb0\uacfc \ucf54\ub4dc<\/a> \ucc38\uace0<\/pre>\n\n\n\n
\uce74\uce74\uc624 \ucc44\ub110 \ub4f1\ub85d<\/h2>\n\n\n\n
\uce74\uce74\uc624 \ucc44\ub110\uc744 \ub4f1\ub85d \ud569\ub2c8\ub2e4. (*\uce74\uce74\uc624 \ucc44\ub110 \uc0dd\uc131\uc740 \uce74\uce74\uc624\ube44\uc988\uc13c\ud130\uc5d0\uc11c \ud569\ub2c8\ub2e4.)<\/pre>\n\n\n\n
\u25b6 Request<\/strong><\/p>\n\n\n\n
URL<\/strong><\/p>\n\n\n\n
POST \/kko\/v2\/channel\/create HTTP\/1.1\nAuthorization: Bearer {token}\nContent-Type: application\/json\nHost: mnt-api.msghub.uplus.co.kr<\/pre>\n\n\n\n
Header<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
Authorization<\/td>String<\/td>true<\/td>\uc0ac\uc6a9\uc790 \uc778\uc99d \ud1a0\ud070<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\u25b6 Request body<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
tokens<\/td>List<RelayToken><\/td>true<\/td>relay token \uc815\ubcf4<\/td><\/tr>
categoryCode<\/td>String<\/td>true<\/td>\uce74\ud14c\uace0\ub9ac \ucf54\ub4dc<\/td><\/tr>
kkoChId<\/td>String<\/td>true<\/td>\uce74\uce74\uc624\ucc44\ub110 \uac80\uc0c9\uc6a9ID
(\uce74\uce74\uc624\ube44\uc988\ub2c8\uc2a4\uc758 “\ub0b4 \ucc44\ub110” \ubaa9\ub85d\uc5d0 \uc788\ub294 \ucc44\ub110 \uc544\uc774\ub514 ex) @\ub0b4\ucc44\ub110)<\/td><\/tr>
memo<\/td>String<\/td>false<\/td>\uba54\ubaa8<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
tokens<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
rid<\/td>String<\/td>true<\/td>relay ID<\/td><\/tr>
token<\/td>Integer<\/td>true<\/td>\uc778\uc99d \ucf54\ub4dc<\/td><\/tr>
phoneNumber<\/td>String<\/td>true<\/td>\ud50c\ub7ec\uc2a4\uce5c\uad6c \uad00\ub9ac\uc790\ubc88\ud638<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u25b6 Response<\/strong><\/p>\n\n\n\n
Name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
code<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc<\/td><\/tr>
message<\/td>String<\/td>\uacb0\uacfc \ucf54\ub4dc \uc124\uba85<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\ucc38\uace0<\/p>\n\n\n\n
\uce74\uce74\uc624 \ucc44\ub110 \uc0c1\ud0dc(kkoChStat)<\/p>\n\n\n\n