Note: you can’t update a Custom Issue Field if it is used to branch a Bot workflow. If the Custom Issue Field is only being being updated by a Bot, you can edit it.

If you are not updating any Custom Issue Fields used to branch your Bot, you can duplicate the active Bot that needs to be updated, make the changes to the new Bot, and publish it. After that, you can update the Automation to assign to the new Bot. The active conversations will finish with the old Bot and then you can disable it.

Before you begin, you’ll need to plan how incoming Issues will be handled while the Bot is disabled, as well as what you want to do with the active Bot conversations. You can take them over and have them re-assigned to Agents, or allow them to finish on their own. In most cases, letting the Bot finish it’s conversations and manually taking over any Issues that haven’t finished in a given time period is the best approach.

The first step of updating an active Custom Bot is to temporarily disable all Automations which are set up to assign Issues to the Custom Bot. Make sure you have a plan for routing the issues that would normally be assigned to this bot. You can disable an Automation as follows:

1. Navigate to Settings > Automations

2. Click the gear icon next to the Automation, then click ‘Edit’

3. On the ‘Edit Automation’ page, click on the ‘Enabled?’ toggle at the bottom to turn it off

Click the ‘Save Changes’ button to update the Automation.

After this, you’ll have a few options:

1. Allow all currently active conversations to finish, and the Custom Bot will execute it’s final steps with no new Issues assigned. You can re-assign all of the remaining conversations that haven’t finished in a reasonable time frame.

2. You can also manually take over all active conversations and re-assign them to Agents. You can run an Advanced Search to identify the open Issues currently being managed by a Custom Bot using the following statement. This allows you to make the update to the field quickly and may be best if you expect a lot of incoming traffic while bot is disabled.

assignee=bug report bot and status= none of resolved, rejected

Once you’ve identified these Issues, you can bulk assign them to an Agent, Group, Queue or different Bot to have your team pick up these Issues.

Once you’ve updated the flow and all active Issues have been reassigned, you’ll need to:

1. Duplicate the Bot, but do not publish it yet.
2. Delete the original published Custom Bot

This will allow you remove the step in the duplicated Bot that uses a Custom Issue Field for branching. You can then update the Custom Issue Field and re-add the step into the newly duplicated bot.

To update the Custom Issue Field, navigate to the Settings > Bots page.

Click the gear icon next to the Custom Bot you want to edit, then click the Duplicate option.

Once the Custom Bot has been duplicated, return to where that Custom Bot is listed on the page, then click the gear icon and select ‘Delete’.

Next, navigate to the new, duplicated Bot. Using the Conversation Flow tab, update the flow as needed by clicking ‘View’ next to the step you want to edit. This will bring up the ‘View Step’ page, where you can remove the stp using Custom Issue Fields for branching.

Once you’ve updated the Custom Bot, click ‘Save’ to confirm your changes, then click ‘Back to Bots’ to return to the Bots page. Do not publish the Bot yet.

You can now edit the Custom Issue Field used in branching. Once you’ve done this, navigate back to the newly duplicated Custom Bot and re-add the step that uses the Custom Issue Field for branching.

Last but not least, publish your new Bot and update any Automations to ensure appropriate New Issues are routed to the correct Custom Bot.