Use Rovo with Confluence automation
Rovo is a new virtual teammate to help you and your team to work more effectively. Using artificial intelligence and machine learning, Rovo is an AI tool that is integrated into our cloud-based apps. In Confluence automation, you can use Rovo to quickly and easily create automated rules.
The quality, accuracy, and reliability of rules created with AI may vary. Learn why
Rovo and AI features aren’t available for Atlassian Government apps.
How do I use Rovo to create a rule?
Rules are automated workflows constructed in an “if this happens, then that happens” format. App admins can create and enable rules that function across Confluence. Space admins can create and enable rules for individual spaces. If you have a personal space, you’re considered an admin of this space.
You can use Rovo to generate rules by simply describing what to create. To get started:
Go to your space. Next to your space's name in the sidebar, select More actions (•••), then Space settings.
Select Automation from the sidebar.
Select Create with Rovo or
Select the input box beneath Create rules quickly with Rovo to begin typing.
Describe the rule you’d like to create, including a trigger and action. You can use one of the examples provided or write your own rule.
Select Preview rule to see a preview of the rule that was generated.
Check the summary of the rule generated by Rovo, and add any missing steps or details.
Once you’re happy with your rule’s configuration, select Enable rule.
Your rule will now be enabled and visible in the rule library.
What’s required to create a rule?
Each rule is made by combining a triggering event and various combinations of steps: actions, conditions, and branches. Think of steps as the building blocks of a rule. To successfully create a rule, your rule must contain at least one trigger and one action.
Triggers
A trigger is what causes a rule to run. Triggers can listen for events such as a page being created in your space, or be scheduled to run on a certain time or date. In the following examples, triggers are highlighted in bold:
Every Monday, find all the tasks with a due date in the next 7 days, and send the assignee a reminder email.
Every 6 months, archive any pages that haven’t been updated in that time. After archiving, send an email to the page author letting them know.
When a page is published with Product Spec in the title, create a Jira work item to review the page with a link to the page.
Actions
An action is what you want your rule to do. It will execute when a rule runs successfully. Examples of actions in Confluence automation can include creating a new space, sending an email or adding a label to a page when your rule successfully runs. In the following examples, actions are highlighted in bold:
Every Monday, find all the tasks with a due date in the next 7 days, and send the assignee a reminder email.
Every 6 months, archive any pages that haven’t been updated in that time. After archiving, send an email to the page author letting them know.
When a page is published with Product Spec in the title, create a Jira ticket to review the page with a link to the page.
Keep in mind that a trigger and an action are the minimum steps required to successfully create a rule. You may still need to configure individual steps or add more details to your rule before it can be enabled. You can also add conditions or branches to your rule if you’d like to make it more detailed.
What steps are supported by Rovo?
Rovo doesn’t support the following trigger and actions:
Incoming webhook trigger
Create variable action
Send web request action
Create lookup table action
For a rule to be successfully created, all its steps must be supported by Confluence automation. This means that any triggers, actions, conditions or branches in your rule must be compatible with Confluence automation. With the exception of the steps mentioned above, Rovo can support any of the steps in the following list:
View list of supported steps in Confluence automation
What errors can occur when using Rovo?
When using Rovo to create rules in Confluence automation, it’s possible to encounter some errors. The following table provides more information about errors that can occur:
Error Type | Additional Information on Error |
|---|---|
The volume of requests in system is too high | Rovo is currently processing a high volume of rule creation requests, and can’t create your rule as a result. Wait a few minutes and then try creating your rule again. |
We’re unable to connect to server | Due to a connection error, we’re currently unable to connect to the server and create your rule. Wait a few minutes and then try creating your rule again. |
An unknown error occurred | We’ve encountered an error that prevented us from creating your rule, but we aren’t sure what caused it. Wait a few minutes and then try creating your rule again. |
We’re unable to create your rule | We tried to create your rule, however for an unspecified reason, we couldn’t finish creating it. This may be due to your requested rule not being specific enough, or containing language our system couldn’t understand. Try creating your rule again by entering a more specific prompt. |
Prompt was too long | Your prompt exceeded our word limit of 300 words, meaning we aren’t able to create a rule with it. Try creating your rule again by shortening your prompt. |
We’re unable to use the prompt | Your prompt may have contained malicious or unethical content, meaning we aren’t able to create a rule with it. Try creating your rule again, making sure to remove any malicious content from your prompt. |
If errors persist or you'd like additional support, contact us here.
Was this helpful?