API DOCSVOICE GATEWAYSECURITY

Dialog Manager

The Dialog Manager is where you configure and draw your flows; Those are the methods you'll need to setup a user flow, configure each Cell and link them.

API SUBPATH: eva-dialog-manager

Flows

Pagination and Listings

Paginates through existing Flows within a bot.

get
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

Query parameters
enabledbooleanRequired

It is the status of the flow, represents whether it is active, default value true

Example: true
pageinteger · int32Required

It is the number of pages that will be returned, default value 0

Default: 0Example: 1
linesPerPageinteger · int32Required

It is the number of Flow per page, default value 5

Default: 5Example: 1
orderBystringRequired

It is the flow attribute used for the page, default attribute name

Default: name
directionstringRequired

It is the sorting type, default value ASC

Default: ASC
searchTermsstring[]Required

It is the parameter that contains the user data entry, that will be used to filter the flows

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows?enabled=true&page=0&linesPerPage=5&orderBy=name&direction=ASC&searchTerms=text HTTP/1.1
Host: 
Accept: */*

{
  "totalPages": 1,
  "totalElements": 1,
  "first": true,
  "last": true,
  "pageable": {
    "paged": true,
    "unpaged": true,
    "pageNumber": 1,
    "pageSize": 1,
    "sort": {
      "unsorted": true,
      "sorted": true,
      "empty": true
    },
    "offset": 1
  },
  "numberOfElements": 1,
  "sort": {
    "unsorted": true,
    "sorted": true,
    "empty": true
  },
  "size": 1,
  "content": [
    {
      "uuid": "text",
      "name": "text",
      "type": "USER_JOURNEY",
      "size": 1,
      "lastModified": {
        "uuid": "text",
        "image": "text",
        "name": "text",
        "timeStamp": 1
      },
      "rules": {
        "delete": true,
        "jumped": true,
        "children": [
          "text"
        ]
      },
      "tags": [
        {
          "name": "text"
        }
      ]
    }
  ],
  "number": 1,
  "empty": true
}

Searches (greedily) for any flow names that exists in a bot, matching the typed term, left-to-right, and returns a list of up to 6 Strings, ordered alphabetically.

get
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

Query parameters
namestringRequired

It is the parameter used to search for flows related to the entered value

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Responses
200
Ok
*/*
Responsestring[]
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows/quicksearch?name=text HTTP/1.1
Host: 
Accept: */*

[
  "text"
]

CRUD Operations

Acquires complete, detailed information of a Flow

get
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

uuidstringRequired

It is the uuid used to search for a Flow

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows/{uuid} HTTP/1.1
Host: 
Accept: */*

{
  "name": "text",
  "description": "text",
  "tags": [
    {
      "name": "text"
    }
  ],
  "type": "USER_JOURNEY",
  "uuid": "text",
  "createdBy": {
    "uuid": "text",
    "image": "text",
    "name": "text",
    "timeStamp": 1
  },
  "rules": {
    "delete": true,
    "jumped": true,
    "children": [
      "text"
    ]
  },
  "disconnected": true,
  "editors": [
    {
      "uuid": "text",
      "image": "text",
      "name": "text",
      "timeStamp": 1
    }
  ],
  "cellsType": [
    {
      "size": 1,
      "cellType": "text",
      "names": [
        "text"
      ]
    }
  ],
  "jumpFrom": {}
}

Creates a new Flow.

post
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Body

The object that contains the data needed to create a Flow

namestringOptional

Name of the flow.

descriptionstringOptional

Description of the flow.

typestring · enumOptional

The flow type shall refer to:

1 - USER_JOURNEY

2 - WELCOME

3 - NOT_EXPECTED

4 - JUMP

Possible values:
Responses
201
CREATED
*/*
post
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "name": "text",
  "description": "text",
  "tags": [
    {
      "name": "text"
    }
  ],
  "type": "USER_JOURNEY"
}
{
  "uuid": "text",
  "name": "text",
  "type": "USER_JOURNEY",
  "size": 1,
  "lastModified": {
    "uuid": "text",
    "image": "text",
    "name": "text",
    "timeStamp": 1
  },
  "rules": {
    "delete": true,
    "jumped": true,
    "children": [
      "text"
    ]
  },
  "tags": [
    {
      "name": "text"
    }
  ]
}

Updates an existing Flow's data.

put
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

uuidstringRequired

It is the uuid used to search for the Flow that will be updated

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Body

The object that contains the data needed to create a Flow

namestringOptional

Name of the flow.

descriptionstringOptional

Description of the flow.

typestring · enumOptional

The flow type shall refer to:

1 - USER_JOURNEY

2 - WELCOME

3 - NOT_EXPECTED

4 - JUMP

Possible values:
Responses
200
OK
*/*
put
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows/{uuid} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "name": "text",
  "description": "text",
  "tags": [
    {
      "name": "text"
    }
  ],
  "type": "USER_JOURNEY"
}
{
  "uuid": "text",
  "name": "text",
  "type": "USER_JOURNEY",
  "size": 1,
  "lastModified": {
    "uuid": "text",
    "image": "text",
    "name": "text",
    "timeStamp": 1
  },
  "rules": {
    "delete": true,
    "jumped": true,
    "children": [
      "text"
    ]
  },
  "tags": [
    {
      "name": "text"
    }
  ]
}

Removes an existing flow.

delete
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

uuidstringRequired

It is the uuid used to search for the Flow that will be deleted

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Responses
204
NO_CONTENT
delete
DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows/{uuid} HTTP/1.1
Host: 
Accept: */*

No content

Auxiliary Methods

Analyzes which types of Flows have already been created, and returns a list of the remaining types that can still be created.

get
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows/types-to-create HTTP/1.1
Host: 
Accept: */*

[
  "USER_JOURNEY"
]

Flow Tree

Fetches a Flow's contents, including it's complete tree, rules and so on.

get
Path parameters
orgUUIDstringRequired

It is the organization where the flow is, used to connect to the correct database

envUUIDstringRequired

It is the environment where the flow is, used to connect to the correct database

botUUIDstringRequired

It is the bot where the flow is, used to filter Flows

uuidstringRequired

It is the uuid used to search for a Flow

Header parameters
x-request-idstringOptional

It is an identifier provided by the API client that will be used to identify distributed logs.

Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/flows/{uuid}/tree HTTP/1.1
Host: 
Accept: */*

{
  "name": "text",
  "description": "text",
  "tags": [
    {
      "name": "text"
    }
  ],
  "type": "USER_JOURNEY",
  "uuid": "text",
  "createdBy": {
    "uuid": "text",
    "image": "text",
    "name": "text",
    "timeStamp": 1
  },
  "rules": {
    "delete": true,
    "jumped": true,
    "children": [
      "text"
    ]
  },
  "disconnected": true,
  "editors": [
    {
      "uuid": "text",
      "image": "text",
      "name": "text",
      "timeStamp": 1
    }
  ],
  "cellsType": [
    {
      "size": 1,
      "cellType": "text",
      "names": [
        "text"
      ]
    }
  ],
  "jumpFrom": {},
  "tree": {
    "uuid": "text",
    "cellFirst": true,
    "cellParentUUID": "text",
    "buttonParentUUID": "text",
    "flowUUID": "text",
    "draftText": "text",
    "cellName": "text",
    "cellType": "text",
    "modelVersion": "text",
    "cellEnable": true,
    "expressionCode": "text",
    "objectRef": "text",
    "editor": {
      "uuid": "text",
      "lastModified": true,
      "lastEdition": 1
    },
    "jumpTo": {
      "cellDestination": "text",
      "cellDestinationName": "text",
      "flowDestination": "text",
      "flowDestinationName": "text"
    },
    "rules": {
      "connectionOnTheLeft": true,
      "connectionOnTheRight": true,
      "connectionOnTheBottom": true,
      "delete": true,
      "children": [
        "text"
      ],
      "sequence": [
        "text"
      ],
      "jump": [
        "text"
      ]
    },
    "disconnected": true,
    "executionLimit": 1,
    "hasSibling": true,
    "jumpFrom": [
      {
        "cellOrigin": "text",
        "flowOrigin": "text"
      }
    ],
    "tags": [
      {
        "name": "text",
        "objectRef": "text",
        "tagTypeId": 1
      }
    ],
    "children": [
      {
        "uuid": "text",
        "cellFirst": true,
        "cellParentUUID": "text",
        "buttonParentUUID": "text",
        "flowUUID": "text",
        "draftText": "text",
        "cellName": "text",
        "cellType": "text",
        "modelVersion": "text",
        "cellEnable": true,
        "expressionCode": "text",
        "objectRef": "text",
        "editor": {
          "uuid": "text",
          "lastModified": true,
          "lastEdition": 1
        },
        "jumpTo": {
          "cellDestination": "text",
          "cellDestinationName": "text",
          "flowDestination": "text",
          "flowDestinationName": "text"
        },
        "rules": {
          "connectionOnTheLeft": true,
          "connectionOnTheRight": true,
          "connectionOnTheBottom": true,
          "delete": true,
          "children": [
            "text"
          ],
          "sequence": [
            "text"
          ],
          "jump": [
            "text"
          ]
        },
        "disconnected": true,
        "executionLimit": 1,
        "hasSibling": true,
        "jumpFrom": [
          {
            "cellOrigin": "text",
            "flowOrigin": "text"
          }
        ],
        "tags": [
          {
            "name": "text",
            "objectRef": "text",
            "tagTypeId": 1
          }
        ],
        "children": [
          {
            "uuid": "text",
            "cellFirst": true,
            "cellParentUUID": "text",
            "buttonParentUUID": "text",
            "flowUUID": "text",
            "draftText": "text",
            "cellName": "text",
            "cellType": "text",
            "modelVersion": "text",
            "cellEnable": true,
            "expressionCode": "text",
            "objectRef": "text",
            "editor": {
              "uuid": "text",
              "lastModified": true,
              "lastEdition": 1
            },
            "jumpTo": {
              "cellDestination": "text",
              "cellDestinationName": "text",
              "flowDestination": "text",
              "flowDestinationName": "text"
            },
            "rules": {
              "connectionOnTheLeft": true,
              "connectionOnTheRight": true,
              "connectionOnTheBottom": true,
              "delete": true,
              "children": [
                "text"
              ],
              "sequence": [
                "text"
              ],
              "jump": [
                "text"
              ]
            },
            "disconnected": true,
            "executionLimit": 1,
            "hasSibling": true,
            "jumpFrom": [
              {
                "cellOrigin": "text",
                "flowOrigin": "text"
              }
            ],
            "tags": [
              {
                "name": "text",
                "objectRef": "text",
                "tagTypeId": 1
              }
            ],
            "children": "[Circular Reference]",
            "options": [
              {
                "buttonUUID": "text",
                "cockpitUUID": "text",
                "urlRedirect": true,
                "buttonUrl": "text",
                "buttonType": "text",
                "buttonText": "text",
                "expressionCode": "text",
                "connectedTo": "text",
                "disconnected": true,
                "rules": {
                  "connectionOnTheLeft": true,
                  "connectionOnTheRight": true,
                  "connectionOnTheBottom": true,
                  "children": [
                    "text"
                  ],
                  "sequence": [
                    "text"
                  ]
                }
              }
            ],
            "description": "text",
            "template": "text"
          }
        ],
        "options": [
          {
            "buttonUUID": "text",
            "cockpitUUID": "text",
            "urlRedirect": true,
            "buttonUrl": "text",
            "buttonType": "text",
            "buttonText": "text",
            "expressionCode": "text",
            "connectedTo": "text",
            "disconnected": true,
            "rules": {
              "connectionOnTheLeft": true,
              "connectionOnTheRight": true,
              "connectionOnTheBottom": true,
              "children": [
                "text"
              ],
              "sequence": [
                "text"
              ]
            }
          }
        ],
        "description": "text",
        "template": "text"
      }
    ],
    "options": [
      {
        "buttonUUID": "text",
        "cockpitUUID": "text",
        "urlRedirect": true,
        "buttonUrl": "text",
        "buttonType": "text",
        "buttonText": "text",
        "expressionCode": "text",
        "connectedTo": "text",
        "disconnected": true,
        "rules": {
          "connectionOnTheLeft": true,
          "connectionOnTheRight": true,
          "connectionOnTheBottom": true,
          "children": [
            "text"
          ],
          "sequence": [
            "text"
          ]
        }
      }
    ],
    "description": "text",
    "template": "text"
  }
}

Cells

CRUD Operations

Retrieves detailed information of a Cell.

get
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

cellUUIDstringRequired

A valid cell Uuid

Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/{cellUUID} HTTP/1.1
Host: 
Accept: */*

{
  "uuid": "text",
  "cellFirst": true,
  "cellParentUUID": "text",
  "buttonParentUUID": "text",
  "flowUUID": "text",
  "draftText": "text",
  "cellName": "text",
  "cellType": "text",
  "modelVersion": "text",
  "cellEnable": true,
  "expressionCode": "text",
  "objectRef": "text",
  "editor": {
    "uuid": "text",
    "lastModified": true,
    "lastEdition": 1
  },
  "jumpTo": {
    "cellDestination": "text",
    "cellDestinationName": "text",
    "flowDestination": "text",
    "flowDestinationName": "text"
  },
  "rules": {
    "connectionOnTheLeft": true,
    "connectionOnTheRight": true,
    "connectionOnTheBottom": true,
    "delete": true,
    "children": [
      "text"
    ],
    "sequence": [
      "text"
    ],
    "jump": [
      "text"
    ]
  },
  "disconnected": true,
  "executionLimit": 1,
  "hasSibling": true,
  "jumpFrom": [
    {
      "cellOrigin": "text",
      "flowOrigin": "text"
    }
  ],
  "tags": [
    {
      "name": "text",
      "objectRef": "text",
      "tagTypeId": 1
    }
  ],
  "children": [
    {
      "uuid": "text",
      "cellFirst": true,
      "cellParentUUID": "text",
      "buttonParentUUID": "text",
      "flowUUID": "text",
      "draftText": "text",
      "cellName": "text",
      "cellType": "text",
      "modelVersion": "text",
      "cellEnable": true,
      "expressionCode": "text",
      "objectRef": "text",
      "editor": {
        "uuid": "text",
        "lastModified": true,
        "lastEdition": 1
      },
      "jumpTo": {
        "cellDestination": "text",
        "cellDestinationName": "text",
        "flowDestination": "text",
        "flowDestinationName": "text"
      },
      "rules": {
        "connectionOnTheLeft": true,
        "connectionOnTheRight": true,
        "connectionOnTheBottom": true,
        "delete": true,
        "children": [
          "text"
        ],
        "sequence": [
          "text"
        ],
        "jump": [
          "text"
        ]
      },
      "disconnected": true,
      "executionLimit": 1,
      "hasSibling": true,
      "jumpFrom": [
        {
          "cellOrigin": "text",
          "flowOrigin": "text"
        }
      ],
      "tags": [
        {
          "name": "text",
          "objectRef": "text",
          "tagTypeId": 1
        }
      ],
      "children": [
        {
          "uuid": "text",
          "cellFirst": true,
          "cellParentUUID": "text",
          "buttonParentUUID": "text",
          "flowUUID": "text",
          "draftText": "text",
          "cellName": "text",
          "cellType": "text",
          "modelVersion": "text",
          "cellEnable": true,
          "expressionCode": "text",
          "objectRef": "text",
          "editor": {
            "uuid": "text",
            "lastModified": true,
            "lastEdition": 1
          },
          "jumpTo": {
            "cellDestination": "text",
            "cellDestinationName": "text",
            "flowDestination": "text",
            "flowDestinationName": "text"
          },
          "rules": {
            "connectionOnTheLeft": true,
            "connectionOnTheRight": true,
            "connectionOnTheBottom": true,
            "delete": true,
            "children": [
              "text"
            ],
            "sequence": [
              "text"
            ],
            "jump": [
              "text"
            ]
          },
          "disconnected": true,
          "executionLimit": 1,
          "hasSibling": true,
          "jumpFrom": [
            {
              "cellOrigin": "text",
              "flowOrigin": "text"
            }
          ],
          "tags": [
            {
              "name": "text",
              "objectRef": "text",
              "tagTypeId": 1
            }
          ],
          "children": [
            "[Circular Reference]"
          ],
          "options": [
            {
              "buttonUUID": "text",
              "cockpitUUID": "text",
              "urlRedirect": true,
              "buttonUrl": "text",
              "buttonType": "text",
              "buttonText": "text",
              "expressionCode": "text",
              "connectedTo": "text",
              "disconnected": true,
              "rules": {
                "connectionOnTheLeft": true,
                "connectionOnTheRight": true,
                "connectionOnTheBottom": true,
                "children": [
                  "text"
                ],
                "sequence": [
                  "text"
                ]
              }
            }
          ],
          "description": "text",
          "template": "text"
        }
      ],
      "options": [
        {
          "buttonUUID": "text",
          "cockpitUUID": "text",
          "urlRedirect": true,
          "buttonUrl": "text",
          "buttonType": "text",
          "buttonText": "text",
          "expressionCode": "text",
          "connectedTo": "text",
          "disconnected": true,
          "rules": {
            "connectionOnTheLeft": true,
            "connectionOnTheRight": true,
            "connectionOnTheBottom": true,
            "children": [
              "text"
            ],
            "sequence": [
              "text"
            ]
          }
        }
      ],
      "description": "text",
      "template": "text"
    }
  ],
  "options": [
    {
      "buttonUUID": "text",
      "cockpitUUID": "text",
      "urlRedirect": true,
      "buttonUrl": "text",
      "buttonType": "text",
      "buttonText": "text",
      "expressionCode": "text",
      "connectedTo": "text",
      "disconnected": true,
      "rules": {
        "connectionOnTheLeft": true,
        "connectionOnTheRight": true,
        "connectionOnTheBottom": true,
        "children": [
          "text"
        ],
        "sequence": [
          "text"
        ]
      }
    }
  ],
  "description": "text",
  "template": "text"
}

Creates a new Cell

post
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
flowUUIDstringRequired

Uuid flow to insert the new cell

cellParentUUIDstringOptional

Uuid of the parent cell. Necessary if it is not the first cell of flow

buttonUUIDstringOptional

Uuid of the button. Necessary if it's a service cell parent

Default: ""
actionstring · enumOptional

Type of insertion

Default: CHILDRENPossible values:
Body

A body containing all necessary data to create a new cell

cellNamestringRequired

Name of the cell

cellTypestring · enumRequired

Type of the cell

Possible values:
descriptionstringOptional

Description of the cell

objectRefstringOptional

Uuid of object to relationate. It can be intent, entity, service...

expressionCodestringRequired

Expression code of the cell

templatestringOptional

Template of the cell. It's required if cell is code or rule type

executionLimitinteger · int64Optional

Number of times that the cell has to execute repeatedly

Responses
201
Created
*/*
post
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells?flowUUID=text HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 372

{
  "cellName": "text",
  "cellType": "ANSWER",
  "description": "text",
  "objectRef": "text",
  "expressionCode": "text",
  "jumpTo": {
    "cellDestination": "text",
    "flowDestination": "text"
  },
  "template": "text",
  "executionLimit": 1,
  "options": [
    {
      "cockpitUUID": "text",
      "urlRedirect": true,
      "buttonUrl": "text",
      "buttonType": "text",
      "buttonText": "text"
    }
  ],
  "tags": [
    {
      "name": "text",
      "objectRef": "text",
      "tagTypeId": 1
    }
  ]
}
[
  {
    "uuid": "text",
    "cellFirst": true,
    "cellParentUUID": "text",
    "buttonParentUUID": "text",
    "flowUUID": "text",
    "draftText": "text",
    "cellName": "text",
    "cellType": "text",
    "modelVersion": "text",
    "cellEnable": true,
    "expressionCode": "text",
    "objectRef": "text",
    "editor": {
      "uuid": "text",
      "lastModified": true,
      "lastEdition": 1
    },
    "jumpTo": {
      "cellDestination": "text",
      "cellDestinationName": "text",
      "flowDestination": "text",
      "flowDestinationName": "text"
    },
    "rules": {
      "connectionOnTheLeft": true,
      "connectionOnTheRight": true,
      "connectionOnTheBottom": true,
      "delete": true,
      "children": [
        "text"
      ],
      "sequence": [
        "text"
      ],
      "jump": [
        "text"
      ]
    },
    "disconnected": true,
    "executionLimit": 1,
    "hasSibling": true,
    "jumpFrom": [
      {
        "cellOrigin": "text",
        "flowOrigin": "text"
      }
    ],
    "tags": [
      {
        "name": "text",
        "objectRef": "text",
        "tagTypeId": 1
      }
    ],
    "children": [
      {
        "uuid": "text",
        "cellFirst": true,
        "cellParentUUID": "text",
        "buttonParentUUID": "text",
        "flowUUID": "text",
        "draftText": "text",
        "cellName": "text",
        "cellType": "text",
        "modelVersion": "text",
        "cellEnable": true,
        "expressionCode": "text",
        "objectRef": "text",
        "editor": {
          "uuid": "text",
          "lastModified": true,
          "lastEdition": 1
        },
        "jumpTo": {
          "cellDestination": "text",
          "cellDestinationName": "text",
          "flowDestination": "text",
          "flowDestinationName": "text"
        },
        "rules": {
          "connectionOnTheLeft": true,
          "connectionOnTheRight": true,
          "connectionOnTheBottom": true,
          "delete": true,
          "children": [
            "text"
          ],
          "sequence": [
            "text"
          ],
          "jump": [
            "text"
          ]
        },
        "disconnected": true,
        "executionLimit": 1,
        "hasSibling": true,
        "jumpFrom": [
          {
            "cellOrigin": "text",
            "flowOrigin": "text"
          }
        ],
        "tags": [
          {
            "name": "text",
            "objectRef": "text",
            "tagTypeId": 1
          }
        ],
        "children": [
          {
            "uuid": "text",
            "cellFirst": true,
            "cellParentUUID": "text",
            "buttonParentUUID": "text",
            "flowUUID": "text",
            "draftText": "text",
            "cellName": "text",
            "cellType": "text",
            "modelVersion": "text",
            "cellEnable": true,
            "expressionCode": "text",
            "objectRef": "text",
            "editor": {
              "uuid": "text",
              "lastModified": true,
              "lastEdition": 1
            },
            "jumpTo": {
              "cellDestination": "text",
              "cellDestinationName": "text",
              "flowDestination": "text",
              "flowDestinationName": "text"
            },
            "rules": {
              "connectionOnTheLeft": true,
              "connectionOnTheRight": true,
              "connectionOnTheBottom": true,
              "delete": true,
              "children": [
                "text"
              ],
              "sequence": [
                "text"
              ],
              "jump": [
                "text"
              ]
            },
            "disconnected": true,
            "executionLimit": 1,
            "hasSibling": true,
            "jumpFrom": [
              {
                "cellOrigin": "text",
                "flowOrigin": "text"
              }
            ],
            "tags": [
              {
                "name": "text",
                "objectRef": "text",
                "tagTypeId": 1
              }
            ],
            "children": "[Circular Reference]",
            "options": [
              {
                "buttonUUID": "text",
                "cockpitUUID": "text",
                "urlRedirect": true,
                "buttonUrl": "text",
                "buttonType": "text",
                "buttonText": "text",
                "expressionCode": "text",
                "connectedTo": "text",
                "disconnected": true,
                "rules": {
                  "connectionOnTheLeft": true,
                  "connectionOnTheRight": true,
                  "connectionOnTheBottom": true,
                  "children": [
                    "text"
                  ],
                  "sequence": [
                    "text"
                  ]
                }
              }
            ],
            "description": "text",
            "template": "text"
          }
        ],
        "options": [
          {
            "buttonUUID": "text",
            "cockpitUUID": "text",
            "urlRedirect": true,
            "buttonUrl": "text",
            "buttonType": "text",
            "buttonText": "text",
            "expressionCode": "text",
            "connectedTo": "text",
            "disconnected": true,
            "rules": {
              "connectionOnTheLeft": true,
              "connectionOnTheRight": true,
              "connectionOnTheBottom": true,
              "children": [
                "text"
              ],
              "sequence": [
                "text"
              ]
            }
          }
        ],
        "description": "text",
        "template": "text"
      }
    ],
    "options": [
      {
        "buttonUUID": "text",
        "cockpitUUID": "text",
        "urlRedirect": true,
        "buttonUrl": "text",
        "buttonType": "text",
        "buttonText": "text",
        "expressionCode": "text",
        "connectedTo": "text",
        "disconnected": true,
        "rules": {
          "connectionOnTheLeft": true,
          "connectionOnTheRight": true,
          "connectionOnTheBottom": true,
          "children": [
            "text"
          ],
          "sequence": [
            "text"
          ]
        }
      }
    ],
    "description": "text",
    "template": "text"
  }
]

Updates an existing Cell.

put
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

cellUUIDstringRequired

A valid cell Uuid

Query parameters
buttonUUIDstringOptional

New button parent uuid

Default: ""
Body

A body containing all necessary data to update cell

cellNamestringRequired

Name of the cell

descriptionstringOptional

Description of the cell

objectRefstringOptional

Uuid of object to relationate. It can be intent, entity, service...

expressionCodestringRequired

Expression code of the cell

cellEnablebooleanRequired

True if wants to enable cell or false if not

templatestringOptional

Template of the cell. It's required if cell is code or rule type

executionLimitinteger · int64Optional

Number of times that the cell has to execute repeatedly

Responses
204
No Content
put
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/{cellUUID} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 370

{
  "cellName": "text",
  "description": "text",
  "objectRef": "text",
  "expressionCode": "text",
  "cellEnable": true,
  "jumpTo": {
    "cellDestination": "text",
    "flowDestination": "text"
  },
  "template": "text",
  "executionLimit": 1,
  "options": [
    {
      "cockpitUUID": "text",
      "urlRedirect": true,
      "buttonUrl": "text",
      "buttonType": "text",
      "buttonText": "text"
    }
  ],
  "tags": [
    {
      "name": "text",
      "objectRef": "text",
      "tagTypeId": 1
    }
  ]
}
No content

Removes an existing Cell.

delete
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

cellUUIDstringRequired

A valid cell Uuid

Query parameters
deleteInCascadebooleanOptional

True if wants to delete all children of the cell. False if wants to delete only the cell and converting it to Placeholder type

Default: true
Responses
204
No Content
delete
DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/{cellUUID} HTTP/1.1
Host: 
Accept: */*

No content

Auxiliary Methods

Changes the visibility of one Cell

put
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Body

A body containing all necessary data to create a new cell

botIdstringRequired

Uuid of the bot

objectRefstringRequired

Uuid of object to relationate. It can be intent, entity, service...

visibilitybooleanRequired

true if you want to make visible, false if not

Responses
204
No Content
put
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/change-visibility HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "botId": "text",
  "objectRef": "text",
  "visibility": true
}
No content

Validates the template of Cell

post
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
cellTypestring · enumRequired

Type of cell to list

Possible values:
Body

DTO with the template of cell to valid

templatestringOptional
Responses
200
Ok
*/*
post
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/template/validate?cellType=ANSWER HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "template": "text"
}
{
  "valid": true,
  "message": "text"
}

Flow Tree

List all Cells, also informing wether they can be connected left, bottom or right

get
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
uuidstringRequired

A valid cell Uuid

directionstring · enumRequired

Direction that wants to know the possible connections. It can be left, bottom or right

Possible values:
Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/connection?uuid=text&direction=LEFT HTTP/1.1
Host: 
Accept: */*

[
  {
    "uuid": "text",
    "connectionOnTheLeft": true,
    "connectionOnTheRight": true,
    "connectionOnTheBottom": true
  }
]

Estabilishes a sequential connection between two existing cells.

put
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
cellOriginstringRequired

UUID of origin cell to connect

cellDestinationstringRequired

UUID of destination cell to connect

buttonUUIDstringRequired

UUID of button to connect if is service cell

Default: ""
directionstring · enumRequired

Direction that wants to know the possible connections. It can be left, bottom or right

Possible values:
Responses
204
No Content
put
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/connection?cellOrigin=text&cellDestination=text&buttonUUID=&direction=LEFT HTTP/1.1
Host: 
Accept: */*

No content

Lists all Cells that currently are the first cell of any existing Flow within one Bot.

get
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
cellTypestring · enumRequired

Type of cell to list

Possible values:
Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/start-flows?cellType=ANSWER HTTP/1.1
Host: 
Accept: */*

[
  {
    "uuid": "text",
    "cellFirst": true,
    "cellParentUUID": "text",
    "buttonParentUUID": "text",
    "flowUUID": "text",
    "draftText": "text",
    "cellName": "text",
    "cellType": "text",
    "modelVersion": "text",
    "cellEnable": true,
    "expressionCode": "text",
    "objectRef": "text",
    "editor": {
      "uuid": "text",
      "lastModified": true,
      "lastEdition": 1
    },
    "jumpTo": {
      "cellDestination": "text",
      "cellDestinationName": "text",
      "flowDestination": "text",
      "flowDestinationName": "text"
    },
    "rules": {
      "connectionOnTheLeft": true,
      "connectionOnTheRight": true,
      "connectionOnTheBottom": true,
      "delete": true,
      "children": [
        "text"
      ],
      "sequence": [
        "text"
      ],
      "jump": [
        "text"
      ]
    },
    "disconnected": true,
    "executionLimit": 1,
    "hasSibling": true,
    "jumpFrom": [
      {
        "cellOrigin": "text",
        "flowOrigin": "text"
      }
    ],
    "tags": [
      {
        "name": "text",
        "objectRef": "text",
        "tagTypeId": 1
      }
    ],
    "children": [
      {
        "uuid": "text",
        "cellFirst": true,
        "cellParentUUID": "text",
        "buttonParentUUID": "text",
        "flowUUID": "text",
        "draftText": "text",
        "cellName": "text",
        "cellType": "text",
        "modelVersion": "text",
        "cellEnable": true,
        "expressionCode": "text",
        "objectRef": "text",
        "editor": {
          "uuid": "text",
          "lastModified": true,
          "lastEdition": 1
        },
        "jumpTo": {
          "cellDestination": "text",
          "cellDestinationName": "text",
          "flowDestination": "text",
          "flowDestinationName": "text"
        },
        "rules": {
          "connectionOnTheLeft": true,
          "connectionOnTheRight": true,
          "connectionOnTheBottom": true,
          "delete": true,
          "children": [
            "text"
          ],
          "sequence": [
            "text"
          ],
          "jump": [
            "text"
          ]
        },
        "disconnected": true,
        "executionLimit": 1,
        "hasSibling": true,
        "jumpFrom": [
          {
            "cellOrigin": "text",
            "flowOrigin": "text"
          }
        ],
        "tags": [
          {
            "name": "text",
            "objectRef": "text",
            "tagTypeId": 1
          }
        ],
        "children": [
          {
            "uuid": "text",
            "cellFirst": true,
            "cellParentUUID": "text",
            "buttonParentUUID": "text",
            "flowUUID": "text",
            "draftText": "text",
            "cellName": "text",
            "cellType": "text",
            "modelVersion": "text",
            "cellEnable": true,
            "expressionCode": "text",
            "objectRef": "text",
            "editor": {
              "uuid": "text",
              "lastModified": true,
              "lastEdition": 1
            },
            "jumpTo": {
              "cellDestination": "text",
              "cellDestinationName": "text",
              "flowDestination": "text",
              "flowDestinationName": "text"
            },
            "rules": {
              "connectionOnTheLeft": true,
              "connectionOnTheRight": true,
              "connectionOnTheBottom": true,
              "delete": true,
              "children": [
                "text"
              ],
              "sequence": [
                "text"
              ],
              "jump": [
                "text"
              ]
            },
            "disconnected": true,
            "executionLimit": 1,
            "hasSibling": true,
            "jumpFrom": [
              {
                "cellOrigin": "text",
                "flowOrigin": "text"
              }
            ],
            "tags": [
              {
                "name": "text",
                "objectRef": "text",
                "tagTypeId": 1
              }
            ],
            "children": "[Circular Reference]",
            "options": [
              {
                "buttonUUID": "text",
                "cockpitUUID": "text",
                "urlRedirect": true,
                "buttonUrl": "text",
                "buttonType": "text",
                "buttonText": "text",
                "expressionCode": "text",
                "connectedTo": "text",
                "disconnected": true,
                "rules": {
                  "connectionOnTheLeft": true,
                  "connectionOnTheRight": true,
                  "connectionOnTheBottom": true,
                  "children": [
                    "text"
                  ],
                  "sequence": [
                    "text"
                  ]
                }
              }
            ],
            "description": "text",
            "template": "text"
          }
        ],
        "options": [
          {
            "buttonUUID": "text",
            "cockpitUUID": "text",
            "urlRedirect": true,
            "buttonUrl": "text",
            "buttonType": "text",
            "buttonText": "text",
            "expressionCode": "text",
            "connectedTo": "text",
            "disconnected": true,
            "rules": {
              "connectionOnTheLeft": true,
              "connectionOnTheRight": true,
              "connectionOnTheBottom": true,
              "children": [
                "text"
              ],
              "sequence": [
                "text"
              ]
            }
          }
        ],
        "description": "text",
        "template": "text"
      }
    ],
    "options": [
      {
        "buttonUUID": "text",
        "cockpitUUID": "text",
        "urlRedirect": true,
        "buttonUrl": "text",
        "buttonType": "text",
        "buttonText": "text",
        "expressionCode": "text",
        "connectedTo": "text",
        "disconnected": true,
        "rules": {
          "connectionOnTheLeft": true,
          "connectionOnTheRight": true,
          "connectionOnTheBottom": true,
          "children": [
            "text"
          ],
          "sequence": [
            "text"
          ]
        }
      }
    ],
    "description": "text",
    "template": "text"
  }
]

Lists all Flows in which it is possible to jump to.

get
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
flowUUIDstringRequired

A valid flow Uuid

cellParentUUIDstringRequired

Uuid of the parent cell

actionstring · enumOptional

Type of insertion

Default: CHILDRENPossible values:
Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/jump?flowUUID=text&cellParentUUID=text HTTP/1.1
Host: 
Accept: */*

[
  {
    "uuid": "text",
    "name": "text",
    "type": "USER_JOURNEY",
    "enabled": true,
    "error": "text"
  }
]

Lists all buttons of a service Cell.

get
Path parameters
orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters
cellTypestring · enumRequired

Type of cell to list

Possible values:
objectRefstringRequired

Id of the object intent, entity, service...

Responses
200
Ok
*/*
get
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/cells/buttons?cellType=ANSWER&objectRef=text HTTP/1.1
Host: 
Accept: */*

[
  {
    "buttonUUID": "text",
    "cockpitUUID": "text",
    "urlRedirect": true,
    "buttonUrl": "text",
    "buttonType": "text",
    "buttonText": "text",
    "expressionCode": "text",
    "connectedTo": "text"
  }
]

PreviousDashboardNextEntity

Was this helpful?

#144: 4.5 - Gen AI (KAI, Rephrase, Assist) + What's New (Notifications)

Change request updated