You can use the Prebuilt Action Templates from your Confluence integration to auto-create dialog tasks and test them using the Talk to Bot option.
Steps to create a dialog task using Confluence action templates:
- Go to Build > Conversation Skills > Dialog Tasks.
- Click Create a Dialog Task.
- On the Dialog Task pop-up, under the Integration, select the Confluence option to view the action templates.
Note: If you have not configured any integration for your virtual assistant, you will see the Explore Integrations option. Once you click this option, you will be redirected to the Actions page to configure an integration for your VA. For more information, see Actions Overview.
Confluence Actions
The following Confluence action is supported in the latest version of the XO Platform:
Supported Actions | Description | Method |
Create Content | Creates content in the Confluence space. | POST |
Create Content
Steps to create content using the Confluence integration:
- Refer to the Installing the Confluence Templates section to install this template.
- The createContent dialog task is added with the following components:
- createContent: A user intent to create content in the Confluence space.
- contentType, spaceKey, contentTitle, and contentBody – Entity nodes for entering the required details to create content.
- getResourceIdService – A bot action service to fetch the resource ID from the Confluence integration. Click the Plus icon to expand to view the getResouceIdService bot action component properties. In the Component Properties window, click the Edit Request link to edit the request parameters as shown below:
Sample Request{ "title": "Page 1", "type": "page", "space": { "key": "SFPWP" }, "status": "current", "body": { "storage": { "value": "Here is the value of this body", "representation": "storage" } } }
To add one or more responses, scroll down and click the +Add Response button:
Sample Response{ "id": "21004299", "type": "page", "status": "current", "title": "Page 1", "space": { "id": 196612, "key": "SFPWP", "name": "Space For Playing with Postman", "type": "global", "status": "current", "_expandable": { "settings": "/rest/api/space/SFPWP/settings", "metadata": "", "operations": "", "lookAndFeel": "/rest/api/settings/lookandfeel?spaceKey=SFPWP", "identifiers": "", "permissions": "", "icon": "", "description": "", "theme": "/rest/api/space/SFPWP/theme", "history": "", "homepage": "/rest/api/content/196695" }, "_links": { "webui": "/spaces/SFPWP", "self": "https://xyz.atlassian.net/wiki/rest/api/space/SFPWP" } }, "history": { "latest": true, "createdBy": { "type": "known", "accountId": "632852448b75455be45293bd", "accountType": "atlassian", "email": "alan.walker@xyz.com", "publicName": "alan.walker", "profilePicture": { "path": "/wiki/aa-avatar/632852448b75455be45293bd", "width": 48, "height": 48, "isDefault": false }, "displayName": "alan.walker", "isExternalCollaborator": false, "_expandable": { "operations": "", "personalSpace": "" }, "_links": { "self": "https://purushottam1.atlassian.net/wiki/rest/api/user?accountId=632852448b75455be45293bd" } }, "createdDate": "2023-07-11T11:29:38.860Z", "_expandable": { "lastUpdated": "", "previousVersion": "", "lastOwnedBy": "", "contributors": "", "nextVersion": "", "ownedBy": "" }, "_links": { "self": "https://purushottam1.atlassian.net/wiki/rest/api/content/21004299/history" } }, "version": { "by": { "type": "known", "accountId": "632852448b75455be45293bd", "accountType": "atlassian", "email": "alan.walker@xyz.com", "publicName": "alan.walker", "profilePicture": { "path": "/wiki/aa-avatar/632852448b75455be45293bd", "width": 48, "height": 48, "isDefault": false }, "displayName": "alan.walker", "isExternalCollaborator": false, "_expandable": { "operations": "", "personalSpace": "" }, "_links": { "self": "https://purushottam1.atlassian.net/wiki/rest/api/user?accountId=632852448b75455be45293bd" } }, "when": "2023-07-11T11:29:38.860Z", "friendlyWhen": "just a moment ago", "message": "", "number": 1, "minorEdit": false, "ncsStepVersion": "1", "ncsStepVersionSource": "ncs-ack", "confRev": "confluence$content$21004299.4", "contentTypeModified": false, "_expandable": { "collaborators": "", "content": "/rest/api/content/21004299" }, "_links": { "self": "https://purushottam1.atlassian.net/wiki/rest/api/content/21004299/version/1" } }, "ancestors": [ { "id": "196695", "type": "page", "status": "current", "title": "Space For Playing with Postman", "macroRenderedOutput": {}, "extensions": { "position": 435 }, "_expandable": { "container": "/rest/api/space/SFPWP", "metadata": "", "restrictions": "/rest/api/content/196695/restriction/byOperation", "history": "/rest/api/content/196695/history", "body": "", "version": "", "descendants": "/rest/api/content/196695/descendant", "space": "/rest/api/space/SFPWP", "childTypes": "", "schedulePublishInfo": "", "operations": "", "schedulePublishDate": "", "children": "/rest/api/content/196695/child", "ancestors": "" }, "_links": { "self": "https://purushottam1.atlassian.net/wiki/rest/api/content/196695", "tinyui": "/x/VwAD", "editui": "/pages/resumedraft.action?draftId=196695", "webui": "/spaces/SFPWP/overview" } } ], "container": { "id": 196612, "key": "SFPWP", "name": "Space For Playing with Postman", "type": "global", "status": "current", "history": { "createdBy": { "type": "known", "accountId": "632852448b75455be45293bd", "accountType": "atlassian", "email": "alan.walker@xyz.com", "publicName": "alan.walker", "profilePicture": { "path": "/wiki/aa-avatar/632852448b75455be45293bd", "width": 48, "height": 48, "isDefault": false " }, "displayName": "alan.walker", "isExternalCollaborator": false, "_expandable": { "operations": "", "personalSpace": "" }, "_links": { "self": "https://xyz.atlassian.net/wiki/rest/api/user?accountId=632852448b75455be45293bd" } }, "createdDate": "2022-11-21T13:02:10.295Z" }, "_expandable": { "settings": "/rest/api/space/SFPWP/settings", "metadata": "", "operations": "", "lookAndFeel": "/rest/api/settings/lookandfeel?spaceKey=SFPWP", "identifiers": "", "permissions": "", "icon": "", "description": "", "theme": "/rest/api/space/SFPWP/theme", "homepage": "/rest/api/content/196695" }, "_links": { "webui": "/spaces/SFPWP", "self": "https://xyz.atlassian.net/wiki/rest/api/space/SFPWP }, "macroRenderedOutput": {}, "body": { "storage": { "value": "Here is the value of this body", "representation": "storage", "embeddedContent": [], "_expandable": { "content": "/rest/api/content/21004299" } }, "_expandable": { "editor": "", "atlas_doc_format": "", "view": "", "export_view": "", "styled_view": "", "dynamic": "", "editor2": "", "anonymous_export_view": "" } }, "extensions": { "position": 3472 }, "_expandable": { "childTypes": "", "schedulePublishInfo": "", "metadata": "", "operations": "", "schedulePublishDate": "", "children": "/rest/api/content/21004299/child", "restrictions": "/rest/api/content/21004299/restriction/byOperation", "descendants": "/rest/api/content/21004299/descendant" }, "_links": { "editui": "/pages/resumedraft.action?draftId=21004299", "webui": "/spaces/SFPWP/pages/21004299/storage+ddd", "context": "/wiki", "self": "https://xyz.atlassian.net/wiki/rest/api/content/21004299", "tinyui": "/x/C4BAAQ", "collection": "/rest/api/content", "base": "https://xyz.atlassian.net/wiki" } }
- createContentService – A bot action service to create content in the Confluence space. Click the Plus icon to expand to view the createContentService bot action component properties. In the Component Properties window, click the Edit Request link to edit the request parameters.
- createContentMessage – A message node with the script to display responses for creating content.
- Click the Train tab to complete the Dialog task training.
- Click the Talk to Bot icon to test and debug the dialog task.
- Follow the prompts in the VA console to create content on Confluence as shown below:
- Enter a title and body details when prompted by the VA as shown below:
- You will notice that content is created with the title and body on Confluence. Expand and click the View Content button.
- You can view the page on Confluence.