Copy and paste Modules across bots

Here, we’ll provide an explanation of how to copy Modules from one bot to another. This can be very useful when you have multiple bots that perform similar functions and you do not wish to manually recreate the same Module content over again.

We'll discuss the following below: 

Effect of copy and paste on connections

When using this feature, all Module connections will be copied over along with the Module content. This includes:

  • all connection types (response to, AI understands, custom variable, A/B testing, users filter, channel, Jinja2 template)
    connectiontypes.jpg
  • all action types (Set Variable, Webhook, Go to)
    action_types.jpg

Please note that there are a few connection-specific limitations you'll want to be aware of. Below, we'll address the expected behavior of these connections and how it affects your use of the copy and paste feature.

Important considerations regarding the effect on connections

There are some key points to keep in mind about the impact of copy and paste on these specific connection types:

AI connections

For copied AI-based connections to work, the same Intents that were activated in the origin bot must also be active in the trained AI model of the destination bot. As an example, imagine a connection in <md>Module A looks like this:

gotomoduleb.jpg

If the destination bot that <md>Module A is copied to does not also have the Intent "EN Common Smalltalk: No" activated and trained in the AI Manager, the connection will be inactive and appear as such: 

missingintent.jpg

Once the Intent is activated and the bot is trained, the AI connection will automatically update and work as expected.

activatedtrainedai.jpg

Outgoing Go to connections

If any Module containing an outgoing "Go to" connection is copied and pasted, but the destination Module for that connection is not copied and pasted with it, the connection will be deleted.

In the following bot configuration, the <md>Origin Module has outgoing "Go to" connections to the <md>Destination A and <md>Destination B Modules:

origdestcanvas.jpg

The <md>Origin Module content contains "Destination A" and "Destination B" Suggested Replies. Here are its connections:

destAB.jpg

Consider that the <md>Origin and <md>Destination A Modules are copied to another bot, but the <md>Destination B Module is not included in the same copied selection. In this case, the outgoing "Go to" connection to <md>Destination B will no longer exist in the <md>Origin Module copy once pasted in the destination bot:

nodestb.jpg

Note that in the example above, the <md>Origin Module still contains a Suggested Reply of "Destination B", but the "Go to" connection to the <md>Destination B Module has been removed. If the <md>Destination B Module were copied over at another time, this connection would have to be manually reestablished in the destination bot to function the same as in the origin bot.

How to copy and paste Modules across bots

Before you attempt to copy and paste Modules, remember to check that you've saved all previous changes made to your bot. In this section, we'll explain how to do the following:

Copy the Modules

First, we'll address how to copy the Modules from your origin bot. 

  1. Open the bot that contains the Modules youd like to replicate. Click the zoom-out symbol (-) in the Navigation bar at the top of the Certainly Platform until you can see all the Modules youd like to copy.  

  2. Then, click into the canvas near the outermost Module you want to copy and drag your cursor over all Modules you're replicating. If it's not possible to select all desired Modules at once due to the bot's layout, consider working in batches.

    Every Module touched by the dotted rectangle that appears will be selected. When you have selected all the desired Modules for this batch, release your mouse or touchpad button. All the selected Modules will now appear bolded. 
    copymodulesbold.jpg
    If youd like to make changes to your selection, youll need to repeat this step until you've chosen the correct Modules to copy. To remove your selection, simply click into any empty space on the canvas.

  3. Once the correct Modules are selected, use Ctrl+C (or ⌘ Command+C on a Mac) to copy them. A pop-up will appear indicating the Modules have been copied. This message will disappear automatically and requires no action. 
    copymodulespopup.jpg

Paste the Modules

These next steps show the process of pasting the Modules into your destination bot.

Please note: it is very important that you stay in the same browser tab, as Modules will not be copied from one tab to another.

  1. Remaining in the same browser tab, hover over “Conversation Builder” in the Navigation bar at the top of the platform. Then select “Bot List. Select the bot you’d like to copy the Modules to and open the bot by clicking on it.  

  2. Next, use Ctrl+V (or ⌘ Command+V on a Mac) to paste the Modules. The copied Modules should appear in this chatbot. These Modules can now be moved, edited, and connected to other Modules.  

  3. As always, remember to save your changes before exiting the Certainly Platform.

For your edits to be reflected in a live bot, you must also select Publish after saving.

Work in batches

If you're unable to select all the desired Modules at one time due to the layout of the bot, it's possible to work in batches. You can complete the copy and paste process as many times as needed to transfer the desired Modules to the destination bot. 

However, be aware that this may require significant edits in the destination bot to function in the same way as the origin bot. We recommend that you first refer to the section above in which we discuss some important points to consider.

Want to copy many Modules and/or Modules with many connections? It may be better to simply clone the bot and then delete the Modules you do not need.