{"id":3463,"date":"2023-09-20T15:05:37","date_gmt":"2023-09-20T06:05:37","guid":{"rendered":"https:\/\/doc.msghub.uplus.co.kr\/guide\/?post_type=docs&#038;p=3463"},"modified":"2026-02-20T14:20:28","modified_gmt":"2026-02-20T05:20:28","slug":"%eb%a6%ac%ed%8f%ac%ed%8a%b8-%ec%b2%98%eb%a6%ac","status":"publish","type":"docs","link":"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/%eb%a6%ac%ed%8f%ac%ed%8a%b8-%ec%b2%98%eb%a6%ac\/","title":{"rendered":"api\uac00\uc774\ub4dc-\uba54\uc2dc\uc9c0 \ubc1c\uc1a1-\ub9ac\ud3ec\ud2b8 \ucc98\ub9ac"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">\ub9ac\ud3ec\ud2b8 \uc694\uccad (Polling \ubc29\uc2dd)<\/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\">\uc2e4\uc2dc\uac04\uc73c\ub85c \ucc98\ub9ac\uac00 \uc644\ub8cc\ub41c \uba54\uc2dc\uc9c0\uc758 \uacb0\uacfc\ub97c \uc804\ub2ec\ud569\ub2c8\ub2e4.<br>\uba54\uc2dc\uc9c0 \uacb0\uacfc\ub294 \ud55c\ubc88\ub9cc \uc804\ub2ec\ub429\ub2c8\ub2e4.<br><br><strong>\u25b6 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c \ub9ac\ud3ec\ud2b8 \uc694\uccad\uae30\ub2a5 \uad6c\ud604 \uc2dc \uc8fc\uc758\uc0ac\ud56d <br><\/strong>1) \ub9ac\ud3ec\ud2b8 \uc694\uccad \uacb0\uacfc\uac00 1\uac74\uc774\ub77c\ub3c4 \uc788\uc744 \uacbd\uc6b0, \ucc98\ub9ac \ud6c4 \ubc14\ub85c \ub2e4\uc74c \ub9ac\ud3ec\ud2b8 \uc694\uccad\uc744 \uc2dc\uc791\ud574\uc57c \ud569\ub2c8\ub2e4. <br>    \ub9cc\uc57d \ub9ac\ud3ec\ud2b8\uac00 \uc5c6\uc73c\uba74 \uc7a0\uc2dc \uc26c\uc5c8\ub2e4\uac00 \ub2e4\uc2dc \uc694\uccad\ud574\uc57c \ud569\ub2c8\ub2e4. \ub9ac\ud3ec\ud2b8\ub294 \ucd5c\ub300 100\uac1c\uae4c\uc9c0 \ud55c \ubc88\uc5d0 \ubc1b\uc544\uc11c \ubc30\uc5f4(Array)\ub85c \uc804\ub2ec\ub429\ub2c8\ub2e4.<br>2) \ub9ac\ud3ec\ud2b8 \uc694\uccad \uacb0\uacfc\uac00 \uc548 \uc624\uba74, \ubb34\ud55c\ud788 \uc694\uccad\ud558\ub294 \uac83\uc744 \ub9c9\uae30 \uc704\ud574 10\ucd08\ub9c8\ub2e4 \uc694\uccad\ud558\ub418, 10\ucd08 \uc774\ub0b4\uc5d0 \uc694\uccad\ud558\uba74 \uc2e4\ud328\ucc98\ub9ac\ud569\ub2c8\ub2e4.<br>3) \ub9ac\ud3ec\ud2b8 \uacb0\uacfc\uc5d0\ub294 report key\uac00 \uc788\uc2b5\ub2c8\ub2e4. \ub9ac\ud3ec\ud2b8 \ucc98\ub9ac\uac00 \ub05d\ub098\uba74 \ud574\ub2f9 report key\ub97c \ub9ac\ud3ec\ud2b8 \ucc98\ub9ac \uacb0\uacfc \uc804\ub2ec API\ub85c \uc804\ub2ec\ud574\uc57c \ud569\ub2c8\ub2e4. <br>     \ub9cc\uc57d 120\ucd08 \ub3d9\uc548 \uc804\ub2ec\ub418\uc9c0 \uc54a\uc73c\uba74 \ub9ac\ud3ec\ud2b8\ub294 \ub2e4\uc2dc \ub0b4\ub824\uac00\uba70, \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \uc911\ubcf5 \uc218\uc2e0\uc744 \ubc29\uc9c0\ud558\uae30 \uc704\ud574 \ud655\uc778 \ucc98\ub9ac\ub97c \ud574\uc57c \ud569\ub2c8\ub2e4.<br>4) \ub9ac\ud3ec\ud2b8\ub97c \uc694\uccad\ud558\uc9c0 \uc54a\uc73c\uba74 81\uc2dc\uac04 \ud6c4\uc5d0 \uc790\ub3d9\uc73c\ub85c \ub9cc\ub8cc\ucc98\ub9ac\ub429\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\">GET \/msg\/v1.2\/report 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<h3 class=\"wp-block-heading\">Response<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>code<\/td><td>String<\/td><td>\ub9ac\ud3ec\ud2b8 \uc694\uccad\uc5d0 \ub300\ud55c \uacb0\uacfc \uc751\ub2f5\ucf54\ub4dc<\/td><\/tr><tr><td>message<\/td><td>String<\/td><td>\ub9ac\ud3ec\ud2b8 \uc694\uccad\uc5d0 \ub300\ud55c \uacb0\uacfc \uc751\ub2f5\ucf54\ub4dc \uc124\uba85<\/td><\/tr><tr><td>data<\/td><td>List<\/td><td>\uacb0\uacfc \ub370\uc774\ud130 \ubaa9\ub85d<\/td><\/tr><tr><td>data.rptKey<\/td><td>String<\/td><td>\ub9ac\ud3ec\ud2b8 \ud0a4<\/td><\/tr><tr><td>data.rptCnt<\/td><td>Integer<\/td><td>\ub9ac\ud3ec\ud2b8 \uac1c\uc218<\/td><\/tr><tr><td>data.rptLst<\/td><td>List<\/td><td>\ub9ac\ud3ec\ud2b8 \ubaa9\ub85d<\/td><\/tr><tr><td>data.rptLst[].msgKey<\/td><td>String<\/td><td>U+ \uba54\uc2dc\uc9c0 \ud5c8\ube0c \uc2dc\uc2a4\ud15c\uc5d0\uc11c \ubd80\uc5ec\ud55c \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4<\/td><\/tr><tr><td>data.rptLst[].cliKey<\/td><td>String<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8\ud0a4: \uace0\uac1d\uc0ac\uc5d0\uc11c \ubd80\uc5ec\ud558\ub294 \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4<\/td><\/tr><tr><td>data.rptLst[].ch<\/td><td>String<\/td><td>\ucc44\ub110<\/td><\/tr><tr><td>data.rptLst[].resultCode<\/td><td>String<\/td><td>\uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \uacb0\uacfc\ucf54\ub4dc<\/td><\/tr><tr><td>data.rptLst[].resultCodeDesc<\/td><td>String<\/td><td>\uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \uacb0\uacfc\ucf54\ub4dc \uc124\uba85<\/td><\/tr><tr><td>data.rptLst[].fbReasonLst<\/td><td>List&lt;<a href=\"#schema-fbreason\" data-type=\"internal\" data-id=\"#schema-fbreason\">FbReason<\/a>&gt;<\/td><td>Fallback \uc0ac\uc720<\/td><\/tr><tr><td>data.rptLst[].telco<\/td><td>String<\/td><td>\uc774\ud1b5\uc0ac(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id39\">*<\/a>xMS, RCS\ub9cc \ud574\ub2f9)<\/td><\/tr><tr><td>data.rptLst[].rptDt<\/td><td>String<\/td><td>\uacb0\uacfc \uc218\uc2e0 \uc77c\uc2dc<\/td><\/tr><tr><td>data.rptLst[].productCode<\/td><td>String<\/td><td>\uc0c1\ud488\ucf54\ub4dc<\/td><\/tr><\/tbody><\/table><\/figure>\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 GET \"https:\/\/api.msghub.uplus.co.kr\/msg\/v1.2\/report\"\n-H  \"accept: *\/*\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ...\"<\/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    \"rptKey\": \"rptKey\",\n    \"rptCnt\": 100,\n    \"rptLst\": [\n      {\n        \"msgKey\": \"msgKey\",\n        \"cliKey\": \"cliKey\",\n        \"ch\": \"SMS\",\n        \"resultCode\": \"21003\",\n        \"resultCodeDesc\": \"\ubc1c\uc1a1\ud0c0\uc784\uc544\uc6c3\",\n        \"fbReasonLst\": [\n          {\n            \"ch\":\"RCS\",\n            \"fbResultCode\":\"51004\",\n            \"fbResultDesc\":\"Parameter Error\",\n            \"telco\":\"KT\"\n          }\n        ],\n        \"productCode\": \"SMS\",\n        \"telco\": null,\n        \"rptDt\": null\n      },\n      {\n        \"msgKey\": \"msgKey\",\n        \"cliKey\": \"cliKey\",\n        \"ch\": \"SMS\",\n        \"resultCode\": \"21003\",\n        \"resultCodeDesc\": \"\ubc1c\uc1a1\ud0c0\uc784\uc544\uc6c3\",\n        \"fbReasonLst\": [\n          {\n            \"ch\":\"RCS\",\n            \"fbResultCode\":\"51004\",\n            \"fbResultDesc\":\"Parameter Error\",\n            \"telco\":\"KT\"\n          }\n        ],\n        \"productCode\": \"SMS\",\n        \"telco\": null,\n        \"rptDt\": null\n      }\n      ....\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>\u00a0\ucc38\uace0<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ub9ac\ud3ec\ud2b8 \ucc98\ub9ac\uacb0\uacfc \uc804\ub2ec (polling \ubc29\uc2dd )<\/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\">\uc694\uccad\ub41c \ub9ac\ud3ec\ud2b8 \ud0a4\uc5d0 \ud574\ub2f9\ud558\ub294 \ub9ac\ud3ec\ud2b8\ub97c \uc644\ub8cc \ucc98\ub9ac\ud558\uba74, \ud574\ub2f9 \ub9ac\ud3ec\ud2b8 \uacb0\uacfc\ub97c \uc804\ub2ec\ud574\uc57c \ud569\ub2c8\ub2e4. <br>\ub9cc\uc57d 120\ucd08 \ub3d9\uc548 \ub9ac\ud3ec\ud2b8 \ucc98\ub9ac \uacb0\uacfc \uc804\ub2ec\uc774 \uc548 \ub418\uba74, \ub9ac\ud3ec\ud2b8 \uc694\uccad \uc2dc \ub3d9\uc77c\ud55c \ub9ac\ud3ec\ud2b8 \ubaa9\ub85d\uc774 \ub2e4\uc2dc \uc804\ub2ec\ub429\ub2c8\ub2e4. <br>\uc774 \uacbd\uc6b0 \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \uc911\ubcf5 \uc218\uc2e0\uc744 \ubc29\uc9c0\ud558\uae30 \uc704\ud574 \ud655\uc778 \ucc98\ub9ac\ub97c \ud574\uc57c \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\/report\/result HTTP\/1.1\nAuthorization: Bearer {token}\nContent-Type: application\/json\nHost: api.msghub.uplus.co.kr<\/pre>\n\n\n\n<p><strong><strong> Request<\/strong> <strong>Body<\/strong><\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>rptKeyLst<\/td><td>List&lt;String&gt;<\/td><td>\ub9ac\ud3ec\ud2b8 \uc804\ub2ec (polling \ubc29\uc2dd ) API \uc2e4\ud589 \ud6c4 \ub9ac\ud134\ubc1b\uc740 rptKey \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<h3 class=\"wp-block-heading\">Response<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>HTTP<\/th><th>Description<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>200<\/td><td>\uc131\uacf5<\/td><td>\ub9ac\ud3ec\ud2b8 \uc694\uccad\uc5d0 \ub300\ud55c \uacb0\uacfc \uc751\ub2f5\ucf54\ub4dc<\/td><\/tr><tr><td>400<\/td><td>\uc2e4\ud328<\/td><td>\ub9ac\ud3ec\ud2b8 \uc694\uccad\uc5d0 \ub300\ud55c \uacb0\uacfc \uc751\ub2f5\ucf54\ub4dc \uc124\uba85<\/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<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 GET \"https:\/\/api.msghub.uplus.co.kr\/msg\/v1.2\/report\/result\"\n-H  \"accept: *\/*\"\n-H  \"Content-Type: application\/json\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiYWNjZXNzVXJsIjoiYXV0aCIsImlzcyI6ImNtLmxndXBsdX...\"\n-d '{\n        \"rptKeyLst\": [\n           \"RPsAOqHDhO\"\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>\u00a0\ucc38\uace0<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ub9ac\ud3ec\ud2b8 \uc804\ub2ec (Webhook \ubc29\uc2dd)<\/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\">\uc2e4\uc2dc\uac04\uc73c\ub85c \ucc98\ub9ac\uac00 \uc644\ub8cc\ub41c \uba54\uc2dc\uc9c0\uc758 \uacb0\uacfc\ub97c \uc804\ub2ec\ud569\ub2c8\ub2e4. <br><br>\uba54\uc2dc\uc9c0\ub97c \uc218\uc2e0\ud560\uc218 \uc788\ub294 \uc6f9\ud6c5 URL\uc815\ubcf4\ub97c \uc0ac\uc804\uc5d0 \ub4f1\ub85d\ud574\uc11c \uc0ac\uc6a9\ud574\uc57c \ud569\ub2c8\ub2e4. <br>\uba54\uc2dc\uc9c0\ub294 API KEY \uc0c1\uc138\uc5d0\uc11c \uc124\uc815\ud55c \uace0\uac1d\uc0ac \uc6f9\ud6c5 URL \uc815\ubcf4\ub85c \uc804\ub2ec\ud569\ub2c8\ub2e4. <br><br>\uba54\uc2dc\uc9c0 \uacb0\uacfc\ub294 \ud55c\ubc88\ub9cc \uc804\ub2ec\ub429\ub2c8\ub2e4.<br><br>\uba54\uc2dc\uc9c0 \uc804\ub2ec \uc2e4\ud328 \uc2dc, \ud2b9\uc815\uc2dc\uac04 \uc774\ud6c4 \uc7ac\uc2dc\ub3c4 \ud569\ub2c8\ub2e4.  (10\ucd08:\uc774\ud6c4 \ubcc4\ub3c4 \uacf5\uc9c0\uc5c6\uc774 \ubcc0\uacbd\ub420 \uc218 \uc788\uc74c)<br>\ub9ac\ud3ec\ud2b8\ub294 \ud2b9\uc815\uc2dc\uac04 \ub3d9\uc548 \ubcf4\uad00\ub429\ub2c8\ub2e4. (72\uc2dc\uac04:\uc774\ud6c4 \ubcc4\ub3c4 \uacf5\uc9c0\uc5c6\uc774 \ubcc0\uacbd\ub420 \uc218 \uc788\uc74c) <\/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\"><strong>POST<\/strong> <em>#{WEBHOOK_URL\uc758 uri}<\/em> HTTP\/1.1\nContent-Type: application\/json\nHost: <em>#{WEBHOOK_URL\uc758 host}<\/em><\/pre>\n\n\n\n<p><strong> Request<\/strong> <strong>Body<\/strong><\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>rptCnt<\/td><td>Integer<\/td><td> \ub9ac\ud3ec\ud2b8 \uac1c\uc218(\ucd5c\ub300: 100\uac1c) <\/td><\/tr><tr><td>rptLst<\/td><td>List<\/td><td>\ub9ac\ud3ec\ud2b8 \ubaa9\ub85d<\/td><\/tr><tr><td>rptLst[].msgKey<\/td><td>String<\/td><td>U+ \uba54\uc2dc\uc9c0 \ud5c8\ube0c \uc2dc\uc2a4\ud15c\uc5d0\uc11c \ubd80\uc5ec\ud55c \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4<\/td><\/tr><tr><td>rptLst[].cliKey<\/td><td>String<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8\ud0a4: \uace0\uac1d\uc0ac\uc5d0\uc11c \ubd80\uc5ec\ud558\ub294 \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4<\/td><\/tr><tr><td>rptLst[].ch<\/td><td>String<\/td><td>\ucc44\ub110<\/td><\/tr><tr><td>rptLst[].resultCode<\/td><td>String<\/td><td>\uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \uacb0\uacfc\ucf54\ub4dc<\/td><\/tr><tr><td>rptLst[].resultCodeDesc<\/td><td>String<\/td><td>\uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \uacb0\uacfc\ucf54\ub4dc \uc124\uba85<\/td><\/tr><tr><td>rptLst[].productCode<\/td><td>String<\/td><td>\uc0c1\ud488\ucf54\ub4dc<\/td><\/tr><tr><td>rptLst[].fbReasonLst<\/td><td>List&lt;<a href=\"#schema-fbreason\" data-type=\"internal\" data-id=\"#schema-fbreason\">FbReason<\/a>&gt;<\/td><td>Fallback \uc0ac\uc720<\/td><\/tr><tr><td>rptLst[].telco<\/td><td>String<\/td><td>\uc774\ud1b5\uc0ac(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id39\">*<\/a>xMS, RCS\ub9cc \ud574\ub2f9)<\/td><\/tr><tr><td>rptLst[].rptDt<\/td><td>String<\/td><td>\uacb0\uacfc \uc218\uc2e0 \uc77c\uc2dc<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Response<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>HTTP<\/th><th>Description<\/th><th>\ube44\uace0<\/th><\/tr><\/thead><tbody><tr><td>200<\/td><td>\uc131\uacf5<\/td><td><\/td><\/tr><tr><td>204<\/td><td>\uc131\uacf5<\/td><td>\uc751\ub2f5 \ud639\uc740 \ucc98\ub9ac \ud560 \ub9ac\ud3ec\ud2b8\uac00 \uc5c6\uc74c<\/td><\/tr><tr><td>400<\/td><td>\uc2e4\ud328<\/td><td>\uc2e4\ud328\ub85c \uc804\ub2ec\uc2dc \uc7ac\ucc98\ub9ac \uac00\ub2a5\ud568<\/td><\/tr><\/tbody><\/table><\/figure>\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:\/\/<strong>{WEBHOOK_URL}<\/strong>\"\n-H  \"accept: *\/*\"\n-H  \"Content-Type: application\/json\"\n-d\n  {\n     \"rptCnt\": 1,\n     \"rptLst\": [\n         {\n            \"msgKey\": \"lXXYpOIuCd.6cGlYN\",\n            \"cliKey\": \"test2\",\n            \"ch\": \"SMS\",\n            \"resultCode\": \"10000\",\n            \"resultCodeDesc\": \"\uc131\uacf5\",\n            \"productCode\":\"SMS\",\n            \"fbReasonLst\": null,\n            \"telco\": \"KT\",\n            \"rptDt\": \"2022-04-19T15:01:40\"\n         }\n     ]\n  }<\/pre>\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=\"id1\"> \ub9ac\ud3ec\ud2b8 \uc870\ud68c<\/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\">cliKey\ub85c \uba54\uc2dc\uc9c0 \uc0c1\ud0dc\ub97c \uc870\ud68c\ud569\ub2c8\ub2e4. <br>\ucd5c\ub300 90\uc77c\uae4c\uc9c0 \uc870\ud68c\uac00 \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\/sent 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>Description<\/th><th>\ube44\uace0<\/th><\/tr><\/thead><tbody><tr><td>cliKeyLst<\/td><td>List&lt;ReqSentMsg&gt;<\/td><td>\uc694\uccad cliKey \uc815\ubcf4 \ubaa9\ub85d<\/td><td> \ucd5c\ub300 10\uac74<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>ReqSentMsg<\/strong> <strong>\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>reqDt<\/td><td>String<\/td><td>true<\/td><td>\ubc1c\uc1a1\uc77c\uc790 (2022-11-04)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n<div class=\"wp-block-spacer\" style=\"height: 20px\" aria-hidden=\"true\">&nbsp;<\/div>\n\n\n<h3 class=\"wp-block-heading\">Response<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Name<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>code<\/td><td>String<\/td><td>\ub9ac\ud3ec\ud2b8 \ud655\uc778 \uc694\uccad\uc5d0 \ub300\ud55c \uacb0\uacfc \uc751\ub2f5\ucf54\ub4dc<\/td><\/tr><tr><td>message<\/td><td>String<\/td><td>\ub9ac\ud3ec\ud2b8  \ud655\uc778 \uc694\uccad\uc5d0 \ub300\ud55c \uacb0\uacfc \uc751\ub2f5\ucf54\ub4dc \uc124\uba85<\/td><\/tr><tr><td>data<\/td><td>List<\/td><td>\uacb0\uacfc \ub370\uc774\ud130<\/td><\/tr><tr><td>data.cliKeyLst<\/td><td>List<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8\ud0a4 \ubaa9\ub85d<\/td><\/tr><tr><td>data.cliKeyLst[].msgKey<\/td><td>String<\/td><td>U+ \uba54\uc2dc\uc9c0 \ud5c8\ube0c \uc2dc\uc2a4\ud15c\uc5d0\uc11c \ubd80\uc5ec\ud55c \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4<\/td><\/tr><tr><td>data.cliKeyLst[].cliKey<\/td><td>String<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8\ud0a4: \uace0\uac1d\uc0ac\uc5d0\uc11c \ubd80\uc5ec\ud558\ub294 \uba54\uc2dc\uc9c0 \uace0\uc720 \ud0a4<\/td><\/tr><tr><td>data.cliKeyLst[].status<\/td><td> String <\/td><td>\uba54\uc2dc\uc9c0 \uc0c1\ud0dc<\/td><\/tr><tr><td>data.cliKeyLst[].ch<\/td><td>String<\/td><td>\ucc44\ub110<\/td><\/tr><tr><td>data.cliKeyLst[].resultCode<\/td><td>String<\/td><td>\uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \uacb0\uacfc\ucf54\ub4dc<\/td><\/tr><tr><td>data.cliKeyLst[].resultCodeDesc<\/td><td>String<\/td><td>\uba54\uc2dc\uc9c0 \ubc1c\uc1a1 \uacb0\uacfc\ucf54\ub4dc \uc124\uba85<\/td><\/tr><tr><td>data.cliKeyLst[].fbReasonLst<\/td><td>List&lt;FbReason&gt;<\/td><td>Fallback \uc0ac\uc720<\/td><\/tr><tr><td>data.cliKeyLst[].telco<\/td><td>String<\/td><td>\uc774\ud1b5\uc0ac(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id39\">*<\/a>xMS, RCS\ub9cc \ud574\ub2f9) \ub610\ub294<br>\uce74\uce74\uc624 \ub51c\ub7ec\uc0ac(API Key \uc124\uc815: \uacb0\uacfc \ub51c\ub7ec\uc0ac \uc815\ubcf4 \uc81c\uacf5 Y\uc778 \uacbd\uc6b0)<\/td><\/tr><tr><td>data.cliKeyLst[].rptDt<\/td><td>String<\/td><td>\uacb0\uacfc \uc218\uc2e0 \uc77c\uc2dc<\/td><\/tr><tr><td>data.cliKeyLst[].productCode<\/td><td>String<\/td><td>\uc0c1\ud488\ucf54\ub4dc<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p> <strong>\ucc38\uace0<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><strong>\uba54\uc2dc\uc9c0 \uc0c1\ud0dc<\/strong>\nREG : \uc811\uc218\uc644\ub8cc\nING : \ucc98\ub9ac\uc911\nDONE : \uc644\ub8cc\nOVER_DATE : \uc870\ud68c\uae30\uac04 \ucd08\uacfc(\ucd5c\ub300 90\uc77c)\nINVALID_KEY : \uc798\ubabb\ub41c \uba54\uc2dc\uc9c0\ud0a4<\/pre>\n\n\n\n<p> <strong>FbReason&nbsp;Fallback \uc0ac\uc720<\/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>ch<\/td><td>String<\/td><td>true<\/td><td>\ucc44\ub110<\/td><\/tr><tr><td>fbResultCode<\/td><td>String<\/td><td>true<\/td><td>fb \uacb0\uacfc\ucf54\ub4dc<\/td><\/tr><tr><td>fbResultDesc<\/td><td>String<\/td><td>true<\/td><td>fb \uacb0\uacfc\uc124\uba85<\/td><\/tr><tr><td>telco<\/td><td>String<\/td><td>false<\/td><td>\uc774\ud1b5\uc0ac(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id39\">*<\/a>xMS, RCS\ub9cc \ud574\ub2f9) \ub610\ub294<br>\uce74\uce74\uc624 \ub51c\ub7ec\uc0ac(API Key \uc124\uc815: \uacb0\uacfc \ub51c\ub7ec\uc0ac \uc815\ubcf4 \uc81c\uacf5 Y\uc778 \uacbd\uc6b0)<\/td><\/tr><\/tbody><\/table><\/figure>\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 GET \"https:\/\/api.msghub.uplus.co.kr\/mo\/v1\/sent\"\n-H  \"accept: *\/*\"\n-H  \"Content-Type: application\/json\"\n-H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiYWNjZXNzVXJsIjoiYXV0aCIsImlzcyI6ImNtLmxndXBsdX...\"\n-d '{\n        \"cliKeyLst\": [\n           {\n              \"cliKey\": \"cliKey\",\n              \"reqDt\": \"2022-12-02\"\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    \"cliKeyLst\": [\n      {\n        \"msgKey\": \"ymk5q2XqOh.12345\",\n        \"cliKey\": \"1\",\n        \"ch\": \"SMS\",\n        \"status\": \"DONE\",\n        \"resultCode\": \"30124\",\n        \"resultCodeDesc\": \"\ube44\uac00\uc785\uc790,\uacb0\ubc88,\uc11c\ube44\uc2a4\uc815\uc9c0\",\n        \"telco\": \"ETC\",\n        \"fbReasonLst\": [\n          {\n            \"ch\": \"RCS\",\n            \"fbResultCode\": \"51004\",\n            \"fbResultDesc\": \"Parameter Error\",\n            \"telco\": \"KT\"\n          }\n        ],\n        \"rptDt\": \"2022-05-24T10:35:45\"\n        \"productCode\": \"LMS\"\n      }\n    ]\n  }\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>\ub9ac\ud3ec\ud2b8 \uc694\uccad (Polling \ubc29\uc2dd) \uc2e4\uc2dc\uac04\uc73c\ub85c \ucc98\ub9ac\uac00 \uc644\ub8cc\ub41c \uba54\uc2dc\uc9c0\uc758 \uacb0\uacfc\ub97c \uc804\ub2ec\ud569\ub2c8\ub2e4.\uba54\uc2dc\uc9c0 \uacb0\uacfc\ub294 \ud55c\ubc88\ub9cc \uc804\ub2ec\ub429\ub2c8\ub2e4. \u25b6 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c \ub9ac\ud3ec\ud2b8 \uc694\uccad\uae30\ub2a5 \uad6c\ud604 \uc2dc \uc8fc\uc758\uc0ac\ud56d 1) \ub9ac\ud3ec\ud2b8 \uc694\uccad \uacb0\uacfc\uac00 1\uac74\uc774\ub77c\ub3c4 \uc788\uc744 \uacbd\uc6b0, \ucc98\ub9ac \ud6c4 \ubc14\ub85c \ub2e4\uc74c \ub9ac\ud3ec\ud2b8 \uc694\uccad\uc744 \uc2dc\uc791\ud574\uc57c \ud569\ub2c8\ub2e4. \ub9cc\uc57d \ub9ac\ud3ec\ud2b8\uac00 \uc5c6\uc73c\uba74 \uc7a0\uc2dc \uc26c\uc5c8\ub2e4\uac00 \ub2e4\uc2dc \uc694\uccad\ud574\uc57c \ud569\ub2c8\ub2e4. \ub9ac\ud3ec\ud2b8\ub294 \ucd5c\ub300 100\uac1c\uae4c\uc9c0 \ud55c \ubc88\uc5d0 \ubc1b\uc544\uc11c \ubc30\uc5f4(Array)\ub85c \uc804\ub2ec\ub429\ub2c8\ub2e4.2) \ub9ac\ud3ec\ud2b8 \uc694\uccad \uacb0\uacfc\uac00 \uc548 [&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\/3463"}],"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=3463"}],"version-history":[{"count":12,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3463\/revisions"}],"predecessor-version":[{"id":4103,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3463\/revisions\/4103"}],"wp:attachment":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/media?parent=3463"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_category?post=3463"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_tag?post=3463"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}