Ticket
Conversation
Intent
AiAgent
- GETList of all available AI agents as an array
- GETList of all available AI agents as an tree based on associated tag
- GETGet list of available enneo default AI Agents
- POSTLoad enneo default AI Agents
- POSTCreate a new aiAgent
- GETGet an AI Agent by id
- DELDelete an existing AI Agent
- PATCHUpdate an existing AI Agent
- GETGet similar tickets for an AI Agent
- POSTPreview an AI Agent
- POSTGet the outcome of an AI Agent
AI Quality Check
- GETGet all test runs with pagination
- POSTSchedule a new AI quality check
- GETGet a specific test run by ID
- DELDelete a specific test run by ID
- PATCHStop a specific test run by ID
- PATCHUpdate the expected result of a test ticket
- PATCHAccept the expected result of a test ticket
- POSTAccept ALL the expected results of for a test run
- GETGet all AI agents for which test runs can be triggereddeprecated
- GETGet all AI agents for which test runs can be triggered
- GETGet test cases for a specific AI agent
- POSTAdd test cases for an AI agent
- DELDelete a test case by ID
- PATCHUpdate a test case by ID
Template
Profile
- GETSearch profiles
- PATCHUpdate multiple profiles at once
- GETGet currently logged in user's profile
- POSTCreate a new user
- GETPing endpoint to track user activity
- GETGet specific profile
- DELDelete specific profile
- PATCHUpdate specific profile
- GETExplain routing priorities for a user
- GETGet available options for analytics roles
- PATCHUpdate profile routing status
Team
Settings
- GETGet settings of a client
- POSTUpdate multiple settings at once
- GETGet settings of a client and return the results in a compact form
- GETGet settings of a client in a grouped way for a category
- PUTUpdate setting
- GETSearch settings
- GETGet Subchannels
- POSTAdd a new Subchannel
- DELDelete a Subchannel
- GETGet User Defined Functions
- POSTAdd a new User Defined Function
- DELDelete a User Defined Function
- GETRedirect to Microsoft authorization page
- GETCallback for Microsoft authorization
Tag
Customer
Wiki knowledge source
Wiki knowledge source structure
Export
Report
General
Telephony
Debugging for AI Microservice Cortex
List of all available intents and categories
curl --request GET \
--url https://demo.enneo.ai/api/mind/intent/list \
--header 'Authorization: Bearer <token>'{
"intentCandidates": {
"id": 123,
"name": "Complaint",
"fullName": "Second Level: Complaint",
"parent": 6,
"reference": "ticket",
"type": "skill",
"visibility": "public",
"color": "grey",
"properties": [],
"complexity": "moderate",
"sla": 8,
"priority": "do-not-change",
"channels": [
"email",
"chat"
],
"subchannels": [
2,
4
],
"detectionDetails": {},
"assignment": [
"assignBySubchannel",
"assignByCustomLogic"
],
"testCase": {},
"modifiedBy": "John Doe",
"modifiedAt": "2024-08-29 14:38:12",
"intentCandidates": [
[
{
"code": "process_meter_reading",
"name": "Process meter reading",
"categoryName": "Meter reading",
"confidence": 0.91,
"tags": [
"prePopulated",
"writesToErp"
],
"message": null,
"order": 1
}
]
],
"children": [
{
"id": 123,
"name": "Complaint",
"fullName": "Second Level: Complaint",
"parent": 6,
"reference": "ticket",
"type": "skill",
"visibility": "public",
"color": "grey",
"properties": [],
"complexity": "moderate",
"sla": 8,
"priority": "do-not-change",
"channels": [
"email",
"chat"
],
"subchannels": [
2,
4
],
"detectionDetails": {},
"assignment": [
"assignBySubchannel",
"assignByCustomLogic"
],
"testCase": {},
"modifiedBy": "John Doe",
"modifiedAt": "2024-08-29 14:38:12",
"intentCandidates": [
[
{
"code": "process_meter_reading",
"name": "Process meter reading",
"categoryName": "Meter reading",
"confidence": 0.91,
"tags": [
"prePopulated",
"writesToErp"
],
"message": null,
"order": 1
}
]
]
}
]
}
}Authorizations
JWT-based authentication
Query Parameters
If provided, include specific recommendations based on the provided ticket id
Search query
Includes also top intents as a root items. Top intents are suggested intents based on what the AI thinks fits to the ticket
Includes any intents that are not assigned to a skill tag. Useful when a supervisor edits intents, and we don't have an agent working on the ticket
If yes, then tags with no intents assigned will be excluded from the result tree
Response
Successful operation
Tag object with intent candidates inside Tag object
Anzeigen untergeordnete attribute
Anzeigen untergeordnete attribute
Internal id, e.g. 123
123
e.g. "Complaint"
"Complaint"
The full name when not shown in a tree
"Second Level: Complaint"
The id of the parent tag. null if on root level. Can be created to create the tree structure of tags
6
To what this tag can be assigned to
ticket, contract, customer "ticket"
Type of the tag
skill, product, brand, customerProperty, contractProperty, other "skill"
Visibility of the tag
public, private, disabled "public"
Color of the tag. Default is grey
grey, green, red, blue, yellow, purple, orange, teal "grey"
An array of strings that specify special properties. Currently only ['defaultSkill'], if this tag should be assigned if no skill was found
defaultSkill []The complexity of the tag
"moderate"
SLA in business hours. So if we have business hours from 9-17h, an 8 hour SLA means ticket has to be solved within one day. NULL means no SLA is assigned.
8
If set to anything other than do-not-change, then the ticket priority will be set to this value if the tag was assigned (either manually or via AI)
do-not-change, low, medium, high "do-not-change"
Channels for which this tag can be detected. If empty or null, then this tag can be assigned to all channels.
["email", "chat"]Subchannels (=Mailboxes/Chat channels) for which this tag can be detected. If empty or null, then this tag can be assigned to all subchannels.
[2, 4]Details how the AI agent is detected
Specifies how this tag is being assigned. The details in the assignment are specified in the settings page of the tag. So for example 'assignBySubchannel', 'assignByCustomLogic' means this tag is auto-assigned for certain subchannels, and using a custom logic defined in an executor.
assignByChannel, assignBySubchannel, assignByTicketProperty, assignByContractProperty, assignByCustomerProperty, assignByCustomLogic, assignByAI ["assignBySubchannel", "assignByCustomLogic"]Test case for the tag
The user that last modified the tag
"John Doe"
The date and time when the tag was last modified
"2024-08-29 14:38:12"
Anzeigen untergeordnete attribute
Anzeigen untergeordnete attribute
Tag id that belongs to the intent
1
Intent model code that resolves a specific issue. Currently supported is process_meter_reading, process_bank_data and process_installment_change
Name of intent as configured by client
Confidence how certain the AI is that this is correct. 0.7 means for example 70% certain. Defaults to 100% when verified by human.
Channel of ticket
email, portal, phone, letter, system, chat, walkIn Defines if the user is needed for executing intent
Anzeigen untergeordnete attribute
Anzeigen untergeordnete attribute
Internal id, e.g. 123 Internal id, e.g. 123
123
e.g. "Complaint" e.g. "Complaint"
"Complaint"
The full name when not shown in a tree The full name when not shown in a tree
"Second Level: Complaint"
The id of the parent tag. null if on root level. Can be created to create the tree structure of tags The id of the parent tag. null if on root level. Can be created to create the tree structure of tags
6
To what this tag can be assigned to To what this tag can be assigned to
ticket, contract, customer "ticket"
Type of the tag Type of the tag
skill, product, brand, customerProperty, contractProperty, other "skill"
Visibility of the tag Visibility of the tag
public, private, disabled "public"
Color of the tag. Default is grey Color of the tag. Default is grey
grey, green, red, blue, yellow, purple, orange, teal "grey"
An array of strings that specify special properties. Currently only ['defaultSkill'], if this tag should be assigned if no skill was found An array of strings that specify special properties. Currently only ['defaultSkill'], if this tag should be assigned if no skill was found
defaultSkill []The complexity of the tag The complexity of the tag
"moderate"
SLA in business hours. So if we have business hours from 9-17h, an 8 hour SLA means ticket has to be solved within one day. NULL means no SLA is assigned. SLA in business hours. So if we have business hours from 9-17h, an 8 hour SLA means ticket has to be solved within one day. NULL means no SLA is assigned.
8
If set to anything other than do-not-change, then the ticket priority will be set to this value if the tag was assigned (either manually or via AI) If set to anything other than do-not-change, then the ticket priority will be set to this value if the tag was assigned (either manually or via AI)
do-not-change, low, medium, high "do-not-change"
Channels for which this tag can be detected. If empty or null, then this tag can be assigned to all channels. Channels for which this tag can be detected. If empty or null, then this tag can be assigned to all channels.
["email", "chat"]Subchannels (=Mailboxes/Chat channels) for which this tag can be detected. If empty or null, then this tag can be assigned to all subchannels. Subchannels (=Mailboxes/Chat channels) for which this tag can be detected. If empty or null, then this tag can be assigned to all subchannels.
[2, 4]Details how the AI agent is detected Details how the AI agent is detected
Specifies how this tag is being assigned. The details in the assignment are specified in the settings page of the tag. So for example 'assignBySubchannel', 'assignByCustomLogic' means this tag is auto-assigned for certain subchannels, and using a custom logic defined in an executor. Specifies how this tag is being assigned. The details in the assignment are specified in the settings page of the tag. So for example 'assignBySubchannel', 'assignByCustomLogic' means this tag is auto-assigned for certain subchannels, and using a custom logic defined in an executor.
assignByChannel, assignBySubchannel, assignByTicketProperty, assignByContractProperty, assignByCustomerProperty, assignByCustomLogic, assignByAI ["assignBySubchannel", "assignByCustomLogic"]Test case for the tag Test case for the tag
The user that last modified the tag The user that last modified the tag
"John Doe"
The date and time when the tag was last modified The date and time when the tag was last modified
"2024-08-29 14:38:12"
Anzeigen untergeordnete attribute
Anzeigen untergeordnete attribute
Tag id that belongs to the intent Tag id that belongs to the intent
1
Intent model code that resolves a specific issue. Currently supported is process_meter_reading, process_bank_data and process_installment_change Intent model code that resolves a specific issue. Currently supported is process_meter_reading, process_bank_data and process_installment_change
Name of intent as configured by client Name of intent as configured by client
Confidence how certain the AI is that this is correct. 0.7 means for example 70% certain. Defaults to 100% when verified by human. Confidence how certain the AI is that this is correct. 0.7 means for example 70% certain. Defaults to 100% when verified by human.
Channel of ticket Channel of ticket
email, portal, phone, letter, system, chat, walkIn Defines if the user is needed for executing intent Defines if the user is needed for executing intent
curl --request GET \
--url https://demo.enneo.ai/api/mind/intent/list \
--header 'Authorization: Bearer <token>'{
"intentCandidates": {
"id": 123,
"name": "Complaint",
"fullName": "Second Level: Complaint",
"parent": 6,
"reference": "ticket",
"type": "skill",
"visibility": "public",
"color": "grey",
"properties": [],
"complexity": "moderate",
"sla": 8,
"priority": "do-not-change",
"channels": [
"email",
"chat"
],
"subchannels": [
2,
4
],
"detectionDetails": {},
"assignment": [
"assignBySubchannel",
"assignByCustomLogic"
],
"testCase": {},
"modifiedBy": "John Doe",
"modifiedAt": "2024-08-29 14:38:12",
"intentCandidates": [
[
{
"code": "process_meter_reading",
"name": "Process meter reading",
"categoryName": "Meter reading",
"confidence": 0.91,
"tags": [
"prePopulated",
"writesToErp"
],
"message": null,
"order": 1
}
]
],
"children": [
{
"id": 123,
"name": "Complaint",
"fullName": "Second Level: Complaint",
"parent": 6,
"reference": "ticket",
"type": "skill",
"visibility": "public",
"color": "grey",
"properties": [],
"complexity": "moderate",
"sla": 8,
"priority": "do-not-change",
"channels": [
"email",
"chat"
],
"subchannels": [
2,
4
],
"detectionDetails": {},
"assignment": [
"assignBySubchannel",
"assignByCustomLogic"
],
"testCase": {},
"modifiedBy": "John Doe",
"modifiedAt": "2024-08-29 14:38:12",
"intentCandidates": [
[
{
"code": "process_meter_reading",
"name": "Process meter reading",
"categoryName": "Meter reading",
"confidence": 0.91,
"tags": [
"prePopulated",
"writesToErp"
],
"message": null,
"order": 1
}
]
]
}
]
}
}