{"id":3458,"date":"2023-09-20T15:06:13","date_gmt":"2023-09-20T06:06:13","guid":{"rendered":"https:\/\/doc.msghub.uplus.co.kr\/guide\/?post_type=docs&#038;p=3458"},"modified":"2026-02-20T14:20:08","modified_gmt":"2026-02-20T05:20:08","slug":"push","status":"publish","type":"docs","link":"https:\/\/doc.msghub.uplus.co.kr\/guide\/d\/push\/","title":{"rendered":"api\uac00\uc774\ub4dc-\uba54\uc2dc\uc9c0 \ubc1c\uc1a1-PUSH"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">PUSH \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\">PUSH \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\/push 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>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&lt;Agency&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>msg<\/td><td>Object&lt;<a href=\"#schema-pushmsgbody\" data-type=\"internal\" data-id=\"#schema-pushmsgbody\">PushMsgBody<\/a>&gt;<\/td><td>true<\/td><td>\uba54\uc2dc\uc9c0 \ub0b4\uc6a9, \ucd5c\ub300 2000\uc790<\/td><\/tr><tr><td>appId<\/td><td>String<\/td><td>true<\/td><td>\uc571 \uc544\uc774\ub514<\/td><\/tr><tr><td>ext<\/td><td>HashMap&lt;String, String&gt;<\/td><td>false<\/td><td>\ud655\uc7a5 \ucee4\uc2a4\ud140 \uba54\uc2dc\uc9c0(<a href=\"https:\/\/docs.msghub.uplus.co.kr\/api\/msg.html#id33\">*<\/a>\ud558\ub2e8 \ucc38\uace0), \ucd5c\ub300 1000 Byte \uc774\ub0b4<\/td><\/tr><tr><td>fileId<\/td><td>String<\/td><td>false<\/td><td>\ud30c\uc77c \uc544\uc774\ub514<\/td><\/tr><tr><td>recvInfoLst<\/td><td>List&lt;<a href=\"#schema-pushrecvinfo\" data-type=\"internal\" data-id=\"#schema-pushrecvinfo\">PushRecvInfo<\/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\/wp-admin\/post.php?post=3465&amp;action=edit\" data-type=\"internal\" data-id=\"#schema-fbinfo\">FbInfo<\/a>&gt;<\/td><td>false<\/td><td>fallback \uc815\ubcf4 \ubaa9\ub85d<\/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<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>\ud655\uc7a5 \ucee4\uc2a4\ud140 \uba54\uc2dc\uc9c0<br><\/strong>\uc774\ubbf8\uc9c0 \ud478\uc2dc\ub97c \uc704\ud55c URL \ub610\ub294 \uc571 \uc0c1\uc138\ud398\uc774\uc9c0\ub97c \uafb8\ubc00 \ub370\uc774\ud0c0 \uc815\ubcf4 URL<br>ex) { \u300aimageUrl\u300b : \u300ahttp:\/\/\u2026\u300b, \u300adata1\u300b : \u300a\ud14c\uc2a4\ud2b8 1\u300b, \u300adata2\u300b : \u300a\ud14c\uc2a4\ud2b8 2\u300b, \u2026}<\/p>\n\n\n\n<p id=\"schema-pushmsgbody\"><strong>PushMsgBody&nbsp;\uba54\uc2dc\uc9c0 \ub0b4\uc6a9<\/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>title<\/td><td>String<\/td><td>false<\/td><td>\uc81c\ubaa9<\/td><\/tr><tr><td>body<\/td><td>String<\/td><td>false<\/td><td>\ub0b4\uc6a9<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p id=\"schema-pushrecvinfo\"><strong>PushRecvInfo&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>false<\/td><td>Fallback \uc218\uc2e0\ubc88\ud638(^[0-9-]{1,20}$)<\/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>mergeData<\/td><td>HashMap&lt;String, String&gt;<\/td><td>false<\/td><td>\uac00\ubcc0\ub370\uc774\ud130<\/td><\/tr><\/tbody><\/table><\/figure>\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\/push\"\n -H  \"accept: *\/*\"\n -H  \"Authorization: Bearer eyJhbGciOiJIUzI1NiJ...\"\n -H  \"Content-Type: application\/json\"\n -d '\n {\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   \"msg\": {\n       \"title\": \"push\uc81c\ubaa9\",\n       \"body\": \"#{name}\ub2d8, \uae08\uc77c #{time}\uc2dc \ubc30\uc1a1 \ub3c4\ucc29 \uc548\ub0b4\ub4dc\ub9bd\ub2c8\ub2e4.\"\n   },\n   \"appId\": \"appId01\",\n   \"ext\": {\n       \"imageUrl\" : \"http:\/\/...\",   \/\/ \uc774\ubbf8\uc9c0 \ud478\uc2dc\ub97c \uc704\ud55c URL \uc0ac\uc6a9\uc2dc\n       \"additionalProp1\": \"string\",\n       \"additionalProp2\": \"string\",\n       \"additionalProp3\": \"string\"\n   },\n   \"fileId\": \"test01\",\n   \"recvInfoLst\": [\n       {\n           \"cliKey\": \"cliKey1\",\n           \"phone\": \"01012341234\",\n           \"cuid\": \" APP \ub85c\uadf8\uc778ID\",\n           \"mergeData\": {\n               \"name\": \"\ud64d\uae38\ub3d9\",\n               \"time\": \"3\uc2dc\"\n           },\r\n            \"userCustomFields\": {\r\n            \"orderId\": \"Y_ORD12345\",\r\n            \"customerName\": \"\ud64d\uae38\ub3d9\",\r\n            \"amount\": 10000\r\n          }\n       },\n       {\n           \"cliKey\": \"cliKey2\",\n           \"phone\": \"01012341235\",\n           \"cuid\": \" APP \ub85c\uadf8\uc778ID\",\n           \"mergeData\": {\n               \"name\": \"\uae40\uae38\uc21c\",\n               \"time\": \"4\uc2dc\"\n           },\r\n            \"userCustomFields\": {\r\n            \"orderId\": \"Y_ORD6789\",\r\n            \"customerName\": \"\uae40\ucca0\uc218\",\r\n            \"amount\": 10000\r\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\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n","protected":false},"excerpt":{"rendered":"<p>PUSH \ubc1c\uc1a1 PUSH \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\/push 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 callback String true \ubc1c\uc2e0\ubc88\ud638 campaignId String false \ucea0\ud398\uc778 ID agency Object&lt;Agency&gt; false \ub300\ud589\uc0ac\/\uc7ac\ud310\ub9e4 \uc0ac\uc5c5\uc790 \ubc1c\uc1a1\uc815\ubcf4(\uc77c\ubc18\uc0ac\uc5c5\uc790\ub294 [&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\/3458"}],"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=3458"}],"version-history":[{"count":6,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3458\/revisions"}],"predecessor-version":[{"id":4101,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/docs\/3458\/revisions\/4101"}],"wp:attachment":[{"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/media?parent=3458"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_category?post=3458"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/doc.msghub.uplus.co.kr\/guide\/wp-json\/wp\/v2\/doc_tag?post=3458"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}