시작
Kore.ai 대화형 플랫폼
챗봇 개요
자연어 처리(NLP)
봇 개념 및 용어들
빠른 시작 가이드
봇 빌더 접근 방법
사용 고지 사항 (영어)
Kore.ai 봇 빌더로 작업하기
봇 구축 시작하기
릴리스 정보
현재 버전 (영어)
이전 버전 (영어)

개념
디자인
스토리보드
대화 작업
개요
Using the Dialog Builder Tool
노드 유형
사용자 의도 노드
대화 노드
엔티티 노드
양식 노드
확인 노드
서비스 노드
봇 조치 노드
Service Node
WebHook 노드
스크립트 노드
노드 그룹화하기
Agent Transfer Node
사용자 프롬프트
음성 통화 속성
대화 관리
노드 및 전환
구성 요소 전환
컨텍스트 개체
이벤트 기반 봇 조치
지식 그래프
소개
지식 추출
지식 그래프 생성
봇에 지식 그래프 추가
그래프 생성
지식 그래프 작성
FAQ 추가
작업 실행
기존 소스에서 FAQ 구축
특성, 동의어 및 불용어
변수 네임스페이스 관리
수정
용어 편집 및 삭제
용어 편집 및 삭제
질문과 응답 편집
Knowledge Graph Training
지식 그래프 분석
봇 온톨로지 가져오기 및 내보내기
지식 그래프 가져오기
지식 그래프 내보내기
지식 그래프 생성
CSV 파일에서
JSON 파일
지식 그래프 생성
경고 작업
스몰 토크
Digital Skills
디지털 양식
Views
Digital Views
Panels
Widgets
기차
봇 성능 향상 – NLP 최적화
기계 학습
소개
모델 검증
기초 의미
지식 그래프 학습
특성
순위 및 해결
고급 NLP 설정
NLP 설정 및 지침
봇 인텔리전스
소개
컨텍스트 관리
컨텍스트 관리
대화 관리
다중 – 의도 탐지
엔티티 수정
기본 대화
정서 관리
어조 분석
Test & Debug
봇과 대화
발화 테스트
배치 테스트하기
대화 테스트
배포
채널 활성화
봇 게시
분석
봇 분석하기
Conversations Dashboard
Performance Dashboard
사용자 정의 대시보드
소개
맞춤형 메타 태그
사용자 정의 대시보드 생성 방법
Conversation Flows
NLP 지표
Containment Metrics
사용량 지표
스마트 봇
소개
범용 봇
소개
범용 봇 정의
범용 봇 생성
범용 봇 학습
범용 봇 커스터마이징
범용 봇용 추가 언어 활성화
스토어
Manage Assistant
플랜 및 사용량
Overview
Usage Plans
Support Plans
플랜 관리
봇 인증
다국어 봇
개인 식별 정보 삭제하기
봇 변수 사용
IVR 통합
일반 설정
봇 관리

방법
간단한 봇 생성하기
Design Conversation Skills
뱅킹 봇 생성
뱅킹 봇 – 자금 이체
뱅킹 봇 – 잔액 업데이트
Knowledge Graph (KG) 구축
스마트 경고를 예약하는 방법
Design Digital Skills
디지털 양식 설정 방법
디지털 보기 설정 방법
데이터 테이블에 데이터를 추가하는 방법
데이터 테이블 내 데이터 업데이트 방법
UI 양식에서 데이터 테이블에 데이터를 추가하는 방법
Train the Assistant
특성 사용 방법
의도와 엔티티에 대한 패턴 사용 방법
컨텍스트 전환 관리 방법
Deploy the Assistant
상담사 전환을 설정하는 방법
봇 기능 사용 방법
콘텐츠 변수 사용 방법
전역 변수 사용 방법
Kore.ai 웹 SDK 튜토리얼
Kore.ai 위젯 SDK 튜토리얼
Analyze the Assistant
사용자 정의 대시보드 생성 방법
사용자 지정 태그를 사용하여 봇 메트릭을 필터링하는 방법

API 및 SDK
API 참조
Kore.ai API 사용
API 목록
API 컬렉션
koreUtil Libraries
SDK 참조
상담사 전환을 설정하는 방법
봇 기능 사용 방법
콘텐츠 변수 사용 방법
전역 변수 사용 방법
소개
Kore.ai 웹 SDK 튜토리얼
Kore.ai 위젯 SDK 튜토리얼

관리
소개
봇 관리자 콘솔
대시보드
사용자 관리
사용자 관리
그룹 관리
역할 관리
봇 관리 모듈
등록
사용자 초대
사용자 등록을 위한 대량 초대 보내기
사용자 및 사용자 데이터 가져오기
Active Directory에서 사용자 동기화
보안 및 준수
싱글 사인 온 사용
보안 설정
Kore.ai 커넥터
봇 관리자용 분석
Billing (지원하지 않음)
  1. Docs
  2. Virtual Assistants
  3. API Guide
  4. 대화 기록 API

대화 기록 API

봇과 사용자 간의 대화 메시지를 시간 역순으로 가져옵니다. 이 API는 페이지 매김 기능을 지원합니다. 오프셋/건너뛰기를 제공하고 한 번에 특정 메시지 수를 제한할 수 있습니다. 이 버전은 조만간 사용되지 않을 이전 API의 새로운 버전입니다. 이 수정된 API는 이전 버전에서의 BotKit 또는 상담사 전환 활성화의 한계를 해결합니다.

이 API를 사용하려면 앱은 채팅 기록의 봇 빌더 API 범위가 필요합니다. 또는 봇 분석 아래 채팅 기록의 관리자 API 범위가 필요합니다.

GEThttps://{{host}}/api/public/bot/{{BotID}}/getMessages?userId={{userID}}&skip=10&limit=10

POST API 호출은 검색된 대화 기록의 Session-Id 및 MetaTags를 포함하는 데 사용할 수도 있습니다.

POST
https://{{host}}/api/public/bot/{{BotID}}/getMessageshttps://{{host}}/api/public/getMessages 봇 관리자 콘솔의 경우

매개 변수

매개 변수 설명
BotID(선택 사항) 봇 ID입니다. 봇의 일반 설정 페이지에서 액세스할 수 있습니다.
userId (POST 호출의 GET 호출에 필수) 액세스할 대화 기록을 가진 사용자의 ID입니다. 사용자 이메일 ID 또는 엔터프라이즈에서 할당한 고유 ID가 될 수 있습니다.
skip/offset (선택 사항) 건너뛸 메시지 수입니다.
limit(선택 사항) 각 페이지에 표시할 메시지 수입니다.
forward(선택 사항)

부울 값을 true/false로 사용합니다. 검색할 메시지의 방향을 지정합니다.

  • 값이 true이면 대화 기록은 오래된 항목부터 최신 항목까지 순서대로 검색됩니다.
  • 값이 false이면 대화 기록이 가장 최근의 메시지부터 가장 오래된 메시지까지, 즉, 역순으로 검색됩니다
dateFrom(선택 사항) Yyyy-mm-dd 또는 yyyy-mm-ddThh:mm:ss.msZ 날짜 형식을 사용합니다(예: 2019-04-01 또는 2019-04-01T13:25:58.515Z제공되지 않은 경우, dateTo.에서 7일 뒤로 계산합니다).
dateTo(선택 사항) Yyyy-mm-dd 또는 yyyy-mm-ddThh:mm:ss.msZ 형식을 사용합니다(예: 2019-04-01 또는 2019-04-01 T13:26:05.598Z제공되지 않은 경우 dateFrom부터 7일로 계산됨). dateFrom도 제공되지 않았다면 Today로 설정합니다.
channelType(선택 사항) 대화 기록이 필요한 채널의 이름으로, 기본값은 'rtm'입니다. 허용되는 채널 유형은 "skypeforbusiness", "msteams", "twitter", "spark", "RTM", "Facebook", "Slack", "Skype", "Kore", "email", "SMS", "wfacebook", "ringcentral", "jabber", "Yammer", "Alexa", "twiliovoice", "telegram", "IVR", "ivrVoice", "line", "liveperson", "googleactions", "hangoutchat", "mattermost", "RCS"입니다. 참고 사항: 다중 Webhook 채널 설정의 경우 "ivr"이 첫 번째 Webhook 인스턴스에 대한 대화를 제공합니다. 다른 인스턴스와 관련된 경우, ivrInstID를 지정하면, 이를 다음 형식의 Webhook URL에서 가져올 수 있습니다. {{host_url}}/chatbot/hooks/{{BotId}}/hookInstance/{{ivrInstID}})
msgId(선택 사항) 알고 있는 경우 특정 메시지 ID입니다. 이렇게 하면 요청한 방향에 따라 해당 메시지부터 레코드를 앞으로 또는 뒤로 가져옵니다(아래 참조). 특정 대화만 필요한 경우 제한을 1로 설정합니다
direction(msgId가 지정된 경우 선택 사항)
  • <0 역방향
  • =0 양방향
  • >0 정방향

기본 방향은 정방향입니다.

sessionID(선택 사항) 알려진 경우 특정 세션 ID. 세션 ID를 얻으려면 여기를 참조하세요
tags(선택 사항) 대화를 필터링하는 메타 태그입니다.

참고 사항: dateTodateFrom 사이의 기간은 7일 미만이어야 하며, 그렇지 않으면 오류가 발생합니다.

권한 부여

다음 구문을 포함한 헤더에 JWT를 포함한 API를 호출합니다. auth: {{JWT}}

콘텐츠 유형 응답

application/JSON

샘플 요청

curl -X GET \
'https://bots.kore.ai/api/public/bot/{{BotId}}/getMessages?userId=u-XXX-XXX&
channelType=facebook&dateFrom=2019-04-01&dateTo=2019-04-05' \ 
-H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}'

POST 호출에 대한 샘플 요청

curl -X POST \
  https://bots.kore.ai/api/public/getMessages \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -d '{
        userId           : u-xxxx-xxxxx-xxxx
	skip             : 0,                           
	limit            : 100,                       
	dateFrom         : “2019-04-01”  (or)  “2019-04-01T13:25:58.515Z”,
	dateTo           : “2019-04-01”  (or)  “2019-04-01T13:25:58.515Z”,
	channelType      : “rcs”,
	sessionId        : [“5eadxxxxxxxxxxxxx”,”5ebxxxxxxxxxxxxxxx”],
	tags	         : {
		          and   : [
			            {
			              “name”  : ”tagname”,
			              “values”  : [“tagvalue1”,”tagvalue2”],
                                      “type”    : “tagtype” // user/message/session	
                                     },
                                   {
                                    “name”  : ”tagname”,
    			            “values”  : [“tagvalue1”,”tagvalue2”],
                                    “type”    : “tagtype”  // user/message/session	
                                   }
                                  ]	
                       }
           }

샘플 응답

{
    "total": 1,
    "moreAvailable": false,
    "messages": [
        {
            "_id": "ms-e172XXXXXX9a492cd2",
            "type": "outgoing",
            "status": "pending",
            "lmodifiedOn": "2019-04-01T13:25:58.512Z",
            "createdBy": "u-dfb0a15XXXXXXXXX6afa4c74d",
            "channels": [
                {
                    "type": "rcs"
                }
            ],
            "components": [
                {
                    "_id": "cp-4fbXXXXXXXXXX6ebdd586531",
                    "cT": "text",
                    "data": {
                        "text": "Thanks! I now have access to your Kore Assistant account. Don’t worry, I never access your account without you asking me to do something for you."
                    },
                    "thumbnails": []
                }
            ],
            "botId": "st-fe7XXXXXX6e115e94c",
            "orgId": "o-5a64XXXXXXXXXa58cd43460c3",
            "accountId": "5c9c95bXXXXX23c523dbc",
            "isBB": 1,
            "ms": 1,
            "chnl": "rcs",
            "createdOn": "2019-04-01T13:25:58.515Z",
            "timestampValue": 1554125158515,
            "__v": 0,
            "resourceid": "messagestore",
            "tags": {
                "messageTags": [],
                "userTags": [
                    {
                        "value": "+919346804623",
                        "name": "RCSID"
                    }
                ],
                "sessionTags": []
            }        }
    ]
}

POST 호출의 샘플 응답:

{
  "total": 1,
  "moreAvailable": false,
  "messages"  : [
                {
                  "_id": "ms-xxxxxxxxxxxxxxxxxxxx",
                  "type": "incoming",
                  "status": "sent to cs",
                  "createdBy":"u-xxxxxxxxxxxxxxxxxxx",
                  "lmodifiedBy": u-xxxxxxxxxxxxxxxxxxx",
                  "lmodifiedOn": "2019-04-10T10:21:45.103Z",
                  "channels": [
                     {
                      "type": "rtm"
                        }
                     ],
                  "botId":"st-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                  "orgId": “o-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                  "accountId": "5xxxxxxxxxxxxxxxxxxxxxxxx",
                  "isBB": 0,
                  "ms": 1,
                  "channel": "rtm",
                  "components": [
                    {
                      "_id":"cp-xxxxxxxxxxx",
                      "cT": "text",
                      "data": {
                          "text": "23"
                           },
                      "thumbnails": []
                      }
                    ],
                    "createdOn": "2019-04-10T10:21:45.106Z",
                    "timestampValue": 1554891705106,
                    "__v": 0,
                    "sessionId": "5cadbefc6a81a71559f6bece"
               }
             ]
 }

대화 기록 API

봇과 사용자 간의 대화 메시지를 시간 역순으로 가져옵니다. 이 API는 페이지 매김 기능을 지원합니다. 오프셋/건너뛰기를 제공하고 한 번에 특정 메시지 수를 제한할 수 있습니다. 이 버전은 조만간 사용되지 않을 이전 API의 새로운 버전입니다. 이 수정된 API는 이전 버전에서의 BotKit 또는 상담사 전환 활성화의 한계를 해결합니다.

이 API를 사용하려면 앱은 채팅 기록의 봇 빌더 API 범위가 필요합니다. 또는 봇 분석 아래 채팅 기록의 관리자 API 범위가 필요합니다.

GEThttps://{{host}}/api/public/bot/{{BotID}}/getMessages?userId={{userID}}&skip=10&limit=10

POST API 호출은 검색된 대화 기록의 Session-Id 및 MetaTags를 포함하는 데 사용할 수도 있습니다.

POST
https://{{host}}/api/public/bot/{{BotID}}/getMessageshttps://{{host}}/api/public/getMessages 봇 관리자 콘솔의 경우

매개 변수

매개 변수 설명
BotID(선택 사항) 봇 ID입니다. 봇의 일반 설정 페이지에서 액세스할 수 있습니다.
userId (POST 호출의 GET 호출에 필수) 액세스할 대화 기록을 가진 사용자의 ID입니다. 사용자 이메일 ID 또는 엔터프라이즈에서 할당한 고유 ID가 될 수 있습니다.
skip/offset (선택 사항) 건너뛸 메시지 수입니다.
limit(선택 사항) 각 페이지에 표시할 메시지 수입니다.
forward(선택 사항)

부울 값을 true/false로 사용합니다. 검색할 메시지의 방향을 지정합니다.

  • 값이 true이면 대화 기록은 오래된 항목부터 최신 항목까지 순서대로 검색됩니다.
  • 값이 false이면 대화 기록이 가장 최근의 메시지부터 가장 오래된 메시지까지, 즉, 역순으로 검색됩니다
dateFrom(선택 사항) Yyyy-mm-dd 또는 yyyy-mm-ddThh:mm:ss.msZ 날짜 형식을 사용합니다(예: 2019-04-01 또는 2019-04-01T13:25:58.515Z제공되지 않은 경우, dateTo.에서 7일 뒤로 계산합니다).
dateTo(선택 사항) Yyyy-mm-dd 또는 yyyy-mm-ddThh:mm:ss.msZ 형식을 사용합니다(예: 2019-04-01 또는 2019-04-01 T13:26:05.598Z제공되지 않은 경우 dateFrom부터 7일로 계산됨). dateFrom도 제공되지 않았다면 Today로 설정합니다.
channelType(선택 사항) 대화 기록이 필요한 채널의 이름으로, 기본값은 'rtm'입니다. 허용되는 채널 유형은 "skypeforbusiness", "msteams", "twitter", "spark", "RTM", "Facebook", "Slack", "Skype", "Kore", "email", "SMS", "wfacebook", "ringcentral", "jabber", "Yammer", "Alexa", "twiliovoice", "telegram", "IVR", "ivrVoice", "line", "liveperson", "googleactions", "hangoutchat", "mattermost", "RCS"입니다. 참고 사항: 다중 Webhook 채널 설정의 경우 "ivr"이 첫 번째 Webhook 인스턴스에 대한 대화를 제공합니다. 다른 인스턴스와 관련된 경우, ivrInstID를 지정하면, 이를 다음 형식의 Webhook URL에서 가져올 수 있습니다. {{host_url}}/chatbot/hooks/{{BotId}}/hookInstance/{{ivrInstID}})
msgId(선택 사항) 알고 있는 경우 특정 메시지 ID입니다. 이렇게 하면 요청한 방향에 따라 해당 메시지부터 레코드를 앞으로 또는 뒤로 가져옵니다(아래 참조). 특정 대화만 필요한 경우 제한을 1로 설정합니다
direction(msgId가 지정된 경우 선택 사항)
  • <0 역방향
  • =0 양방향
  • >0 정방향

기본 방향은 정방향입니다.

sessionID(선택 사항) 알려진 경우 특정 세션 ID. 세션 ID를 얻으려면 여기를 참조하세요
tags(선택 사항) 대화를 필터링하는 메타 태그입니다.

참고 사항: dateTodateFrom 사이의 기간은 7일 미만이어야 하며, 그렇지 않으면 오류가 발생합니다.

권한 부여

다음 구문을 포함한 헤더에 JWT를 포함한 API를 호출합니다. auth: {{JWT}}

콘텐츠 유형 응답

application/JSON

샘플 요청

curl -X GET \
'https://bots.kore.ai/api/public/bot/{{BotId}}/getMessages?userId=u-XXX-XXX&
channelType=facebook&dateFrom=2019-04-01&dateTo=2019-04-05' \ 
-H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}'

POST 호출에 대한 샘플 요청

curl -X POST \
  https://bots.kore.ai/api/public/getMessages \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -d '{
        userId           : u-xxxx-xxxxx-xxxx
	skip             : 0,                           
	limit            : 100,                       
	dateFrom         : “2019-04-01”  (or)  “2019-04-01T13:25:58.515Z”,
	dateTo           : “2019-04-01”  (or)  “2019-04-01T13:25:58.515Z”,
	channelType      : “rcs”,
	sessionId        : [“5eadxxxxxxxxxxxxx”,”5ebxxxxxxxxxxxxxxx”],
	tags	         : {
		          and   : [
			            {
			              “name”  : ”tagname”,
			              “values”  : [“tagvalue1”,”tagvalue2”],
                                      “type”    : “tagtype” // user/message/session	
                                     },
                                   {
                                    “name”  : ”tagname”,
    			            “values”  : [“tagvalue1”,”tagvalue2”],
                                    “type”    : “tagtype”  // user/message/session	
                                   }
                                  ]	
                       }
           }

샘플 응답

{
    "total": 1,
    "moreAvailable": false,
    "messages": [
        {
            "_id": "ms-e172XXXXXX9a492cd2",
            "type": "outgoing",
            "status": "pending",
            "lmodifiedOn": "2019-04-01T13:25:58.512Z",
            "createdBy": "u-dfb0a15XXXXXXXXX6afa4c74d",
            "channels": [
                {
                    "type": "rcs"
                }
            ],
            "components": [
                {
                    "_id": "cp-4fbXXXXXXXXXX6ebdd586531",
                    "cT": "text",
                    "data": {
                        "text": "Thanks! I now have access to your Kore Assistant account. Don’t worry, I never access your account without you asking me to do something for you."
                    },
                    "thumbnails": []
                }
            ],
            "botId": "st-fe7XXXXXX6e115e94c",
            "orgId": "o-5a64XXXXXXXXXa58cd43460c3",
            "accountId": "5c9c95bXXXXX23c523dbc",
            "isBB": 1,
            "ms": 1,
            "chnl": "rcs",
            "createdOn": "2019-04-01T13:25:58.515Z",
            "timestampValue": 1554125158515,
            "__v": 0,
            "resourceid": "messagestore",
            "tags": {
                "messageTags": [],
                "userTags": [
                    {
                        "value": "+919346804623",
                        "name": "RCSID"
                    }
                ],
                "sessionTags": []
            }        }
    ]
}

POST 호출의 샘플 응답:

{
  "total": 1,
  "moreAvailable": false,
  "messages"  : [
                {
                  "_id": "ms-xxxxxxxxxxxxxxxxxxxx",
                  "type": "incoming",
                  "status": "sent to cs",
                  "createdBy":"u-xxxxxxxxxxxxxxxxxxx",
                  "lmodifiedBy": u-xxxxxxxxxxxxxxxxxxx",
                  "lmodifiedOn": "2019-04-10T10:21:45.103Z",
                  "channels": [
                     {
                      "type": "rtm"
                        }
                     ],
                  "botId":"st-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                  "orgId": “o-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                  "accountId": "5xxxxxxxxxxxxxxxxxxxxxxxx",
                  "isBB": 0,
                  "ms": 1,
                  "channel": "rtm",
                  "components": [
                    {
                      "_id":"cp-xxxxxxxxxxx",
                      "cT": "text",
                      "data": {
                          "text": "23"
                           },
                      "thumbnails": []
                      }
                    ],
                    "createdOn": "2019-04-10T10:21:45.106Z",
                    "timestampValue": 1554891705106,
                    "__v": 0,
                    "sessionId": "5cadbefc6a81a71559f6bece"
               }
             ]
 }
메뉴