{"id":3454,"date":"2023-09-20T15:06:47","date_gmt":"2023-09-20T06:06:47","guid":{"rendered":"https:\/\/doc.msghub.uplus.co.kr\/guide\/?post_type=docs&#038;p=3454"},"modified":"2026-02-20T14:19:48","modified_gmt":"2026-02-20T05:19:48","slug":"%ec%95%8c%eb%a6%bc%ed%86%a1-%ec%b9%9c%ea%b5%ac%ed%86%a1","status":"publish","type":"docs","link":"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%ec%95%8c%eb%a6%bc%ed%86%a1-%ec%b9%9c%ea%b5%ac%ed%86%a1\/","title":{"rendered":"api\uac00\uc774\ub4dc-\uba54\uc2dc\uc9c0 \ubc1c\uc1a1-\uc54c\ub9bc\ud1a1\/\uce5c\uad6c\ud1a1"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">\uce74\uce74\uc624 \uc54c\ub9bc\ud1a1 \ubc1c\uc1a1<\/h2>\n\n\n\n<p class=\"has-ast-global-color-1-color has-ast-global-color-4-background-color has-text-color has-background\" style=\"font-size:15px\">\uce74\uce74\uc624 \uc54c\ub9bc\ud1a1 \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.2\/alimtalk 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>clickUrlYn<\/td><td>String<\/td><td>false<\/td><td>\ub2e8\ucd95URL \uc0ac\uc6a9\uc5ec\ubd80<\/td><\/tr><tr><td>filterYn<\/td><td>String<\/td><td>false<\/td><td>\ud544\ud130\ub9c1 \uc5ec\ubd80<\/td><\/tr><tr><td>filterGrpLst<\/td><td>ArrayList<\/td><td>false<\/td><td>\ud544\ud130\uadf8\ub8f9<\/td><\/tr><tr><td>callback<\/td><td>String<\/td><td>true<\/td><td>\ubc1c\uc2e0\ubc88\ud638<\/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<\/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><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>deptCode<\/td><td>String<\/td><td>false<\/td><td>\ubd80\uc11c\ucf54\ub4dc<\/td><\/tr><tr><td>title<\/td><td>String<\/td><td>false<\/td><td>\uc54c\ub9bc\ud1a1 \uac15\uc870\ud45c\uae30 \uc81c\ubaa9, \ucd5c\ub300 50 Byte<br><br>* \ud15c\ud50c\ub9bf \uac15\uc870\uc720\ud615 \uc911 \uac15\uc870\ud45c\uae30\ud615 \uc77c\ub54c\ub9cc \uc0ac\uc6a9<\/td><\/tr><tr><td>msg<\/td><td>String<\/td><td>true<\/td><td>\uba54\uc2dc\uc9c0 \ub0b4\uc6a9, \ucd5c\ub300 1000\uc790<\/td><\/tr><tr><td>kkoChId<\/td><td>String<\/td><td>true<\/td><td>\uce74\uce74\uc624\ucc44\ub110ID<\/td><\/tr><tr><td>tmpltCode<\/td><td>String<\/td><td>true<\/td><td>\ud15c\ud50c\ub9bf \ucf54\ub4dc<\/td><\/tr><tr><td>service<\/td><td>integer<\/td><td>false<\/td><td>\uc11c\ube44\uc2a4 \ubc88\ud638<\/td><\/tr><tr><td>buttons<\/td><td>List&lt;LMKakaoButton&gt;<\/td><td>false<\/td><td>\ubc84\ud2bc \ubaa9\ub85d<\/td><\/tr><tr><td>recvInfoLst<\/td><td>List&lt;<a href=\"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%eb%a9%94%ec%8b%9c%ec%a7%80-%ea%b4%80%eb%a0%a8-%ec%8a%a4%ed%82%a4%eb%a7%88\" data-type=\"internal\" data-id=\"#schema-recvinfo\">RecvInfo<\/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>fbInfoLst<\/td><td>List&lt;<a href=\"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%eb%a9%94%ec%8b%9c%ec%a7%80-%ea%b4%80%eb%a0%a8-%ec%8a%a4%ed%82%a4%eb%a7%88\" data-type=\"internal\" data-id=\"#schema-fbinfo\">FbInfo<\/a>&gt;<\/td><td>false<\/td><td>fallback \uc815\ubcf4 \ubaa9\ub85d<\/td><\/tr><tr><td>groupKey<\/td><td>String<\/td><td>false<\/td><td>\uadf8\ub8f9 \ud15c\ud50c\ub9bf \ubc1c\uc1a1 \uc2dc \uadf8\ub8f9\ud0a4<\/td><\/tr><tr><td>itemHeader<\/td><td>String<\/td><td>false<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \ud5e4\ub354<\/td><\/tr><tr><td>itemHighlightTitle<\/td><td>String<\/td><td>false<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \uc694\uc57d\uc815\ubcf4<\/td><\/tr><tr><td>itemHighlightDescription<\/td><td>String<\/td><td>false<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \uc694\uc57d\ub0b4\uc6a9<\/td><\/tr><tr><td>item<\/td><td>Object<\/td><td>false<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \uc815\ubcf4<\/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>LMKakaoButton&nbsp;\ubc84\ud2bc<\/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>name<\/td><td>String<\/td><td>true<\/td><td>\ubc84\ud2bc\uc774\ub984<\/td><\/tr><tr><td>linkType<\/td><td>String<\/td><td>true<\/td><td>\ubc84\ud2bc\ud0c0\uc785(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id24\">*<\/a>\ud558\ub2e8 \ucc38\uc870)<\/td><\/tr><tr><td>linkMo<\/td><td>String<\/td><td>false<\/td><td>mobile \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc774\ub3d9\ud560 url, \ucd5c\ub300 255 Byte<\/td><\/tr><tr><td>linkPc<\/td><td>String<\/td><td>false<\/td><td>pc \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc774\ub3d9\ud560 url, \ucd5c\ub300 255 Byte<\/td><\/tr><tr><td>linkAnd<\/td><td>String<\/td><td>false<\/td><td>mobile android \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc2e4\ud589\ud560 application custom scheme<\/td><\/tr><tr><td>linkIos<\/td><td>String<\/td><td>false<\/td><td>mobile ios \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc2e4\ud589\ud560 application custom scheme<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>i<strong>tem<\/strong> \uac1d\uccb4<\/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>list<\/td><td>List<\/td><td>true<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8, \ucd5c\uc18c 2\uac1c, \ucd5c\ub300 10\uac1c\uae4c\uc9c0 \uac00\ub2a5<\/td><\/tr><tr><td>list[].title<\/td><td>String<\/td><td>true<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \ud0c0\uc774\ud2c0, \ucd5c\ub300 6\uc790<\/td><\/tr><tr><td>list[].description<\/td><td>String<\/td><td>true<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \uc124\uba85, \ucd5c\ub300 23\uc790<\/td><\/tr><tr><td>summary<\/td><td>Object<\/td><td>false<\/td><td>\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8 \uc124\uba85<\/td><\/tr><tr><td>summary.title<\/td><td>String<\/td><td>true<\/td><td>\ud0c0\uc774\ud2c0<\/td><\/tr><tr><td>summary.description<\/td><td>String<\/td><td>false<\/td><td>\uc124\uba85 (\ubcc0\uc218 \ubc0f \ud654\ud3d0 \ub2e8\uc704, \uc22b\uc790, \uc27c\ud45c, \ub9c8\uce68\ud45c\ub9cc \uc0ac\uc6a9 \uac00\ub2a5), \ucd5c\ub300 14\uc790<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>\ucc38\uace0<\/strong><\/p>\n\n\n\n<p class=\"has-ast-global-color-1-color has-ast-global-color-4-background-color has-text-color has-background\" style=\"font-size:15px\"><strong>\ubc84\ud2bc\ud0c0\uc785<\/strong><br>WL : linkMo \ud544\uc218, linkPc \uc635\uc158<br>AL : linkIos, linkAnd, linkMo, linkPc \uc911 2\uac00\uc9c0 \ud544\uc218 \uc785\ub825<br>BK : \ud574\ub2f9 \ubc84\ud2bc \ud14d\uc2a4\ud2b8 \uc804\uc1a1<br>MD : \ud574\ub2f9 \ubc84\ud2bc \ud14d\uc2a4\ud2b8 + \uba54\uc2dc\uc9c0 \ubcf8\ubb38 \uc804\uc1a1<br>BC : \uc0c1\ub2f4\ud1a1 \uc804\ud658<br>BT : \ubd07 \uc804\ud658<br>DS : \uba54\uc2dc\uc9c0 \ub0b4 \uc1a1\uc7a5\ubc88\ud638 \uc774\uc6a9\ud55c \ubc30\uc1a1\uc870\ud68c\ud398\uc774\uc9c0\ub85c \uc5f0\uacb0 (quickReplies\uc0ac\uc6a9\ubd88\uac00)<br>AC : \ucc44\ub110\ucd94\uac00 -\uad11\uace0\ucd94\uac00\ud615, \ubcf5\ud569\ud615\ud15c\ud50c\ub9bf\uc5d0\uc11c\ub9cc \uc0ac\uc6a9\uac00\ub2a5 -\ubc84\ud2bc\ub2e8\ud1a1 \ub610\ub294 \ucd5c\uc0c1\ub2e8(\uccab\ubc88\uc9f8\ubc84\ud2bc)\uc5d0\ub9cc \ucd94\uac00\uac00\ub2a5 (quickReplies\uc0ac\uc6a9\ubd88\uac00)<\/p>\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> (\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8\ud615 \uc774\uc678\uc758 \ud15c\ud50c\ub9bf)<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">curl -X POST \"https:\/\/api.msghub.uplus.co.kr\/msg\/v1.2\/alimtalk\"\n  -H  \"accept: *\/*\"\n  -H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ...\"\n  -H  \"Content-Type: application\/json\"\n  -d '{\n    \"clickUrlYn\":\"n\",\n    \"filterYn\":\"y\",\n    \"filterGrpLst\":[]\n    \"callback\": \"0212341234\",\n    \"campaignId\": \"\ucea0\ud398\uc778ID\",\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    \"deptCode\": \"\ubd80\uc11c\ucf54\ub4dc\",\n    \"title\":\"\uc81c\ubaa9\",\n    \"msg\": \"#{name}\ub2d8, \uae08\uc77c #{time}\uc2dc \uc138\uc77c \uc815\ubcf4 \uc548\ub0b4\ub4dc\ub9bd\ub2c8\ub2e4.\",\n    \"kkoChId\": \"@\uce74\uce74\uc624\ucc44\ub110ID\",\n    \"tmpltCode\":\"\ud15c\ud50c\ub9bf\ucf54\ub4dc\",\n    \"service\":\"\uc11c\ube44\uc2a4\ubc88\ud638\",\n    \"buttons\": [\n        {\n            \"name\": \"\uc5f0\uacb0\ud558\uae30\",\n            \"linkType\": \"WL\",\n            \"linkMo\": \"https:\/\/\",\n            \"linkPc\": \"https:\/\/\",\n            \"linkAnd\": \"https:\/\/\",\n            \"linkIos\": \"https:\/\/\"\n        }\n    ],\n    \"recvInfoLst\": [\n        {\n            \"cliKey\": \"cliKey1\",\n            \"phone\": \"01012341234\",\n            \"mergeData\": {\n                \"name\": \"\ud64d\uae38\ub3d9\",\n                \"time\": \"3\uc2dc\"\n            },\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD12345\",\n            \"customerName\": \"\ud64d\uae38\ub3d9\",\n            \"amount\": 10000\n          }\n        },\n        {\n            \"cliKey\": \"cliKey2\",\n            \"phone\": \"01012341235\",\n            \"mergeData\": {\n                \"name\": \"\uae40\uae38\uc21c\",\n                \"time\": \"3\uc2dc\"\n            },\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD6789\",\n            \"customerName\": \"\uae40\ucca0\uc218\",\n            \"amount\": 10000\n          }\n        }\n    ],\n    \"fbInfoLst\": [\n        {\n            \"ch\": \"SMS\",\n            \"title\": \"\uc81c\ubaa9\",\n            \"msg\": \"SMS \uba54\uc2dc\uc9c0 \ub0b4\uc6a9\",\n            \"fileId\": \"test01\"\n        }\n    ],\n   \"groupKey\":\"grpxrss'\n  }<\/pre>\n\n\n\n<p><strong>Curl<\/strong> (\uc544\uc774\ud15c\ub9ac\uc2a4\ud2b8\ud615 \ud15c\ud50c\ub9bf)<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">curl -X POST \"https:\/\/api.msghub.uplus.co.kr\/msg\/v1.2\/alimtalk\"\n  -H  \"accept: *\/*\"\n  -H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ...\"\n  -H  \"Content-Type: application\/json\"\n  -d '{\n    \"clickUrlYn\":\"n\",\n    \"filterYn\":\"y\",\n    \"filterGrpLst\":[]\n    \"callback\": \"0212341234\",\n    \"campaignId\": \"\ucea0\ud398\uc778ID\",\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    \"deptCode\": \"\ubd80\uc11c\ucf54\ub4dc\",\n    \"title\":\"\uc81c\ubaa9\",\n    \"msg\": \"#{name}\ub2d8, \uae08\uc77c #{time}\uc2dc \uc138\uc77c \uc815\ubcf4 \uc548\ub0b4\ub4dc\ub9bd\ub2c8\ub2e4.\",\n    \"kkoChId\": \"@\uce74\uce74\uc624\ucc44\ub110ID\",\n    \"tmpltCode\":\"\ud15c\ud50c\ub9bf\ucf54\ub4dc\",\n    \"service\":\"\uc11c\ube44\uc2a4\ubc88\ud638\",\n    \"item\": {\n        \"list\": [\n          {\n            \"title\": \"test01\",\n            \"description\": \"test01\"\n          },\n          {\n            \"title\": \"test02\",\n            \"description\": \"test02\"\n          }\n        ],\n        \"summary\": {\n          \"title\": \"\ud14c\uc2a4\ud2b8\",\n          \"description\": \"1,000,000\uc6d0\"\n        }\n    },\n    \"itemHeader\":\"\ud5e4\ub354\",\n    \"itemHighlightTitle\": \"\ud0c0\uc774\ud2c0\",\n    \"itemHighlightDescription\": \"\uc124\uba85\",\n    \"buttons\": [\n        {\n            \"name\": \"\uc5f0\uacb0\ud558\uae30\",\n            \"linkType\": \"WL\",\n            \"linkMo\": \"https:\/\/\",\n            \"linkPc\": \"https:\/\/\",\n            \"linkAnd\": \"https:\/\/\",\n            \"linkIos\": \"https:\/\/\"\n        }\n    ],\n    \"recvInfoLst\": [\n        {\n            \"cliKey\": \"cliKey1\",\n            \"phone\": \"01012341234\",\n            \"mergeData\": {\n                \"name\": \"\ud64d\uae38\ub3d9\",\n                \"time\": \"3\uc2dc\"\n            },\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD12345\",\n            \"customerName\": \"\ud64d\uae38\ub3d9\",\n            \"amount\": 10000\n          }\n        },\n        {\n            \"cliKey\": \"cliKey2\",\n            \"phone\": \"01012341235\",\n            \"mergeData\": {\n                \"name\": \"\uae40\uae38\uc21c\",\n                \"time\": \"3\uc2dc\"\n            },\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD6789\",\n            \"customerName\": \"\uae40\ucca0\uc218\",\n            \"amount\": 10000\n          }\n        }\n    ],\n    \"fbInfoLst\": [\n        {\n            \"ch\": \"SMS\",\n            \"title\": \"\uc81c\ubaa9\",\n            \"msg\": \"SMS \uba54\uc2dc\uc9c0 \ub0b4\uc6a9\",\n            \"fileId\": \"test01\"\n        }\n    ],\n   \"groupKey\":\"grpxrss'\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\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"id27\">\uce74\uce74\uc624 \uce5c\uad6c\ud1a1 \ubc1c\uc1a1<\/h2>\n\n\n\n<p class=\"has-ast-global-color-1-color has-ast-global-color-4-background-color has-text-color has-background\" style=\"font-size:15px\">\uce74\uce74\uc624 \uce5c\uad6c\ud1a1 \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.2\/friendtalk 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>clickUrlYn<\/td><td>String<\/td><td>false<\/td><td>\ub2e8\ucd95URL \uc0ac\uc6a9\uc5ec\ubd80<\/td><\/tr><tr><td>filterYn<\/td><td>String<\/td><td>false<\/td><td>\ud544\ud130\ub9c1 \uc5ec\ubd80<\/td><\/tr><tr><td>filterGrpLst<\/td><td>ArrayList&lt;&gt;<\/td><td>false<\/td><td>\ud544\ud130\uadf8\ub8f9 <\/td><\/tr><tr><td>callback<\/td><td>String<\/td><td>true<\/td><td>\ubc1c\uc2e0\ubc88\ud638<\/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<\/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><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>deptCode<\/td><td>String<\/td><td>false<\/td><td>\ubd80\uc11c\ucf54\ub4dc<\/td><\/tr><tr><td>wideImageYn<\/td><td>String<\/td><td>true<\/td><td>\uc640\uc774\ub4dc \uc774\ubbf8\uc9c0 \uc5ec\ubd80(Y\/N)<\/td><\/tr><tr><td>fileId<\/td><td>String<\/td><td>false<\/td><td>\ud30c\uc77c \uc544\uc774\ub514<\/td><\/tr><tr><td>adFlag<\/td><td>String<\/td><td>true<\/td><td>\uad11\uace0 \ud45c\uae30 \uc5ec\ubd80(Y\/N)<\/td><\/tr><tr><td>msg<\/td><td>String<\/td><td>true<\/td><td><a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id28\">*<\/a>\uba54\uc2dc\uc9c0 \ub0b4\uc6a9<\/td><\/tr><tr><td>image<\/td><td>Image<\/td><td>false<\/td><td>\uc774\ubbf8\uc9c0<\/td><\/tr><tr><td>kkoChId<\/td><td>String<\/td><td>true<\/td><td>\uce74\uce74\uc624\ud1a1 \ucc44\ub110ID<\/td><\/tr><tr><td>buttons<\/td><td>List&lt;LMKakaoButton&gt;<\/td><td>false<\/td><td>\ubc84\ud2bc \ubaa9\ub85d<\/td><\/tr><tr><td>recvInfoLst<\/td><td>List&lt;<a href=\"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%eb%a9%94%ec%8b%9c%ec%a7%80-%ea%b4%80%eb%a0%a8-%ec%8a%a4%ed%82%a4%eb%a7%88\" data-type=\"internal\" data-id=\"#schema-recvinfo\">RecvInfo<\/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>fbInfoLst<\/td><td>List&lt;<a href=\"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%eb%a9%94%ec%8b%9c%ec%a7%80-%ea%b4%80%eb%a0%a8-%ec%8a%a4%ed%82%a4%eb%a7%88\" data-type=\"internal\" data-id=\"#schema-fbinfo\">FbInfo<\/a>&gt;<\/td><td>false<\/td><td>fallback \uc815\ubcf4 \ubaa9\ub85d<\/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>\ucc38\uace0<\/strong><\/p>\n\n\n\n<p class=\"has-ast-global-color-4-background-color has-background\" style=\"font-size:15px\"><strong>\uba54\uc2dc\uc9c0 \uae38\uc774 \uccb4\ud06c<br><\/strong>&#8211; \uc774\ubbf8\uc9c0 \uc5c6\ub294 \uc77c\ubc18 \uba54\uc2dc\uc9c0 : \ucd5c\ub300 1000\uc790<br>&#8211; \uc774\ubbf8\uc9c0\uac00 \uc788\ub294 \uacbd\uc6b0 : \ucd5c\ub300 400\uc790<br>&#8211; \uc640\uc774\ub4dc \uc774\ubbf8\uc9c0\uc77c \uacbd\uc6b0 : \ucd5c\ub300 76\uc790<\/p>\n\n\n\n<p><strong>Image&nbsp;\uc774\ubbf8\uc9c0<\/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>imgUrl<\/td><td>String<\/td><td>true<\/td><td>\uc774\ubbf8\uc9c0 URL<\/td><\/tr><tr><td>imgLink<\/td><td>String<\/td><td>false<\/td><td>\uc774\ubbf8\uc9c0 \ub9c1\ud06c<\/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>LMKakaoButton&nbsp;\ubc84\ud2bc<\/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>name<\/td><td>String<\/td><td>true<\/td><td>\ubc84\ud2bc\uc774\ub984<\/td><\/tr><tr><td>linkType<\/td><td>String<\/td><td>true<\/td><td>\ubc84\ud2bc\ud0c0\uc785(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id30\">*<\/a>\ud558\ub2e8 \ucc38\uc870)<\/td><\/tr><tr><td>linkMo<\/td><td>String<\/td><td>false<\/td><td>mobile \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc774\ub3d9\ud560 url, \ucd5c\ub300 255 Byte<\/td><\/tr><tr><td>linkPc<\/td><td>String<\/td><td>false<\/td><td>pc \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc774\ub3d9\ud560 url, \ucd5c\ub300 255 Byte<\/td><\/tr><tr><td>linkAnd<\/td><td>String<\/td><td>false<\/td><td>mobile android \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc2e4\ud589\ud560 application custom scheme<\/td><\/tr><tr><td>linkIos<\/td><td>String<\/td><td>false<\/td><td>mobile ios \ud658\uacbd\uc5d0\uc11c \ubc84\ud2bc \ud074\ub9ad \uc2dc \uc2e4\ud589\ud560 application custom scheme<\/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>\ucc38\uace0<\/strong><\/p>\n\n\n\n<p class=\"has-ast-global-color-1-color has-ast-global-color-4-background-color has-text-color has-background\" style=\"font-size:15px\"><strong>\ubc84\ud2bc\ud0c0\uc785<\/strong><br>WL : linkMo \ud544\uc218, linkPc \uc635\uc158<br>AL : linkIos, linkAnd, linkMo \uc911 2\uac00\uc9c0 \ud544\uc218 \uc785\ub825, linkPc<br>BK : \ud574\ub2f9 \ubc84\ud2bc \ud14d\uc2a4\ud2b8 \uc804\uc1a1<br>MD : \ud574\ub2f9 \ubc84\ud2bc \ud14d\uc2a4\ud2b8 + \uba54\uc2dc\uc9c0 \ubcf8\ubb38 \uc804\uc1a1<br>BC : \uc0c1\ub2f4\ud1a1 \uc804\ud658<br>BT : \ubd07 \uc804\ud658<br>DS : \uba54\uc2dc\uc9c0 \ub0b4 \uc1a1\uc7a5\ubc88\ud638 \uc774\uc6a9\ud55c \ubc30\uc1a1\uc870\ud68c\ud398\uc774\uc9c0\ub85c \uc5f0\uacb0 (quickReplies\uc0ac\uc6a9\ubd88\uac00)<br>AC : \ucc44\ub110\ucd94\uac00 -\uad11\uace0\ucd94\uac00\ud615, \ubcf5\ud569\ud615\ud15c\ud50c\ub9bf\uc5d0\uc11c\ub9cc \uc0ac\uc6a9\uac00\ub2a5 -\ubc84\ud2bc\ub2e8\ud1a1 \ub610\ub294 \ucd5c\uc0c1\ub2e8(\uccab\ubc88\uc9f8\ubc84\ud2bc)\uc5d0\ub9cc \ucd94\uac00\uac00\ub2a5 (quickReplies\uc0ac\uc6a9\ubd88\uac00)\u300b<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\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.2\/friendtalk\"\n-H  \"accept: *\/*\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ...\"\n-H  \"Content-Type: application\/json\"\n-d '\n  {\n    \"clickUrlYn\":\"n\",\n    \"filterYn\":\"y\",\n    \"filterGrpLst\":[]\n    \"callback\": \"0212341234\",\n    \"campaignId\": \"\ucea0\ud398\uc778ID\",\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    \"deptCode\": \"\ubd80\uc11c\ucf54\ub4dc\",\n    \"wideImageYn\": \"N\",\n    \"fileId\": \"\ud30c\uc77cID\",\n    \"adFlag\": \"N\",\n    \"msg\": \"#{name}\ub2d8, \uae08\uc77c #{time}\uc2dc \uc138\uc77c \uc815\ubcf4 \uc548\ub0b4\ub4dc\ub9bd\ub2c8\ub2e4.\",\n    \"kkoChId\": \"@\uce74\uce74\uc624\ucc44\ub110ID\",\n    \"buttons\": [\n        {\n            \"name\": \"\uc5f0\uacb0\ud558\uae30\",\n            \"linkType\": \"WL\",\n            \"linkMo\": \"https:\/\/\",\n            \"linkPc\": \"https:\/\/\",\n            \"linkAnd\": \"https:\/\/\",\n            \"linkIos\": \"https:\/\/\"\n        }\n    ],\n    \"recvInfoLst\": [\n        {\n            \"cliKey\": \"cliKey1\",\n            \"phone\": \"01012341234\",\n            \"mergeData\": {\n                \"name\": \"\ud64d\uae38\ub3d9\",\n                \"time\": \"3\uc2dc\"\n            },\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD12345\",\n            \"customerName\": \"\ud64d\uae38\ub3d9\",\n            \"amount\": 10000\n          }\n        },\n        {\n            \"cliKey\": \"cliKey2\",\n            \"phone\": \"01012341235\",\n            \"mergeData\": {\n                \"name\": \"\uae40\uae38\uc21c\",\n                \"time\": \"3\uc2dc\"\n            },\n            \"userCustomFields\": {\n            \"orderId\": \"Y_ORD6789\",\n            \"customerName\": \"\uae40\ucca0\uc218\",\n            \"amount\": 10000\n          }\n        }\n    ],\n    \"fbInfoLst\": [\n        {\n            \"ch\": \"SMS\",\n            \"title\": \"\uc81c\ubaa9\",\n            \"msg\": \"SMS \uba54\uc2dc\uc9c0 \ub0b4\uc6a9\",\n            \"fileId\": \"test01\"\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>\uce74\uce74\uc624 \uc54c\ub9bc\ud1a1 \ubc1c\uc1a1 \uce74\uce74\uc624 \uc54c\ub9bc\ud1a1 \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.2\/alimtalk 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 clickUrlYn String false \ub2e8\ucd95URL \uc0ac\uc6a9\uc5ec\ubd80 filterYn String false \ud544\ud130\ub9c1 \uc5ec\ubd80 filterGrpLst ArrayList 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":"","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\/3454"}],"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=3454"}],"version-history":[{"count":19,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3454\/revisions"}],"predecessor-version":[{"id":4099,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3454\/revisions\/4099"}],"wp:attachment":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/media?parent=3454"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_category?post=3454"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_tag?post=3454"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}