Answer API

Answers are what we return when the conversation API identifies what the user's request are, according to our dialog manager.

API SUBPATH: eva-answer

Pagination and Listing

Searches and paginates through expected answers -- those being of type 'TYPE_ANSWER' and 'WELCOME_MESSAGE'.

GET/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer

Path parameters

orgUUID*string

It is the organization where the answers are, it is used to connect to the correct database

envUUID*string

It is the environment where the answers are, it is used to connect to the correct database

botUUID*string

It is the bot where the answers are, it is used to filter answers

Query parameters

Response

Body

totalPagesinteger (int32)

totalElementsinteger (int64)

pageablePageableObject (object)

numberOfElementsinteger (int32)

sizeinteger (int32)

contentarray of AnswersDTO (object)

numberinteger (int32)

sortSortObject (object)

firstboolean

lastboolean

emptyboolean

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer?page=1&size=5', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "totalPages": 0,
  "totalElements": 0,
  "pageable": {
    "unpaged": false,
    "paged": false,
    "pageNumber": 0,
    "pageSize": 0,
    "offset": 0,
    "sort": {
      "unsorted": false,
      "sorted": false,
      "empty": false
    }
  },
  "numberOfElements": 0,
  "size": 0,
  "content": [
    {
      "answer": {
        "id": "text",
        "name": "text",
        "description": "text",
        "evaluable": 0,
        "transactional": 0,
        "isMasked": false,
        "updatedAt": "2024-12-21T11:36:03.972Z",
        "updatedBy": "text",
        "tags": [
          {
            "uuid": "text",
            "name": "text"
          }
        ],
        "webhook": "text",
        "type": "text",
        "answerTemplates": [
          {
            "id": "text",
            "content": {
              "description": "text",
              "type": "text",
              "buttons": [],
              "quickReply": [],
              "name": "text"
            },
            "type": "text",
            "channelTypeId": 0,
            "channelId": "text",
            "technicalText": "text",
            "translations": [
              {
                "answerTemplateUUID": "text",
                "locale": "text",
                "content": "text"
              }
            ]
          }
        ],
        "executionLimit": 0,
        "rephraseEnabled": false,
        "rephrasingTemperature": 0,
        "rephrasingMemory": 0,
        "rephrasingBlacklist": "text",
        "user": {
          "name": "text",
          "imageUrl": "text"
        }
      },
      "flows": [
        {
          "uuid": "text",
          "name": "text"
        }
      ]
    }
  ],
  "number": 0,
  "sort": {
    "unsorted": false,
    "sorted": false,
    "empty": false
  },
  "first": false,
  "last": false,
  "empty": false
}

Paginates through not expected answers -- those being of type 'FIRST_CELL' and 'TYPE_ANYTHING_ELSE'.

GET/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/not-expected

Path parameters

orgUUID*string

A valid uuid of an organization

envUUID*string

A valid uuid of an environment

botUUID*string

The UUID of the bot whose entities you are searching

Query parameters

Response

Body

totalPagesinteger (int32)

totalElementsinteger (int64)

pageablePageableObject (object)

numberOfElementsinteger (int32)

sizeinteger (int32)

contentarray of AnswersDTO (object)

numberinteger (int32)

sortSortObject (object)

firstboolean

lastboolean

emptyboolean

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/not-expected?page=1&size=5', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "totalPages": 0,
  "totalElements": 0,
  "pageable": {
    "unpaged": false,
    "paged": false,
    "pageNumber": 0,
    "pageSize": 0,
    "offset": 0,
    "sort": {
      "unsorted": false,
      "sorted": false,
      "empty": false
    }
  },
  "numberOfElements": 0,
  "size": 0,
  "content": [
    {
      "answer": {
        "id": "text",
        "name": "text",
        "description": "text",
        "evaluable": 0,
        "transactional": 0,
        "isMasked": false,
        "updatedAt": "2024-12-21T11:36:03.972Z",
        "updatedBy": "text",
        "tags": [
          {
            "uuid": "text",
            "name": "text"
          }
        ],
        "webhook": "text",
        "type": "text",
        "answerTemplates": [
          {
            "id": "text",
            "content": {
              "description": "text",
              "type": "text",
              "buttons": [],
              "quickReply": [],
              "name": "text"
            },
            "type": "text",
            "channelTypeId": 0,
            "channelId": "text",
            "technicalText": "text",
            "translations": [
              {
                "answerTemplateUUID": "text",
                "locale": "text",
                "content": "text"
              }
            ]
          }
        ],
        "executionLimit": 0,
        "rephraseEnabled": false,
        "rephrasingTemperature": 0,
        "rephrasingMemory": 0,
        "rephrasingBlacklist": "text",
        "user": {
          "name": "text",
          "imageUrl": "text"
        }
      },
      "flows": [
        {
          "uuid": "text",
          "name": "text"
        }
      ]
    }
  ],
  "number": 0,
  "sort": {
    "unsorted": false,
    "sorted": false,
    "empty": false
  },
  "first": false,
  "last": false,
  "empty": false
}

Searches (greedily) for any answer names that exists in a bot, matching types 'TYPE_ANSWER' and 'WELCOME_MESSAGE', matching the typed term, left-to-right, and returns a list of Strings, ordered alphabetically.

GET/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/quicksearch

Path parameters

orgUUID*string

A valid organization Uuid

envUUID*string

A valid environment Uuid

botUUID*string

A valid bot uuid to search

Query parameters

Response

Body

itemsstring

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/quicksearch?searchTerm=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  "text"
]

Searches (greedily) for any answer names that exists in a bot, matching types 'TYPE_ANYTHING_ELSE' and 'FIRST_CELL', matching the typed term, left-to-right, and returns a list of Strings, ordered alphabetically.

GET/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/not-expected/quicksearch

Path parameters

orgUUID*string

A valid organization Uuid

envUUID*string

A valid environment Uuid

botUUID*string

A valid bot uuid to search

Query parameters

Response

Body

itemsstring

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/not-expected/quicksearch?searchTerm=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  "text"
]

Searches through all answers recently used on a given bot to start a flow.

GET/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/list-on-flow

Path parameters

orgUUID*string

A valid uuid of an organization

envUUID*string

A valid uuid of an environment

botUUID*string

The UUID of the bot whose entities you are searching

Response

Body

idstring

The answer's String uuid.

namestring

The answer's name.

typestring

The answer's type.

executionLimitinteger (int64)

The number of times an answer can be executed.

answerTemplatesarray of AnswerTemplateResponseDTO (object)

A list of the answer's templates.

rephraseEnabledboolean

Wether the rephrasing feature is active in this answer.

tagsarray of TagOnFlowDTO (object)

A list of all tags associated to this answer.

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/list-on-flow', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "id": "text",
    "name": "text",
    "type": "text",
    "executionLimit": 0,
    "answerTemplates": [
      {
        "id": "text",
        "content": {
          "description": "text",
          "type": "text",
          "buttons": [],
          "quickReply": [],
          "name": "text"
        },
        "type": "text",
        "channelTypeId": 0,
        "channelId": "text",
        "technicalText": "text",
        "translations": [
          {
            "answerTemplateUUID": "text",
            "locale": "text",
            "content": "text"
          }
        ]
      }
    ],
    "rephraseEnabled": false,
    "tags": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
]

CRUD Methods

Creates a brand new answer

POST/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer

Path parameters

orgUUID*string

A valid uuid of organization

envUUID*string

A valid uuid of environment

botUUID*string

A valid uuid of bot

Body

name*string

The answer's name.

descriptionstring

A freeform description of this answer.

tagsarray of TagsDTO (object)

A list of all tags associated to this answer.

answerTemplates*array of AnswerTemplateRequestDTO (object)

A list of the answer's templates.

webhookstring

A freeform string to code up a webhook for this answer.

transactional*boolean

A boolean indicator representing if this answer is a transactional answer.

evaluable*boolean

A boolean indicator representing if this answer is an evaluable answer.

isMaskedboolean

Whether or not this answer is masked.

headersobject

The answer's Headers. This object is a freeform JSON which must be parser as an object when receiving it.

typestring

The answer's type.

executionLimitinteger (int64)

The number of times an answer can be executed.

rephraseEnabledboolean

Wether the rephrasing feature is active in this answer.

rephrasingTemperaturenumber (double)

The temperature used in the rephrasing feature for this answer.

rephrasingMemoryinteger (int32)

The ammount of previous user inputs used to modify the rephrasing feature.

rephrasingBlackliststring

A number os space-separated blacklisted words to evoid during rephrasing.

Response

Body

answerAnswerDTO (object)

A Structure representing all data of an answer, containing it's templates.

flowsarray of FlowResponseDTO (object)

A list of Flows associated to this answer

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "answerTemplates": [
        {
          "channelId": "text",
          "channelTypeId": 0
        }
      ],
      "evaluable": false,
      "name": "text",
      "transactional": false
    }),
});
const data = await response.json();

Response

{
  "answer": {
    "id": "text",
    "name": "text",
    "description": "text",
    "evaluable": 0,
    "transactional": 0,
    "isMasked": false,
    "updatedAt": "2024-12-21T11:36:03.972Z",
    "updatedBy": "text",
    "tags": [
      {
        "uuid": "text",
        "name": "text"
      }
    ],
    "webhook": "text",
    "type": "text",
    "answerTemplates": [
      {
        "id": "text",
        "content": {
          "description": "text",
          "type": "text",
          "buttons": [],
          "quickReply": [],
          "name": "text"
        },
        "type": "text",
        "channelTypeId": 0,
        "channelId": "text",
        "technicalText": "text",
        "translations": [
          {
            "answerTemplateUUID": "text",
            "locale": "text",
            "content": "text"
          }
        ]
      }
    ],
    "executionLimit": 0,
    "rephraseEnabled": false,
    "rephrasingTemperature": 0,
    "rephrasingMemory": 0,
    "rephrasingBlacklist": "text",
    "user": {
      "name": "text",
      "imageUrl": "text"
    }
  },
  "flows": [
    {
      "uuid": "text",
      "name": "text"
    }
  ]
}

Retrieves info from a specific given answer.

GET/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid}

Path parameters

orgUUID*string

A valid uuid of an organization

envUUID*string

A valid uuid of an environment

botUUID*string

The UUID of the bot whose entity you are searching belong to

uuid*string

The answer's uuid

Response

Body

answerAnswerDTO (object)

A Structure representing all data of an answer, containing it's templates.

flowsarray of FlowResponseDTO (object)

A list of Flows associated to this answer

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "answer": {
    "id": "text",
    "name": "text",
    "description": "text",
    "evaluable": 0,
    "transactional": 0,
    "isMasked": false,
    "updatedAt": "2024-12-21T11:36:03.972Z",
    "updatedBy": "text",
    "tags": [
      {
        "uuid": "text",
        "name": "text"
      }
    ],
    "webhook": "text",
    "type": "text",
    "answerTemplates": [
      {
        "id": "text",
        "content": {
          "description": "text",
          "type": "text",
          "buttons": [],
          "quickReply": [],
          "name": "text"
        },
        "type": "text",
        "channelTypeId": 0,
        "channelId": "text",
        "technicalText": "text",
        "translations": [
          {
            "answerTemplateUUID": "text",
            "locale": "text",
            "content": "text"
          }
        ]
      }
    ],
    "executionLimit": 0,
    "rephraseEnabled": false,
    "rephrasingTemperature": 0,
    "rephrasingMemory": 0,
    "rephrasingBlacklist": "text",
    "user": {
      "name": "text",
      "imageUrl": "text"
    }
  },
  "flows": [
    {
      "uuid": "text",
      "name": "text"
    }
  ]
}

Updates an answer.

PUT/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid}

Path parameters

orgUUID*string

A valid uuid of an organization

envUUID*string

A valid uuid of an environment

botUUID*string

The UUID of the bot whose entity you are searching belong to

uuid*string

The answer's uuid

Body

name*string

The answer's name.

descriptionstring

A freeform description of this answer.

tagsarray of TagsDTO (object)

A list of all tags associated to this answer.

answerTemplates*array of AnswerTemplateRequestDTO (object)

A list of the answer's templates.

webhookstring

A freeform string to code up a webhook for this answer.

transactional*boolean

A boolean indicator representing if this answer is a transactional answer.

evaluable*boolean

A boolean indicator representing if this answer is an evaluable answer.

isMaskedboolean

Whether or not this answer is masked.

headersobject

The answer's Headers. This object is a freeform JSON which must be parser as an object when receiving it.

typestring

The answer's type.

executionLimitinteger (int64)

The number of times an answer can be executed.

rephraseEnabledboolean

Wether the rephrasing feature is active in this answer.

rephrasingTemperaturenumber (double)

The temperature used in the rephrasing feature for this answer.

rephrasingMemoryinteger (int32)

The ammount of previous user inputs used to modify the rephrasing feature.

rephrasingBlackliststring

A number os space-separated blacklisted words to evoid during rephrasing.

Response

Body

answerAnswerDTO (object)

A Structure representing all data of an answer, containing it's templates.

flowsarray of FlowResponseDTO (object)

A list of Flows associated to this answer

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "answerTemplates": [
        {
          "channelId": "text",
          "channelTypeId": 0
        }
      ],
      "evaluable": false,
      "name": "text",
      "transactional": false
    }),
});
const data = await response.json();

Response

{
  "answer": {
    "id": "text",
    "name": "text",
    "description": "text",
    "evaluable": 0,
    "transactional": 0,
    "isMasked": false,
    "updatedAt": "2024-12-21T11:36:03.972Z",
    "updatedBy": "text",
    "tags": [
      {
        "uuid": "text",
        "name": "text"
      }
    ],
    "webhook": "text",
    "type": "text",
    "answerTemplates": [
      {
        "id": "text",
        "content": {
          "description": "text",
          "type": "text",
          "buttons": [],
          "quickReply": [],
          "name": "text"
        },
        "type": "text",
        "channelTypeId": 0,
        "channelId": "text",
        "technicalText": "text",
        "translations": [
          {
            "answerTemplateUUID": "text",
            "locale": "text",
            "content": "text"
          }
        ]
      }
    ],
    "executionLimit": 0,
    "rephraseEnabled": false,
    "rephrasingTemperature": 0,
    "rephrasingMemory": 0,
    "rephrasingBlacklist": "text",
    "user": {
      "name": "text",
      "imageUrl": "text"
    }
  },
  "flows": [
    {
      "uuid": "text",
      "name": "text"
    }
  ]
}

Deletes an answer. The answer is disabled via the 'removed' parameter rather than deleted from the DB.

DELETE/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid}

Path parameters

orgUUID*string

A valid uuid of organization

envUUID*string

A valid uuid of environment

botUUID*string

A valid uuid of bot

uuid*string

The answer's uuid

Response

Request

const response = await fetch('/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "timestamp": 0,
  "errorCode": "text",
  "errorType": "API_ERROR",
  "message": "text",
  "path": "text"
}

PreviousKnowledge AI NLP NextAutomated Tests

Last updated 1 month ago