Skip to content

Create Transfer Funds Task

This is document details steps in creating a sample banking bot. This bot is used in various use case scenarios presented in the How-Tos section of the developer documentation.

Prerequisites

  • You must have signed up with the XO Platform.
  • You must be aware of the basics of Bot building (refer to this link).
  • You must have created a simple bot. Click (here for an example).
  • You must have created a Banking Bot. Click (here for an example).

Bot Overview

The Bot we will be building will be performing the basic banking transactions like the following:

  • Get account balance based on the Account Number and Account Type entered by the user, as seen here.
  • Update accounts with the balance, as seen here.
  • Transfer a specified amount from the user account to a payee account.

Let us add the Transfer Funds task.

Transfer Funds Intent

  • The Transfer Funds task will prompt the user to enter Payee and Payer account number.
  • Next it would prompt for the amount to be transferred.
  • It will then make a service call to update the accounts appropriately.
  • The message indicating success or failure is displayed.
    • success failure message

Step 1: Dialog Task

We need to add an Intent Dialog as the first step in the Bot. Intent Dialog is the first step in the user-bot conversation flow.

  1. Open the Banking Bot with the two pre-configured tasks – Get Balance and Update Balance.
  2. Ensure that the Build tab is selected from the top menu.
  3. Navigate to the Conversational Skills -> Dialog Task page from the left menu.
  4. Click Create Dialog from the top right.
  5. Create Dialog screen will open.
  6. Enter the following details:
    • Intent Name – Enter the Intent name, this is the phrase that triggers the dialog. The intent name should be simple and not more than 3-4 words. For example, ‘Transfer Funds.’
    • Under More Options, you can add a description and other dialog-related details. Let’s retain the default settings.
    • You can also include utterances to train this intent.
    • Select Try Conversation Driven Dialog Builder option.
  7. Click Proceed.
  8. Property Panel for User Intent will be displayed. We will retain the default properties.
  9. Close the User Intent Property Panel.

Step 2: Entity nodes

Entity Node is typically used to gather information from the user.

Here we will be using it to capture the user input for the Payee and Payer Account Number and amount to be transferred.

  1. Click the + below to the User Intent node.
  2. Select the Entity option.
  3. Click the + New entity .
  4. Property Panel for the Entity Node is displayed. If not click on the newly added entity node to open.
  5. Enter the following details:
    • Name: PayerAccount
    • Display Name: Payer Account
    • Type: Number
    • User Prompts: Enter the following text:
      Enter the Account from where you want to transfer funds.
  6. Close the PayerAccount Entity Property Panel.
  7. Repeat the above steps to add another entity with the following details:
    • Name: PayeeAccount
    • Display Name: Payee Account
    • Type: Number
    • User Prompts: Enter the following text
      Enter the Account to which you want to transfer funds.
  8. Close the PayeeAccount Entity Property Panel.
  9. Repeat the above steps to add another entity with the following details:
    • Name: AmountToTransfer
    • Display Name: Amount To Transfer
    • Type: Number
    • User Prompts: Enter the following text and hit enter to save: Enter the amount to transfer.
  10. Close the Amount Entity Property Panel.

The next steps would update the balance in both the Payer and Payee accounts. Since we already have Update Balance task, we will see how to run it from the current task.

Step 3: Run Dialog Task

Predefined dialog tasks can be triggered from within another task with the steps below:

  1. Click the + below to the Amount Entity node.
  2. Select Dialog Task.
  3. From the given task list, select the required task – UpdateBalance.
  4. Property Panel for the Dialog Node is displayed. If not click on the newly added dialog node to open.
  5. Navigate to the Instance Properties tab and enter the following details:
  6. Entity Pre-Assignments section – these are the entity values required by the Dialog Task if they are not populated here the user will be prompted to enter the same. Since we have already collected the information through the entities defined in the previous step we will be passing those user-entered values to the UpdateBalance task
    • AccountType: savings.
    • AccountNumber: context.entities.PayerAccount.
    • Amount: context.entities.Amount.
    • TransactionType: Debit (payer account needs to be deducted of the transferred amount).
      • update balance intent
  7. Close the UpdateBalance Dialog Properties panel.
  8. Repeat the same steps to Update the Payee Account with the following values in the Entity Pre-Assignments section:
    • AccountType: savings
    • AccountNumber: context.entities.PayeeAccount
    • Amount: context.entities.Amount
    • TransactionType: Credit
  9. Close the UpdateBalance Dialog Properties panel.

Step 4: Message Node

A Message Node is used to display a message from the Bot to the user. Here we will be using the Message node to show the balance.

  1. Click the + below the UpdateBalance [2] Service node.
  2. Select Message and click the ‘+ New message'.
  3. Property Panel for the Message Node is displayed. If not click on the newly added dialog node to open.
  4. Enter the following details:
    • Name: FinalMessage.
    • Display Name: Final Message
    • Bot Responses: The amount {{context.entities.AmountToTransfer}} has been transferred from {{context.entities.PayerAccount}} to {{context.entities.PayeeAccount}}
  5. On the Bot Response Property Panel, open the connections tab by clicking the ‘Connections‘ icon.
  6. Change the Default connection from ‘Not Connected‘ to ‘End of Dialog‘.
  7. Click Save.
  8. Close the Property Panel.

Test

To test the Dialog task, you can use the ‘Talk to bot’ at the bottom right corner.
Enter the utterance (intent name): “Transfer Funds."

Follow the Bot instructions and enter the following values;

  • Payer Account – 02929664;
  • Payee Account – 44994354;
  • Transfer Amount – 200