Cloner API
How to export or import the Bot structure, including various kinds of information, such as: Basic Bot Data, Intentions, Entity, Registered Flows, Channels and etc
This feature is solely intended for eva Server Clients without access to the Cockpit.
If your deployment contains Cockpit, you may import and export the virtual agents through the UI instead.
The eva platform provides an external endpoint capable of exporting or importing the virtual agent structure, this includes various kinds of information, such as: Basic Data, Intentions, Entity, Registered Flows, Channels, etc. These endpoints are extremely useful during environment migration or even for backing up a specific "Bot".
For the following methods, this is the base url:
https://{installationURL}/eva-cloner/org/{orgUUID}/env/{envUUID}/cloner
The installationURL is the URL provided to you by your eva installation administrator. If you lost it, you may request it again.
Export service
Method: | GET |
URL: | /export |
Type: | application/json |
The request responsible to extracting all information. It will return you a zip file, and requires your token's user to at least have access to the Editor role in your virtual agent.
URL Parameters
Name | Type | Required | Description |
orgUUID | String | Yes | Your organization's UUID. |
envUUID | String | Yes | UUID of the environment your bot is located. |
Query parameters
Name | Data Type | Required | Description |
botName | String | Yes | The Bot name, who intends to extract information |
Headers
| Name | Data Type | Required | Description |
|---|---|---|---|
Name | Data Type | Required | Description |
AUTHORIZATION | String | Yes | A Bearer Token. For more details, see the Authentication section on 'Conversation API'. Required when calling the ‘Authenticated conversation service’ endpoint. |
Response
This service has an Application/ZIP return type. The returned Zip may be sent, as is, to the import virtual agent service.
Import service
Method: | POST |
URL: | /import |
Type: | application/json |
This service receives a zip file in a specific format, obtained in the 'export bot service', and re-creates the virtual agent in the desired environment. The environment doesn't need to be the same as the original one, and you may also import virtual agents from 3.x versions into 4.x versions.
The token's user permissions must be at least as high as 'Editor' to the whole chosen environment.
URL Parameters
Name | Type | Required | Description |
orgUUID | String | Yes | Your organization's UUID. |
envUUID | String | Yes | UUID of the environment your bot is located. |
Query parameters
Name | Data Type | Required | Description |
botName | String | Yes | After import, this will be the bot final name. |
file | Form Data FILE | Yes | The zip file containing all bot information. This is the same zip obtained in the export method. |
Headers
| Name | Data Type | Required | Description |
|---|---|---|---|
Name | Data Type | Required | Description |
AUTHORIZATION | String | Yes | A Bearer Token. For more details, see the Authentication section on 'Conversation API'. Required when calling the ‘Authenticated conversation service’ endpoint. |
Response
HTTP Status | Description |
201 | Created, the Import operation was successful |