{"id":3469,"date":"2023-09-20T15:17:00","date_gmt":"2023-09-20T06:17:00","guid":{"rendered":"https:\/\/doc.msghub.uplus.co.kr\/guide\/?post_type=docs&#038;p=3469"},"modified":"2026-02-20T14:19:33","modified_gmt":"2026-02-20T05:19:33","slug":"%ed%86%b5%ed%95%a9%eb%a9%94%ec%8b%9c%ec%a7%80","status":"publish","type":"docs","link":"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%ed%86%b5%ed%95%a9%eb%a9%94%ec%8b%9c%ec%a7%80\/","title":{"rendered":"api\uac00\uc774\ub4dc-\uba54\uc2dc\uc9c0 \ubc1c\uc1a1-\ud1b5\ud569\uba54\uc2dc\uc9c0"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"id36\">\ud1b5\ud569 \uba54\uc2dc\uc9c0 \ubc1c\uc1a1<\/h2>\n\n\n\n<p class=\"has-ast-global-color-4-background-color has-background\" style=\"font-size:15px\">\ud1b5\ud569 \uba54\uc2dc\uc9c0 \ubc1c\uc1a1 API\uc774\uba70, \ucd5c\ub300 10\uac74 \uae4c\uc9c0 \ud55c\ubc88\uc5d0 \ubc1c\uc1a1 \uac00\ub2a5\ud569\ub2c8\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Request<\/h3>\n\n\n\n<p><strong>URL<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">POST \/msg\/v1.1\/send HTTP\/1.1\nAuthorization: Bearer {token}\nContent-Type: application\/json\nHost: api.msghub.uplus.co.kr<\/pre>\n\n\n\n<p><strong>Header<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Required<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Authorization<\/td><td>String<\/td><td>true<\/td><td>\uc0ac\uc6a9\uc790 \uc778\uc99d \ud1a0\ud070<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><strong>Request body<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Required<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>tmpltCode<\/td><td>String<\/td><td>true<\/td><td>\ud1b5\ud569\ubc1c\uc1a1 \ud15c\ud50c\ub9bf<\/td><\/tr><tr><td>campaignId<\/td><td>String<\/td><td>false<\/td><td>\ucea0\ud398\uc778 ID<\/td><\/tr><tr><td>agency<\/td><td>Object&lt;<a href=\"#schema-agency\" data-type=\"internal\" data-id=\"#schema-agency\">Agency<\/a>&gt;<\/td><td>false<\/td><td>\ub300\ud589\uc0ac\/\uc7ac\ud310\ub9e4 \uc0ac\uc5c5\uc790 \ubc1c\uc1a1\uc815\ubcf4<br>(\uc77c\ubc18\uc0ac\uc5c5\uc790\ub294 \ubbf8\uc0ac\uc6a9)<\/td><\/tr><tr><td>deptCode<\/td><td>String<\/td><td>false<\/td><td>\ubd80\uc11c\ucf54\ub4dc<\/td><\/tr><tr><td><code>resvYn<\/code><\/td><td>String<\/td><td>false<\/td><td>\uc608\uc57d\ubc1c\uc1a1 \uc5ec\ubd80<\/td><\/tr><tr><td>resvReqDt<\/td><td>String<\/td><td>false<\/td><td>\uc608\uc57d\ubc1c\uc1a1 \uc77c\uc2dc(yyyy-MM-dd hh:mm)<\/td><\/tr><tr><td>recvInfoLst<\/td><td>List&lt;<a href=\"#schema-smartrecvinfo\" data-type=\"internal\" data-id=\"#schema-smartrecvinfo\">SmartRecvInfo<\/a>&gt;<\/td><td>true<\/td><td>\ubc1c\uc1a1 \uc815\ubcf4 \ubaa9\ub85d(\ucd5c\ub300 10\uac74 \ubc1c\uc1a1\uac00\ub2a5)<\/td><\/tr><tr><td>clickUrlYn<\/td><td>String<\/td><td>true<\/td><td>\ub2e8\ucd95URL \uc0ac\uc6a9\uc5ec\ubd80<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p id=\"schema-smartrecvinfo\"><strong>SmartRecvInfo&nbsp;\ubc1c\uc1a1 \uc815\ubcf4<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Required<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>cliKey<\/td><td>String<\/td><td>true<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8\ud0a4: \uace0\uac1d\uc0ac\uc5d0\uc11c \ubd80\uc5ec\ud558\ub294 \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4(^[a-zA-Z0-9-_.@]{1,30}$)<\/td><\/tr><tr><td>phone<\/td><td>String<\/td><td>true<\/td><td>\uc218\uc2e0\ubc88\ud638(^[0-9-]{1,20}$)<\/td><\/tr><tr><td>callback<\/td><td>String<\/td><td>false<\/td><td>\ubc1c\uc2e0\ubc88\ud638<br>&#8211; RCS, SMS, LMS, MMS \ucc44\ub110\uc758 \ubc1c\uc2e0\ubc88\ud638\ub97c \ubcc0\uacbd\ud558\uace0\uc790 \ud558\ub294 \uacbd\uc6b0 \ucd94\uac00<br>&#8211; \uc0ac\uc804 \ub4f1\ub85d\ub418\uc9c0 \uc54a\uc740 \ubc88\ud638\uc758 \uacbd\uc6b0 \ubc1c\uc1a1\uc2e4\ud328 \ub429\ub2c8\ub2e4.<\/td><\/tr><tr><td>cuid<\/td><td>String<\/td><td>true<\/td><td>\uc571 \ub85c\uadf8\uc778 \uc2dc \uc0ac\uc6a9\ub418\ub294 \uc544\uc774\ub514<\/td><\/tr><tr><td>kvData<\/td><td>HashMap&lt;String, String&gt;<\/td><td>false<\/td><td>\uac00\ubcc0\ub370\uc774\ud130<\/td><\/tr><tr><td>fileData<\/td><td>HashMap&lt;String, String&gt;<\/td><td>false<\/td><td>\ud30c\uc77c\ub370\uc774\ud130 \uc5c6\uc744 \uc2dc \ud15c\ud50c\ub9bf\uc5d0 \ub4f1\ub85d\ub41c \ud30c\uc77c \uae30\ubcf8 \uc804\uc1a1<br>MMS : mms.1 , RCS : rcs.1, \uce5c\uad6c\ud1a1 : friendtalk.1, PUSH : push.1<br>* \uac01 \ub9e4\uccb4\ubcc4 \ucca8\ubd80\uc774\ubbf8\uc9c0\uac1c\uc218\uac00 \ucc28\uc774\uac00 \uc788\uc73c\uba70, \ud574\ub2f9 \ub9e4\uccb4\uc758 \uc774\ubbf8\uc9c0 \uac1c\uc218\ub97c \ucd08\uacfc\ud558\uc5ec \ucca8\ubd80\ud560 \uacbd\uc6b0 \ubc1c\uc1a1 \uc2e4\ud328\ub429\ub2c8\ub2e4.<br>* MMS \ub294 \uc774\ubbf8\uc9c0 \uc21c\uc11c\uac00 \uc5c6\uc5b4 \ud3f0\uc5d0 \ud45c\ud604 \uc2dc \uc704\uce58\uac00 \ubcc0\uacbd\ub420 \uc218 \uc788\uc2b5\ub2c8\ub2e4. <br>* \uc791\uc131 \ubc29\ubc95 Sample \ucc38\uace0.<\/td><\/tr><tr><td>userCustomFields<\/td><td>HashMap&lt;String, String><\/td><td>false<\/td><td>\uc6f9\ud6c5 \ucd94\uac00\ud544\ub4dc \ub370\uc774\ud130<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#schema-response\" data-type=\"internal\" data-id=\"#schema-response\">Response<\/a><\/h3>\n\n\n\n<p>\uc2a4\ud0a4\ub9c8\ub97c \ucc38\uc870\ud558\uc138\uc694.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Sample<\/h3>\n\n\n\n<p><strong>Curl<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">curl -X POST \"https:\/\/api.msghub.uplus.co.kr\/msg\/v1.1\/send\"\n-H  \"accept: *\/*\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ...\"\n-H  \"Content-Type: application\/json\"\n-d '\n  {\n    \"tmpltCode\": \"\ud15c\ud50c\ub9bf\ucf54\ub4dc\",\n    \"campaignId\": \"\",\n    \"agency\":{\n                   \"kisaOrigCode\": \"\uc7ac\ud310\ub9e4\uc0ac KISA \ucd5c\ucd08\uc2dd\ubcc4\ucf54\ub4dc\",\n                   \"rcsAgencyId\": \"\uc7ac\ud310\ub9e4\uc0ac RCS Agency ID\",\n                   \"rcsAgencyKey\": \"\uc7ac\ud310\ub9e4\uc0ac RCS Agency Key\"\n    },\n    \"resvYn\": \"Y\",\n    \"resvReqDt\": \"2023-01-13 13:15\",\n    \"recvInfoLst\": [\n        {\n            \"cliKey\": \"cliKey1\",\n            \"phone\": \"01012341234\",\n            \"kvData\":{\"\uce58\ud658\ub300\uc0c1\ubb38\uc790\uc5f4\":\"\uce58\ud658\ubb38\uc790\uc5f4\",...,\"\uce58\ud658\ub300\uc0c1\ubb38\uc790\uc5f4\":\"\uce58\ud658\ubb38\uc790\uc5f4\"},\n            \"fileData\":{\"mms.1\":\"FLETt9wbx\", \"mms.2\":\"FLETt9\", \"rcs.1\":\"FLETt9\"},\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD12345\",\n            \"customerName\": \"\ud64d\uae38\ub3d9\",\n            \"amount\": 10000\n          }\n        },\n        {\n            \"cliKey\": \"cliKey2\",\n            \"phone\": \"01012341235\",\n            \"kvData\":{\"\uce58\ud658\ub300\uc0c1\ubb38\uc790\uc5f4\":\"\uce58\ud658\ubb38\uc790\uc5f4\",...,\"\uce58\ud658\ub300\uc0c1\ubb38\uc790\uc5f4\":\"\uce58\ud658\ubb38\uc790\uc5f4\"},\n            \"fileData\":{\"mms.1\":\"FLETt9wbx\", \"mms.2\":\"FLETt9\", \"rcs.1\":\"FLETt9\"},\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD6789\",\n            \"customerName\": \"\uae40\ucca0\uc218\",\n            \"amount\": 10000\n          }\n        }\n    ]\n}'<\/pre>\n\n\n\n<p><strong>Response<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">{\n    \"code\": \"10000\",\n    \"message\": \"\uc131\uacf5\",\n    \"data\": [\n        {\n            \"cliKey\": \"cliKey1\",\n            \"msgKey\": \"tw9Tomlcen.6bTb0O\",\n            \"phone\": \"01012341234\",\n            \"code\": \"10000\",\n            \"message\": \"\uc131\uacf5\"\n        },\n        {\n            \"cliKey\": \"cliKey2\",\n            \"msgKey\": \"tw9Tomlcen.6bTb0O\",\n            \"phone\": \"01012341234\",\n            \"code\": \"10000\",\n            \"message\": \"\uc131\uacf5\"\n        }\n    ]\n}<\/pre>\n\n\n\n<p><strong>\ucc38\uace0<\/strong><\/p>\n\n\n\n<p class=\"has-ast-global-color-4-background-color has-background\" style=\"font-size:15px\"><a href=\"\/guide\/d\/\uacb0\uacfc-\ucf54\ub4dc\/\">\uacb0\uacfc \ucf54\ub4dc<\/a>&nbsp;\ucc38\uace0<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\ud1b5\ud569 \uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \ud1b5\ud569 \uba54\uc2dc\uc9c0 \ubc1c\uc1a1 API\uc774\uba70, \ucd5c\ub300 10\uac74 \uae4c\uc9c0 \ud55c\ubc88\uc5d0 \ubc1c\uc1a1 \uac00\ub2a5\ud569\ub2c8\ub2e4. Request URL POST \/msg\/v1.1\/send HTTP\/1.1 Authorization: Bearer {token} Content-Type: application\/json Host: api.msghub.uplus.co.kr Header Name Type Required Description Authorization String true \uc0ac\uc6a9\uc790 \uc778\uc99d \ud1a0\ud070 Request body Name Type Required Description tmpltCode String true \ud1b5\ud569\ubc1c\uc1a1 \ud15c\ud50c\ub9bf campaignId String false \ucea0\ud398\uc778 ID agency Object&lt;Agency&gt; false [&hellip;]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""}}},"doc_category":[],"doc_tag":[],"_links":{"self":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3469"}],"collection":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/comments?post=3469"}],"version-history":[{"count":4,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3469\/revisions"}],"predecessor-version":[{"id":4097,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3469\/revisions\/4097"}],"wp:attachment":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/media?parent=3469"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_category?post=3469"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_tag?post=3469"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}