HomeDocumentationAPI Reference
Getting StartedAPI ReferenceBug ReportingCrash ReportingAPMHelp Center

Workflow Automation for Bug Reporting

Automate your workflow through Alerts & Rules

The testing process can be a lengthy manual process where the tester/user has to do several actions to submit thorough feedback including:

  • Include all relevant screenshots.
  • Pull all logs from the device
  • Explain how to reproduce the bug
  • Manually submit a ticket to the tracking system

Instabug helps you automate this entire process, as well as extra automation capabilities that you can utilize to save time and eliminate a handful of manual tasks.

Set up your integrations

Instabug natively integrates with plenty of workflow management and messaging tools (Jira, Slack, MS Teams, PagerDuty, ServiceNow, and more), you can easily create an integration from the dashboard by navigating to the setting from the left menu

2876

Settings Menu - Bottom left of the dashboard

On this menu you will see a list of all configured integrations, get started by integrating with your current workflow tools. If your tool is not listed here, you can use “Zapier” or “Webhooks” integrations if that tool is compatible with any of those integrations.
Read more about our integrations here

862

Integrations hub

After creating your integrations, you shall now start creating rules and alerts, In this section we will cover the possible workflow automation options for bug reporting.

Workflow Automation Examples:

  • Keep your users updated with the status of their reports.
  • Create alerts to get your team notified about any updates.
  • Assign issues to the right team members
  • Triage and manage issues from your preferred system, no need to manage tickets on multiple tools

Create your rules

To get started with bug reporting workflow automation, hover the the left navigation menu and click on “Alerts & Rules”

2874

Alerts and Rules page from the Instabug menu

You can view a list of all created rules, you can also use the filters to view only rules for bugs, crashes or performance metrics, click on “Create” to get started.

2874

Use this filter to view previously created rules

Bug Reporting Alert

Select “Bugs” from the dropdown menu under the “For”

2874

Choose a type - "For" - "Bugs"

Triggers

Then you need to select a trigger, below is a list of all available triggers:

  • Bug is reported: Get notified or apply several actions when a bug is reported, like forwarding to your ticketing tools, replying to the user and more.
  • Bug is forwarded: Get notified or apply other actions whenever a bug is forwarded to any integration
  • Status changes: Stay updated whenever the status of a bug report is changed
  • Assignee changes: Stay updated whenever the assignee for a bug report is changed
  • Priority changes: Stay updated whenever the priority of a bug report is changed
  • Tag is added: Apply several actions whenever a tag is added to the bug report. This can be used as a quick and easy way to automate any workflow simply by adding a tag to the bug report
2874

Choose a trigger

Conditions

After selecting the trigger, you can select a set of conditions that need to be met for the rule to be triggered.

🚧

Make sure you set the condition

If you do not select any conditions, the rule will be applied to any reported bug.

Below is a list of all available conditions:

  • Title: Specify if the bug description should include any keywords for the rule to be triggered
  • Reporter’s email: Can be used if you want to focus on reports coming from internal testers
  • App version
  • Current View: The screen used right before reporting the bug (screen affected by the bug)
  • Categories: These can be the main categories (Report a bug, Suggest an improvement, Ask a question) or one of the custom report categories you use
  • Tags: Tags can be added manually to a bug report, or automatically added through code
  • Device: Device type/name used to report the bug
  • Status: The status of the bug report on the dashboard
  • Priority: The priority of the bug report on the dashboard
  • Assignee: The team member assigned to the bug report on the dashboard
  • OS: OS type/name used to report the bug
  • Location (City/Country): Specify the location of the reporter as a condition
  • User attributes: Specify conditions for the user attributes (e.g login status, paying status, user ID and more). Know how to add user attributes here

You can add as many conditions as you see fit, you can also choose to “AND” or “OR” the selected conditions.

2874

Choose one of the conditions

Alerting channels

The last thing you need to do is specify the actions you want to automate using this rule. There are various actions available:

  • Forward it to: Forward the bug report to any of the setup integrations (Slack, Jira, Zendesk, Github and more). See more info about available integrations and how to set up here
  • Reply to user: Send an in-app message to the reporter to update them on the status of the report, ask them further questions and more. This is a 2-way conversation
  • Assign to member: Automatically assign bugs to the right team member
  • Change its status to: Change the status of the report to one of: New, In-progress & Closed. This can be used to close reports coming from very old app versions
  • Change its priority to: Change the priority of the report (Trivial, Minor, Major, Blocker)
  • Tag it with: Automatically add tags to a report
  • Delete it: Automatically delete a report, can be used to delete reports coming from very old app versions
  • Send email to: Send an email to a dashboard member(s)

You can add as many actions as you see fit, helping you eliminate several manual tasks using a single rule.

The below rule example is going to evaluate each bug report against the specified conditions, if they’re met then the bug will be forwarded to the Jira project, change the report status to in-progress and send an automated reply to the user.

2874

Choose one of the actions, for example: forward to the relevant Jira project

Finally you need to provide a title to the rule and click “Save”, you can also assign this rule to a team for ownership and to easily find rules related to your team. You can create teams on the dashboard here.

2876

Choose the team that owns this rule

Now let’s discover different scenarios for workflow automations, and how you can use the rules to achieve this:

Scenario A:
You have an internal testing program and you’re using Instabug to streamline the feedback process, and you want to forward all bugs reported by the company members to the designated Jira project, receive Slack notifications and add the appropriate tag(s) to the report

2876

Forward and tag rule

Scenario B:

You want to be connected to your users as much as possible, you want to send an auto reply to them once they report an issue, and also keep them posted with any updates that happen on the report.

The below rule will send an auto reply to the reporter

2876

Send an automatic reply to the user that reported the bug

You can also leverage the report tags, which can be used as a quick way to apply several actions, like updating the user once any action is taken on the bug report.

Below are a couple of examples on how to utilize tags, the relevant actions will be applied once you add the appropriate tag to the bug report.
The below two examples will send a different message to the user based on the added tag

2876

How you can utilize the tags option

2876

Another example on how to use the tag option

If you need further assistance on setting up rules, please feel free to contact our support team.