Configuring Actions in the bot builder

We have recently refreshed our branding across our offerings and changed the names of our pricing plans. If you have signed up before Aug 9, 2021, please click Previous plans to view your applicable plans.
We assure you that this change will not impact your product experience, and no action is required on your part.

The bot builder allows you to set up dialogs and connect them to another, anywhere in the workflow. For every dialog you create, you can configure an action to be executed before or after that dialog in a conversation. The bot builder allows you to trigger actions before or after a dialog to execute certain bot flow events.

Note: Now you can add actions in between dialogs at any given time.

For example, suppose you are triggering an API as part of a dialog to create a ticket in Freshdesk and store the ticket ID as part of API parameters. In that case, you can use the Trigger API action to fetch the ticket ID from the API parameters and show it to the customer in the bot conversation. 

TABLE OF CONTENTS

• 1. Dynamic Actions:
  • 1.1 Trigger API
  • 1.2 Trigger JS Function
  • 1.3 Set Property
  • 1.4 Transfer to Answers
• 2. Freshchat actions
  • 2.1 Assign to Agent
• 3. Conversation actions
  • 3.1 Start New Conversation
  • 3.2 Stop Conversation
  • 3.3 Resolve Conversation
• 4. Widget actions
  • 4.1 Open URL
  • 4.2 Auto open chat widget
  • 4.3 Show Proactive Message
  • 4.4 Event on Widget Open
  • 4.5 Add a delay in response
  • 4.6 Hide widget
  • 4.7 Minimize widget
  • 4.8 Send private customer message

1. Dynamic Actions:

1.1 Trigger API

This action will allow you to fetch, update, or post data remotely. You can use it to talk to your third-party applications or internal systems through APIs. When you choose this action, the bot builder will ask you to select an API call from a list. You can create these API calls under Flows > Configure > API Library of that bot. Once created, you can find them on the list to choose to trigger this remote request. 

Example: Let’s say your customer is interacting with your bot for billing related questions and is looking for the payment status. You’ll need to fetch the payment status from your internal billing software to give an update. You can set up the necessary APIs under the API library and use these API calls to fetch the required updates and then use this action in the conversation as a Message to display to your customer.

Learn more about configuring APIs here.

1.2 Trigger JS Function

You can use this action to invoke a JS function to trigger an external action in the bot flow.

Example: Let us say you want to give your customers an option to call support from within your app where you’ve deployed the bot. You can set up the flow to have a button that will trigger a JS function. The JS function will then trigger the call action on their mobiles or web apps. 

Learn more about setting up JS functions here.

1.3 Set Property

This action will enable you to add or update properties either for the conversation or for the user. You can later use these properties in other areas of the bot flow as well.

Example: Let us say you ask the customer for the “type” of the issue they are facing. You can save the type on the conversation level. This value is displayed in the bot conversational log or used in APIs to push the value to another application, such as Freshdesk, where a ticker can be created where this "type" is stored as the ticket type.

Learn more about using the set property action here.

1.4 Transfer to Answers

This action lets you transfer the control of the bot to the Answers module. When you trigger this action, the bot would trigger the answer engine, look for an appropriate response if available. If not, the bot will trigger the fallback response.

Learn more about setting up intents for your bot here.

2. Freshchat actions

2.1 Assign to Agent

This action will enable you to transfer the bot conversation over to a live agent.

Example: If your customer’s issue requires your agent’s intervention, you can transfer the conversation to an agent for human support. This will ensure that your customer’s issues get resolved to their satisfaction.

3. Conversation actions

3.1 Start New Conversation

This action allows you to close an existing conversation with the user and open a new conversation. On executing the action, the Hello flow of the bot will get.

3.2 Stop Conversation

By default, when no conditions are configured, the bot dialogs are executed in a sequential flow. You can use this action to stop the sequential flow of dialogs.

3.3 Resolve Conversation

This action will convert the ongoing conversation to a resolved status. You can use this action if your customer has reached a logical ending of their bot flow. 

4. Widget actions

Please write to freshbots-support@freshworks.com if you have any more questions; we’ll be happy to help you.