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
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
Action | What does it do? |
4.1 Open URL | Redirects your customer to a different URL, allowing you to specify the URL and a timeframe for the redirection |
4.2 Auto open chat widget | Opens the chat widget even without your customer clicking. You can specify the time frame after which the widget will automatically open. |
4.3 Show Proactive Message | Displays a dialog message as a pop-up when the widget is closed. You can specify the timeframe after which the message will be displayed |
4.4 Event on Widget Open | Sends a private message to you (visible as part of the conversation), letting you know if the widget was clicked on and opened by the customer |
4.5 Add a delay in response | Adds a delay after a bot response. You can choose to set a timeframe after which the bot will resume. The maximum delay that you can set up is three seconds. |
4.6 Hide widget | Hides the widget on the page. You can also choose to specify a time frame after which the widget will get hidden. |
4.7 Minimize widget | Minimizes an open widget and displays the bot icon on the page. You can specify a time duration after which the widget will get minimized. |
4.8 Send private customer message | Sends a message to the bot as if the customer sent it. rather than the bot |
Please write to [email protected] if you have any more questions; we’ll be happy to help you.