{"id":41216,"date":"2022-04-21T06:45:23","date_gmt":"2022-04-21T05:45:23","guid":{"rendered":"https:\/\/developer.kore.ai\/v10-1\/?p=41216"},"modified":"2022-04-21T06:45:41","modified_gmt":"2022-04-21T05:45:41","slug":"get-analytics-api","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/api-guide\/get-analytics-api\/?lang=ko","title":{"rendered":"\ubd84\uc11d API \uac00\uc838\uc624\uae30"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>API\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc758\ub3c4 \uac10\uc9c0 \ubc0f \uc791\uc5c5 \uc131\ub2a5\uacfc \uad00\ub828\ub41c \uba54\ud2b8\ub9ad \ub370\uc774\ud130\ub97c \ucd94\ucd9c\ud569\ub2c8\ub2e4. \ucc3e\uc740 \uc758\ub3c4\uc640 \uad00\ub828\ub41c \uba54\ud2b8\ub9ad \uc815\ubcf4, \uc758\ub3c4\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc74c, \uc2e4\ud328\ud55c \uc791\uc5c5, \uc131\uacf5\ud55c \uc791\uc5c5 \ubc0f \uc131\ub2a5 \ub85c\uadf8\ub97c \uac80\uc0c9\ud558\ub294 \ub370 \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4<\/p>\n<p class=\"note\">\uc774 API\ub97c \uc0ac\uc6a9\ud558\ub824\uba74 \uc571\uc740 <em>\uba54\ud2b8\ub9ad<\/em>\uc758 \ubd07 \ubc94\uc704\uac00 \ud544\uc694\ud569\ub2c8\ub2e4.<\/p>\n<p><b>POST <\/b><code>https:\/\/{{host}}\/api\/public\/bot\/{{BotID}}\/getAnalytics<\/code><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"i\">\uacbd\ub85c \ub9e4\uac1c \ubcc0\uc218<\/span><\/h3>\n<table>\n<tbody>\n<tr>\n<th><b>\ub9e4\uac1c \ubcc0\uc218<\/b><\/th>\n<th><b>\ud544\uc218\/\uc120\ud0dd \uc0ac\ud56d<\/b><\/th>\n<th><b>\uc124\uba85<\/b><\/th>\n<\/tr>\n<tr>\n<td>host<\/td>\n<td>\ud544\uc218<\/td>\n<td>\ud658\uacbd URL(\uc608: https:\/\/bots.kore.ai)<\/td>\n<\/tr>\n<tr>\n<td>BotID<\/td>\n<td>\ud544\uc218<\/td>\n<td>\ubd07 ID \ub610\ub294 \uc2a4\ud2b8\ub9bc ID. \ubd07\uc758 \uc77c\ubc18 \uc124\uc815 \ud398\uc774\uc9c0\uc5d0\uc11c \uc774\ub97c \uc561\uc138\uc2a4\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"i-2\">\ubcf8\ubb38 \ub9e4\uac1c \ubcc0\uc218<\/span><\/h3>\n<table>\n<tbody>\n<tr>\n<th><b>\ub9e4\uac1c \ubcc0\uc218<\/b><\/th>\n<th><b>\ud544\uc218\/\uc120\ud0dd \uc0ac\ud56d<\/b><\/th>\n<th><b>\uc124\uba85<\/b><\/th>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">type<\/span><\/td>\n<td>\ud544\uc218<\/td>\n<td>\n<p>\uc694\uccad\ub41c \uba54\ud2b8\ub9ad \uc720\ud615\uc740 \ub2e4\uc74c\uacfc \uac19\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<ul>\n<li>successintent<\/li>\n<li>failintent<\/li>\n<li>successtask<\/li>\n<li>failtask<\/li>\n<li>performance<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">filters<\/span><\/td>\n<td>\ud544\uc218<\/td>\n<td>\uacb0\uacfc \uc9d1\ud569\uc744 \ud544\ud130\ub9c1\ud558\uae30 \uc704\ud574 \ub2e4\uc74c \uc138\ubd80 \uc815\ubcf4\uac00 \uc788\ub294 \uac1c\uccb4<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">from<\/span><\/td>\n<td>\ud544\uc218<\/td>\n<td>\ub808\ucf54\ub4dc\ub97c \uace0\ub824\ud574\uc57c \ud558\ub294 \uc2dc\uc791 \ud0c0\uc784\uc2a4\ud0ec\ud504\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td>to<\/td>\n<td>\ud544\uc218<\/td>\n<td>\ub808\ucf54\ub4dc\ub97c \uace0\ub824\ud574\uc57c \ud558\ub294 \uc885\ub8cc \ud0c0\uc784\uc2a4\ud0ec\ud504\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td>limit<\/td>\n<td>\ud544\uc218<\/td>\n<td>\uac00\uc838\uc62c \ub808\ucf54\ub4dc \uc218\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td>channel<\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uba54\ud2b8\ub9ad\uc5d0 \ub300\ud574 \uace0\ub824\ud560 \ucc44\ub110\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td>channelUIds<\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uba54\ud2b8\ub9ad\uc5d0 \ud3ec\ud568\ub420 \uc0ac\uc6a9\uc790 ID(\ucc44\ub110 \uc9c0\uc815).<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">isAmbiguous<\/span><\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\ubaa8\ud638\ud55c \uc758\ub3c4\ub97c \ud3ec\ud568\ud560\uc9c0 \uc5ec\ubd80 &#8211; true \ub610\ub294 false \ub85c \uc124\uc815\ud569\ub2c8\ub2e4<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">isDeveloper<\/span><\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uac1c\ubc1c\uc790 \uba54\ud2b8\ub9ad\uc744 \ud3ec\ud568\ud560\uc9c0 \uc5ec\ubd80 &#8211; true \ub610\ub294 false\ub85c \uc124\uc815\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">trained<\/span><\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\ud559\uc2b5\ub41c \uc758\ub3c4\ub97c \ud3ec\ud568\ud560\uc9c0 \uc5ec\ubd80 &#8211; true \ub610\ub294 false\ub85c \uc124\uc815\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">taskId<\/span><\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uc791\uc5c5 ID\ub97c \uae30\uc900\uc73c\ub85c \ud544\ud130\ub9c1\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td>userId<\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uc0ac\uc6a9\uc790 ID\ub97c \uae30\uc900\uc73c\ub85c \ud544\ud130\ub9c1\ud569\ub2c8\ub2e4.<\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">tags<\/span><\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uc0ac\uc6a9\uc790 \uc9c0\uc815 \ud0dc\uadf8\ub97c \uae30\uc900\uc73c\ub85c \ud544\ud130\ub9c1\ud569\ub2c8\ub2e4.<br \/>\nUsage:<\/p>\n<pre>\"tags\": {\r\n         \"and\": [\r\n                 {\r\n                  \"name\": \"user\",\r\n                  \"values\": [\"uservalue\"],\r\n                  \"type\": \"user\"\r\n                  },\r\n                  {\r\n                   \"name\": \"message\",\r\n                   \"values\": [\"mvalue\"],\r\n                   \"type\": \"message\"\r\n                   }\r\n                ]\r\n           }<\/pre>\n<\/td>\n<\/tr>\n<tr>\n<td>sort<\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uacb0\uacfc\ub97c \uc815\ub82c\ud569\ub2c8\ub2e4.<br \/>\nUsage:<\/p>\n<pre>\"sort\": \r\n       { \"order\": \"&lt;desc\/asc&gt;\", \r\n          \"by\": \"&lt;column name&gt;\" }<\/pre>\n<\/td>\n<\/tr>\n<tr>\n<td>skip<\/td>\n<td>\uc120\ud0dd \uc0ac\ud56d<\/td>\n<td>\uacb0\uacfc \uc9d1\ud569\uc5d0\uc11c \uac74\ub108\ub6f4 \ub808\ucf54\ub4dc\uc758 \uc218\uc785\ub2c8\ub2e4.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"i-3\">\uad8c\ud55c \ubd80\uc5ec<\/span><\/h3>\n<p>\ub2e4\uc74c \uad6c\ubb38\uc744 \ud3ec\ud568\ud55c \ud5e4\ub354\uc5d0 JWT\ub97c \ud3ec\ud568\ud55c API\ub97c \ud638\ucd9c\ud569\ub2c8\ub2e4,<\/p>\n<p><code>auth: {{JWT}}<\/code><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"i-4\">\ucf58\ud150\uce20 \uc720\ud615 \uc751\ub2f5<\/span><\/h3>\n<p><code>application\/json<\/code><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"i-5\">\uc0d8\ud50c \uc694\uccad<\/span><\/h3>\n<pre>curl -X POST \\\r\n  https:\/\/{{host}}\/api\/public\/bot\/{{bot_id}}\/getAnalytics \\\r\n  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \\\r\n  -H 'content-type: application\/json' \\\r\n  -d '{\r\n       \"type\": \"successintent\",\r\n       \"filters\": {\r\n           \"from\": \"2020-08-11T17:25:09.698Z\",\r\n           \"to\": \"2020-08-21T17:25:09.698Z\",\r\n           \"tags\": {\r\n                    \"and\": [\r\n                     {\r\n                      \"name\": \"us2\",\r\n                      \"values\": [\r\n                             \"ss\"\r\n                             ],\r\n                       \"type\": \"user\"\r\n                       }\r\n                      ]\r\n                 },\r\n        \"channel\": [\r\n            \"rtm\"\r\n        ],\r\n        \"channelUIds\": [\r\n            \"test@kore.xyz\"\r\n        ],\r\n        \"isAmbiguous\": false,\r\n        \"isDeveloper\": true,\r\n        \"trained\": false,\r\n        \"taskId\": [\r\n            \"dg-xxxx\"\r\n        ],\r\n        \"userId\": [\r\n            \"u-5e4xxx85-f12e-53e2-929e-01xx7156xxx8\"\r\n        ]\r\n    },\r\n    \"limit\": 50\r\n}'<\/pre>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"i-6\">\uc0d8\ud50c \uc751\ub2f5<\/span><\/h3>\n<pre>{\r\n    \"moreAvailable\": true,\r\n    \"totalCount\": 49,\r\n    \"result\": [\r\n        {\r\n            \"messageId\": \"ms-439aa365-5240-52bf-ad10-bb0ef7b0d3c2\",\r\n            \"utterance\": \"newTask\",\r\n            \"intent\": \"newTask\",\r\n            \"userId\": \"u-5e4xxx85-f12e-53e2-929e-01xx7156xxx8\",\r\n            \"channelUId\": \"test@kore.xyz\",\r\n            \"language\": \"en\",\r\n            \"timestamp\": \"2020-08-20T18:49:19.877Z\",\r\n            \"pinned\": false,\r\n            \"channel\": \"rtm\",\r\n            \"taskName\": \"newTask\",\r\n            \"customTags\": {\r\n                \"userTags\": {\r\n                    \"name\": \"us2\",\r\n                    \"value\": \"ss\"\r\n                },\r\n                \"sessionTags\": [],\r\n                \"messageTags\": []\r\n            },\r\n            \"NLAnalysis\": {}\r\n        },\r\n        {\r\n            \"messageId\": \"ms-2cc0b4aa-2f95-5524-8b7b-2442929b3cf5\",\r\n            \"utterance\": \"newTask\",\r\n            \"intent\": \"newTask\",\r\n            \"userId\": \"u-5e4xxx85-f12e-53e2-929e-01xx7156xxx8\",\r\n            \"channelUId\": \"test@kore.xyz\",\r\n            \"language\": \"en\",\r\n            \"timestamp\": \"2020-08-20T18:49:14.237Z\",\r\n            \"pinned\": false,\r\n            \"channel\": \"rtm\",\r\n            \"taskName\": \"newTask\",\r\n            \"customTags\": {\r\n                \"userTags\": {\r\n                    \"name\": \"us2\",\r\n                    \"value\": \"ss\"\r\n                },\r\n                \"sessionTags\": [],\r\n                \"messageTags\": []\r\n            },\r\n            \"NLAnalysis\": {}\r\n        }\r\n    ]\r\n}\r\n<\/pre>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"API\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc758\ub3c4 \uac10\uc9c0 \ubc0f \uc791\uc5c5 \uc131\ub2a5\uacfc \uad00\ub828\ub41c \uba54\ud2b8\ub9ad \ub370\uc774\ud130\ub97c \ucd94\ucd9c\ud569\ub2c8\ub2e4. \ucc3e\uc740 \uc758\ub3c4\uc640 \uad00\ub828\ub41c \uba54\ud2b8\ub9ad \uc815\ubcf4, \uc758\ub3c4\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc74c, \uc2e4\ud328\ud55c \uc791\uc5c5, \uc131\uacf5\ud55c \uc791\uc5c5 \ubc0f \uc131\ub2a5 \ub85c\uadf8\ub97c \uac80\uc0c9\ud558\ub294 \ub370 \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4 \uc774 API\ub97c \uc0ac\uc6a9\ud558\ub824\uba74 \uc571\uc740 \uba54\ud2b8\ub9ad\uc758 \ubd07 \ubc94\uc704\uac00 \ud544\uc694\ud569\ub2c8\ub2e4. POST https:\/\/{{host}}\/api\/public\/bot\/{{BotID}}\/getAnalytics \uacbd\ub85c \ub9e4\uac1c \ubcc0\uc218 \ub9e4\uac1c \ubcc0\uc218 \ud544\uc218\/\uc120\ud0dd \uc0ac\ud56d \uc124\uba85 host \ud544\uc218 \ud658\uacbd URL(\uc608: https:\/\/bots.kore.ai)...","protected":false},"author":22,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[17],"tags":[],"class_list":["post-41216","post","type-post","status-publish","format-standard","hentry","category-api-guide"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/41216","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=41216"}],"version-history":[{"count":1,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/41216\/revisions"}],"predecessor-version":[{"id":41217,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/41216\/revisions\/41217"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=41216"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=41216"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=41216"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}