Using custom parameters in IBM RPA SaaS

Learn how to send custom parameters to an IBM RPA chatbot by using API calls. This procedure refers to the IBM RPA SaaS offering.

About this task

You have the syntax below to send customized parameters:

https://<REGION>bot.wdgautomation.com/integration/<BOTHANDLE>?sampleparam=<SAMPLEPARAM>&?username=<USERNAME>&?userid=<USERID>

where:

sampleparam=<SAMPLEPARAM>
The customized parameters can be more than one. Custom parameters can be every parameter you send by the syntax, except username and userid. You can get the parameter data in your chatbot script using the ${varName.From.Properties} variable.

username=<USERNAME>
The user name. You can get the username data in your chatbot script using the ${varName.From.Name} variable.

userid=<USERID>
The user identifier. You can get the user identifier data in your chatbot script using the ${varName.From.Id} variable.

The varName variable has the Chat Data type and can be getting from the output parameter of the Connect to Chatbot command.

Before you begin

Take the following actions:

  1. Request a chatbot instance. See Requesting a chatbot instance for instructions.
  2. Create a chat mapping for your IBM RPA chatbot script. See Creating a chat mapping for instructions.

Procedure

Follow the procedures to set the customized parameters. Replace the labels with the data you want to send.

  1. Paste the following syntax in your browser address bar:

    https://<REGION>bot.wdgautomation.com/integration/<BOTHANDLE>?sampleparam=<SAMPLEPARAM>&?username=<USERNAME>&?userid=<USERID>

  2. In <REGION>, enter your tenant region.

  3. In <BOTHANDLE>, enter the Bot Handle that you have used to create your chatbot instance.

  4. Optional: In sampleparam, enter the name of the customized parameter.

    • Optional: In <SAMPLEPARAM>, enter the value of the customized parameter.

  5. Optional: In <USERNAME>, enter the user name.

  6. Optional: In <USERID>, enter the user identifier.