はじめに
対話型AIプラットフォーム
チャットボットの概要
自然言語処理(NLP)
ボットの概念と用語
クイックスタートガイド
プラットフォームへのアクセス
ボットビルダーの操作
リリースノート
最新バージョン(英語)
以前のバージョン(英語)
コンセプト
設計
ストーリーボード
ダイアログタスク
ダイアログタスクとは
ダイアログビルダー
ノードタイプ
インテントノード
ダイアログノード
エンティティノード
フォームノード
確認ノード
ロジックノード
ボットアクションノード
サービスノード
Webhookノード
スクリプトノード
グループノード
エージェント転送ノード
ユーザープロンプト
音声通話プロパティ
イベント ハンドラー
ナレッジグラフ
ナレッジグラフの抽出
ナレッジグラフの構築
ボットにナレッジグラフを追加
グラフの作成
ナレッジグラフの構築
既存のソースからFAQを構築
通知タスク
スモールトーク
デジタルスキル
デジタルフォーム
デジタルビュー
デジタルビューとは
パネル
ウィジェット
トレーニング
トレーニングとは
機械学習
機械学習とは
モデル検証
ファンダメンタルミーニング
ナレッジグラフ
示唆
ランキングおよび解決
NLPの詳細設定
NLPのガイドライン
インテリジェンス
インテリジェンスとは
コンテキスト
コンテキストインテント
割り込み
複数インテントの検出
エンティティの変更
デフォルトの会話
センチメント管理
トーン分析
テストとデバッグ
ボットと会話
発話テスト
バッチテスト
会話テスト
デプロイ
チャネル
公開
LLM and Generative AI
Introduction
LLM Integration
Kore.ai XO GPT Module
Prompts & Requests Library
Co-Pilot Features
Dynamic Conversations Features
分析
ボットの分析
NLPメトリクス
会話フロー
Usage Metrics
封じ込め測定
カスタムダッシュボード
カスタムダッシュボードとは
メタタグ
カスタムダッシュボードとウィジェット
ユニバーサルボット
ユニバーサルボットとは
ユニバーサルボットの定義
ユニバーサルボットの作成
ユニバーサルボットのトレーニング
ユニバーサルボットのカスタマイズ
他言語の有効化
ストア
プラントと使用
Overview
Usage Plans
Support Plans
Invoices
管理
ボット認証
複数言語対応ボット
個人を特定できる情報の編集
ボット変数の使用
IVRのシステム連携
一般設定
ボット管理
ハウツー
Integrations
Actions
Actions Overview
Asana
Configure
Templates
Azure OpenAI
Configure
Templates
BambooHR
Configure
Templates
Bitly
Configure
Templates
Confluence
Configure
Templates
DHL
Configure
Templates
Freshdesk
Configure
Templates
Freshservice
Configure
Templates
Google Maps
Configure
Templates
Here
Configure
Templates
HubSpot
Configure
Templates
JIRA
Configure
Templates
Microsoft Graph
Configure
Templates
Open AI
Configure
Templates
Salesforce
Configure
Templates
ServiceNow
Configure
Templates
Stripe
Configure
Templates
Shopify
Configure
Templates
Twilio
Configure
Templates
Zendesk
Configure
Templates
Agents
Agent Transfer Overview
Custom (BotKit)
Drift
Genesys
Intercom
NiceInContact
NiceInContact(User Hub)
Salesforce
ServiceNow
Configure Tokyo and Lower versions
Configure Utah and Higher versions
Unblu
External NLU Adapters
Overview
Dialogflow Engine
Test and Debug
会話スキルの設計
バンキングボットを作成
バンキングボット – 資金の振り替え
バンキングボット – 残高を更新
ナレッジグラフを構築
スマートアラートの予約方法
デジタルスキルの設計
デジタルフォームの設定方法
デジタルビューの設定方法
データテーブルのデータの追加方法
データテーブルのデータの更新方法
Add Data from Digital Forms
ボットのトレーニング
示唆の使用方法
インテントとエンティティのパターンの使用方法
コンテキスト切り替えの管理方法
ボットのデプロイ
エージェント転送の設定方法
ボット関数の使用方法
コンテンツ変数の使用方法
グローバル変数の使用方法
ボットの分析
カスタムダッシュボードの作成方法
カスタムタグを使ってフィルタリング
Data
Overview
Data Table
Table Views
App Definitions
Data as Service
Build a Travel Planning Assistant
Travel Assistant Overview
Create a Travel Virtual Assistant
Design Conversation Skills
Create an ‘Update Booking’ Task
Create a Change Flight Task
Build a Knowledge Graph
Schedule a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Train the Assistant
Use Traits
Use Patterns
Manage Context Switching
Deploy the Assistant
Use Bot Functions
Use Content Variables
Use Global Variables
Use Web SDK
Build a Banking Assistant
Migrate External Bots
Google Dialogflow Bot
APIs & SDKs
API Reference
API Introduction
Rate Limits
API List
koreUtil Libraries
SDK Reference
SDK Introduction
Web SDK
How the Web SDK Works
SDK Security
SDK Registration
Web Socket Connect and RTM
Tutorials
Widget SDK Tutorial
Web SDK Tutorial
BotKit SDK
BotKit SDK Deployment Guide
Installing the BotKit SDK
Using the BotKit SDK
SDK Events
SDK Functions
Tutorials
BotKit - Blue Prism
BotKit - Flight Search Sample VA
BotKit - Agent Transfer
  1. ホーム
  2. Docs
  3. Virtual Assistants
  4. API Guide
  5. APIs List

APIs List

Following is the list of APIs available from the Kore.ai XO Platform. For details on the API functioning and usage instructions refer here.

Based on the functionality addressed, the APIs can be categorized as:

  1. APIs related to the Bot Definition functionality, more
  2. APIs related to NLP training, more
  3. APIs aiding in Analyzing the performance and behavior, more
  4. APIs related to the Admin Console functionality, more
  5. APIs related to the data access from Data Tables, more

Note: All the APIs have rate limits to manage the usage. If the rate limit is exceeded, an API call fails with the following error message – “Rate limit for this API has been reached. Please try again after some time.

Bot Definition APIs

API DESCRIPTION ASSOCIATED APP SCOPE
XO PLATFORM ADMIN CONSOLE
Upload File To upload the botdefinition, botconfig, and botfunction file (if any) as well as the bot icon to the local server and get the file ID to be used in the Import Bot API.

To upload utterances in ML Utterances Import API, bot roles, admin roles for Import Roles API, Import Batch Test Suite details and Extraction from file or URL to extract FAQs.

NA Bot Definition > Bot Import
Import Bot as a New Bot To create a new assistant in the account owner’s XO Platform using the File IDs generated when uploading the files. NA Bot Definition > Bot Import
Import Bot into an Existing Bot To import the bot definition file into an existing assistant for upgrading to a new version or restoring to an earlier version. NA Bot Definition > Bot Import
Bot Import Status To get the status of the bot import request. NA Bot Definition > Bot Import
Import Bot Functions To import bot functions from a specified file. NA Bot Definition > Bot Import
Install Sample Bot To install a sample assistant. NA Bot Definition > Bot Create
Bot Export To export a bot definition and all associated components. Bot Export Bot Definition > Bot Export
Bot Export – Status To get the status of the Bot Export request and also provides the download link of the export copy after the export is completed. Bot Export Bot Definition > Bot Export
Enable Channel To enable or update a channel for an assistant. NA Channel Management
Add and Enable a New Language To add and enable a new language for a virtual assistant. Languages Configuration. API Scopes > Language Settings
Enable an existing Language To enable an existing language for a virtual assistant. Languages Configuration. API Scopes > Language Settings
Disable an existing Language To disable an existing language for a virtual assistant that is currently enabled. Languages Configuration. API Scopes > Language Settings
Update a Language Configuration To update the configuration of an existing language for a virtual assistant. Languages Configuration. API Scopes > Language Settings
Proactive Notification To send proactive notifications to the configured channel. NA Channel Management > Proactive Messages
Proactive Notification Status To send proactive notifications to the configured channel. NA Channel Management > Proactive Messages
Publish Bot To initiate a bot publish request. NA Bot Publish > Publish
Bot Publish Status Gets the publish status of the ongoing assistant or the last completed status request of the assistant.  NA Bot Publish > Publish
Bot Variables Import To import global and content variables into the assistant. Import Variables NA
Batch Test Execution To invoke the execution of a Batch Test suite. Batch Tests Execution NA
Batch Test Execution Status To know the status of the execution against a unique Test Request Id. Batch Tests Execution NA
Get Batch Test Suites To get the list of Batch Test Suites available. Batch Tests Management Batch Tests Management
Export Batch Test Suite To export the test cases of a given Batch Test Suite. Batch Tests Management Batch Tests Management
Import Batch Test Suite To import a batch test suite. Batch Tests Management Batch Tests Management
Delete Batch Test Suite To delete a Batch Test Suite. Batch Tests Management Batch Tests Management
Delete Batch Test Suite Execution To delete a specific execution of a Batch Test Suite. Batch Tests Management Batch Tests Management
Create (Import) a Conversation Test Suite To create or import a Conversation Test Suite. Conversation Tests Management Conversation Tests Management
Conversation Test Suite Creation Status To get the creation status of a Conversation Test Suite. Conversation Tests Management Conversation Tests Management
Conversation Test Suite Execution To execute a Conversation Test Suite. Conversation Tests Execution Conversation Tests Execution
Conversation Test Suite Execution Status To get the execution status and summary of a Conversation Test Suite. Conversation Tests Execution Conversation Tests Execution
Delete Conversation Test Suite To delete a Conversation Test Suite. Conversation Tests Management Conversation Tests Management

NLP Training APIs

API DESCRIPTION ASSOCIATED APP SCOPE
XO PLATFORM ADMIN CONSOLE
ML Utterances Import To import ML Utterances into an assistant. Utterances Import Test > Utterances Import & Train
ML Utterances Import Status To get the status of the ML utterances import request made through Import ML Utterances API. Utterances Import Test > Utterances Import & Train
ML Utterance Train To initiate ML training of an assistant. Train ML Test > Train ML & Train
ML Utterance Train Status To get the status of the ML training. Train ML Test > Train ML & Train
ML Utterances Export To export the ML utterances of an assistant. Utterances Export Test > Utterances Export & Train
ML Utterances Export Status To get the download link of the ML Utterances export copy. Utterances Export Test > Utterances Export & Train
FAQ Training To initiate the training of the knowledge graph. Train Faq Test > Train FAQ & Train
FAQ Training Status To get the status of the FAQ training. Train Faq Test > Train FAQ & Train
Extraction from file or URL To extract FAQs using a file or URL. Manage Knowledge Graph Manage Knowledge Graph
Get Extractions History To get a list of KG Extractions history. Manage Knowledge Graph Manage Knowledge Graph
Get Extraction Question To get a list of KG Extraction Questions. Manage Knowledge Graph Manage Knowledge Graph
Get KnowledgeTasks To get a listing of knowledge Tasks along with the nodes. Manage Knowledge Graph Manage Knowledge Graph
Add Questions from Extraction To add specific questions from extraction to the Knowledge Graph. Manage Knowledge Graph Manage Knowledge Graph
Get FAQs To get a list of questions and nodes under the Knowledge task. Manage Knowledge Graph Manage Knowledge Graph
Update NLP Configurations To update the NLP thresholds and configurations. NLP Configurations Test > NLP Configurations & Train

Analytics APIs

API DESCRIPTION ASSOCIATED APP SCOPE
XO PLATFORM ADMIN CONSOLE
Find Intent To obtain the intent recognition result and the scoring from NLP and ML engines. Intent and Entity Detection Intent Identification > Intent and Entity Detection
Conversation History To fetch the conversational messages between the assistant and user in reverse chronological order. Chat History Bot Analytics > Chat History
Conversation Summary To summarizes the conversation between a user and an agent. Conversation Summary NA
Feedback Analytics To fetch the Feedback Survey Response Data and push it to the Feedback Analytics Dashboard. Feedback Survey Bot Analytics > Feedback Analytics
Debug Logs To get debug logs of a specific conversation. Debug Logs NA
Get ChangeLogs To get the list of changes made to the assistant definition for a given date period. Logs History Logs > Bot Audit Logs
Sessions History To retrieve the conversation sessions created. Bot Sessions Bot Analytics > Bot Sessions
Billing Sessions To retrieves the list of individual billing sessions created for a bot so that you can review them for correctness and reconciliation. Billing Sessions Bot Analytics > Billing Sessions
Billing Usage Summary

To get a summary of the billing usage specific to an account or bot for a given period.

Billing Sessions Bot Analytics > Billing Sessions
Get Dashboard Widget Data To get the data result of a widget from a specific Custom Dashboard added to an assistant. Custom Reports Custom Reports > Custom Reports
Get Analytics To extract the metrics data related to the intent detection and task performance using API Metrics NA
Task Execution-based Containment Report To extract task execution details (including success and failure status) across all the conversation sessions of the virtual assistant in the selected timeframe for Drop-off, Self-service, and Agent Hand-off containment types using API. Metrics NA
User Engagement Trend To provide the number of users who have interacted with the assistant in a given period across different time intervals. User Engagement Trend NA
Conversation Details and Summary To fetch the conversational details and summary between the bot and the user. Conversation History NA
LLM & Generative AI Usage To fetch the LLM & Generative AI usage logs. Gen AI and LLM Usage Logs API Scopes > Gen AI and LLM Usage Logs

Admin APIs

API DESCRIPTION ASSOCIATED BOT ADMIN APP SCOPE
Get Bots To retrieve the list of bots available in an account Profile Management > Role Management
Import Roles To import bot or admin roles into an account Profile Management > Role Management
Get Roles To retrieve the list of bot or admin roles available in an account. Profile Management > Role Management
Get User Roles Details To get full information on all users and their associated roles in the account Profile Management > Role Management
Get Groups To get the list of groups and group members available in the account Profile Management > Role Management
Export Roles To export bot or admin roles from an account Profile Management > Role Management
Assign BT Roles To assign a bot role to a set of users in a specific assistant Profile Management > Role Management
Assign Admin Roles To add or remove users or groups from admin roles Profile Management > Role Management
Update User Access To add or remove the ability to access XO Platform, create new assistants Profile Management > Role Management
Create Users To add users to an account User Management
Get Users Information To retrieve the user details User Management
Update User To update user details User Management
Remove Users from Account To remove users from an account User Management
Delete Customer Data To delete customer data Profile Management > Delete Users Data
Delete Customer Data Status API To get the status of the Customer Data Delete request Profile Management > Delete Users Data
LLM & Generative AI Usage To get admin console audit logs. Logs Admin > Admin Console Audit Logs

Data (Data Table) Access APIs

API DESCRIPTION ASSOCIATED APP SCOPE
Insert Data To insert data into Data Table Write access to the Data Table
Insert Bulk Data To insert bulk data into Data Table Write access to the Data Table
Update Data To update data into Data Table. Read and Write access to the Data Table
Delete Data To delete data from Data Table. Read and Delete access to the Data Table
Get Table Data To get data from Data Table. Read access to the Data Table
Get View Data To get data from Data View. Read access to the Table View

APIs List

Following is the list of APIs available from the Kore.ai XO Platform. For details on the API functioning and usage instructions refer here.

Based on the functionality addressed, the APIs can be categorized as:

  1. APIs related to the Bot Definition functionality, more
  2. APIs related to NLP training, more
  3. APIs aiding in Analyzing the performance and behavior, more
  4. APIs related to the Admin Console functionality, more
  5. APIs related to the data access from Data Tables, more

Note: All the APIs have rate limits to manage the usage. If the rate limit is exceeded, an API call fails with the following error message – “Rate limit for this API has been reached. Please try again after some time.

Bot Definition APIs

API DESCRIPTION ASSOCIATED APP SCOPE
XO PLATFORM ADMIN CONSOLE
Upload File To upload the botdefinition, botconfig, and botfunction file (if any) as well as the bot icon to the local server and get the file ID to be used in the Import Bot API.

To upload utterances in ML Utterances Import API, bot roles, admin roles for Import Roles API, Import Batch Test Suite details and Extraction from file or URL to extract FAQs.

NA Bot Definition > Bot Import
Import Bot as a New Bot To create a new assistant in the account owner’s XO Platform using the File IDs generated when uploading the files. NA Bot Definition > Bot Import
Import Bot into an Existing Bot To import the bot definition file into an existing assistant for upgrading to a new version or restoring to an earlier version. NA Bot Definition > Bot Import
Bot Import Status To get the status of the bot import request. NA Bot Definition > Bot Import
Import Bot Functions To import bot functions from a specified file. NA Bot Definition > Bot Import
Install Sample Bot To install a sample assistant. NA Bot Definition > Bot Create
Bot Export To export a bot definition and all associated components. Bot Export Bot Definition > Bot Export
Bot Export – Status To get the status of the Bot Export request and also provides the download link of the export copy after the export is completed. Bot Export Bot Definition > Bot Export
Enable Channel To enable or update a channel for an assistant. NA Channel Management
Add and Enable a New Language To add and enable a new language for a virtual assistant. Languages Configuration. API Scopes > Language Settings
Enable an existing Language To enable an existing language for a virtual assistant. Languages Configuration. API Scopes > Language Settings
Disable an existing Language To disable an existing language for a virtual assistant that is currently enabled. Languages Configuration. API Scopes > Language Settings
Update a Language Configuration To update the configuration of an existing language for a virtual assistant. Languages Configuration. API Scopes > Language Settings
Proactive Notification To send proactive notifications to the configured channel. NA Channel Management > Proactive Messages
Proactive Notification Status To send proactive notifications to the configured channel. NA Channel Management > Proactive Messages
Publish Bot To initiate a bot publish request. NA Bot Publish > Publish
Bot Publish Status Gets the publish status of the ongoing assistant or the last completed status request of the assistant.  NA Bot Publish > Publish
Bot Variables Import To import global and content variables into the assistant. Import Variables NA
Batch Test Execution To invoke the execution of a Batch Test suite. Batch Tests Execution NA
Batch Test Execution Status To know the status of the execution against a unique Test Request Id. Batch Tests Execution NA
Get Batch Test Suites To get the list of Batch Test Suites available. Batch Tests Management Batch Tests Management
Export Batch Test Suite To export the test cases of a given Batch Test Suite. Batch Tests Management Batch Tests Management
Import Batch Test Suite To import a batch test suite. Batch Tests Management Batch Tests Management
Delete Batch Test Suite To delete a Batch Test Suite. Batch Tests Management Batch Tests Management
Delete Batch Test Suite Execution To delete a specific execution of a Batch Test Suite. Batch Tests Management Batch Tests Management
Create (Import) a Conversation Test Suite To create or import a Conversation Test Suite. Conversation Tests Management Conversation Tests Management
Conversation Test Suite Creation Status To get the creation status of a Conversation Test Suite. Conversation Tests Management Conversation Tests Management
Conversation Test Suite Execution To execute a Conversation Test Suite. Conversation Tests Execution Conversation Tests Execution
Conversation Test Suite Execution Status To get the execution status and summary of a Conversation Test Suite. Conversation Tests Execution Conversation Tests Execution
Delete Conversation Test Suite To delete a Conversation Test Suite. Conversation Tests Management Conversation Tests Management

NLP Training APIs

API DESCRIPTION ASSOCIATED APP SCOPE
XO PLATFORM ADMIN CONSOLE
ML Utterances Import To import ML Utterances into an assistant. Utterances Import Test > Utterances Import & Train
ML Utterances Import Status To get the status of the ML utterances import request made through Import ML Utterances API. Utterances Import Test > Utterances Import & Train
ML Utterance Train To initiate ML training of an assistant. Train ML Test > Train ML & Train
ML Utterance Train Status To get the status of the ML training. Train ML Test > Train ML & Train
ML Utterances Export To export the ML utterances of an assistant. Utterances Export Test > Utterances Export & Train
ML Utterances Export Status To get the download link of the ML Utterances export copy. Utterances Export Test > Utterances Export & Train
FAQ Training To initiate the training of the knowledge graph. Train Faq Test > Train FAQ & Train
FAQ Training Status To get the status of the FAQ training. Train Faq Test > Train FAQ & Train
Extraction from file or URL To extract FAQs using a file or URL. Manage Knowledge Graph Manage Knowledge Graph
Get Extractions History To get a list of KG Extractions history. Manage Knowledge Graph Manage Knowledge Graph
Get Extraction Question To get a list of KG Extraction Questions. Manage Knowledge Graph Manage Knowledge Graph
Get KnowledgeTasks To get a listing of knowledge Tasks along with the nodes. Manage Knowledge Graph Manage Knowledge Graph
Add Questions from Extraction To add specific questions from extraction to the Knowledge Graph. Manage Knowledge Graph Manage Knowledge Graph
Get FAQs To get a list of questions and nodes under the Knowledge task. Manage Knowledge Graph Manage Knowledge Graph
Update NLP Configurations To update the NLP thresholds and configurations. NLP Configurations Test > NLP Configurations & Train

Analytics APIs

API DESCRIPTION ASSOCIATED APP SCOPE
XO PLATFORM ADMIN CONSOLE
Find Intent To obtain the intent recognition result and the scoring from NLP and ML engines. Intent and Entity Detection Intent Identification > Intent and Entity Detection
Conversation History To fetch the conversational messages between the assistant and user in reverse chronological order. Chat History Bot Analytics > Chat History
Conversation Summary To summarizes the conversation between a user and an agent. Conversation Summary NA
Feedback Analytics To fetch the Feedback Survey Response Data and push it to the Feedback Analytics Dashboard. Feedback Survey Bot Analytics > Feedback Analytics
Debug Logs To get debug logs of a specific conversation. Debug Logs NA
Get ChangeLogs To get the list of changes made to the assistant definition for a given date period. Logs History Logs > Bot Audit Logs
Sessions History To retrieve the conversation sessions created. Bot Sessions Bot Analytics > Bot Sessions
Billing Sessions To retrieves the list of individual billing sessions created for a bot so that you can review them for correctness and reconciliation. Billing Sessions Bot Analytics > Billing Sessions
Billing Usage Summary

To get a summary of the billing usage specific to an account or bot for a given period.

Billing Sessions Bot Analytics > Billing Sessions
Get Dashboard Widget Data To get the data result of a widget from a specific Custom Dashboard added to an assistant. Custom Reports Custom Reports > Custom Reports
Get Analytics To extract the metrics data related to the intent detection and task performance using API Metrics NA
Task Execution-based Containment Report To extract task execution details (including success and failure status) across all the conversation sessions of the virtual assistant in the selected timeframe for Drop-off, Self-service, and Agent Hand-off containment types using API. Metrics NA
User Engagement Trend To provide the number of users who have interacted with the assistant in a given period across different time intervals. User Engagement Trend NA
Conversation Details and Summary To fetch the conversational details and summary between the bot and the user. Conversation History NA
LLM & Generative AI Usage To fetch the LLM & Generative AI usage logs. Gen AI and LLM Usage Logs API Scopes > Gen AI and LLM Usage Logs

Admin APIs

API DESCRIPTION ASSOCIATED BOT ADMIN APP SCOPE
Get Bots To retrieve the list of bots available in an account Profile Management > Role Management
Import Roles To import bot or admin roles into an account Profile Management > Role Management
Get Roles To retrieve the list of bot or admin roles available in an account. Profile Management > Role Management
Get User Roles Details To get full information on all users and their associated roles in the account Profile Management > Role Management
Get Groups To get the list of groups and group members available in the account Profile Management > Role Management
Export Roles To export bot or admin roles from an account Profile Management > Role Management
Assign BT Roles To assign a bot role to a set of users in a specific assistant Profile Management > Role Management
Assign Admin Roles To add or remove users or groups from admin roles Profile Management > Role Management
Update User Access To add or remove the ability to access XO Platform, create new assistants Profile Management > Role Management
Create Users To add users to an account User Management
Get Users Information To retrieve the user details User Management
Update User To update user details User Management
Remove Users from Account To remove users from an account User Management
Delete Customer Data To delete customer data Profile Management > Delete Users Data
Delete Customer Data Status API To get the status of the Customer Data Delete request Profile Management > Delete Users Data
LLM & Generative AI Usage To get admin console audit logs. Logs Admin > Admin Console Audit Logs

Data (Data Table) Access APIs

API DESCRIPTION ASSOCIATED APP SCOPE
Insert Data To insert data into Data Table Write access to the Data Table
Insert Bulk Data To insert bulk data into Data Table Write access to the Data Table
Update Data To update data into Data Table. Read and Write access to the Data Table
Delete Data To delete data from Data Table. Read and Delete access to the Data Table
Get Table Data To get data from Data Table. Read access to the Data Table
Get View Data To get data from Data View. Read access to the Table View
メニュー