BotKit SDK Tutorial — Blue Prism Integration

This tutorial describes how to integrate Kore.ai bots with Blue Prism RPA services using the BotKit SDK. Conversation flows collect user intent and entities, then pass them to Blue Prism to automate backend business processes.

---

Integration Architecture

1. A dialog flow hits a Webhook node, sending the context (intent, entities) to the BotKit SDK.
2. BotKit invokes the Blue Prism Connector with the request.
3. The connector triggers the RPA process on Blue Prism and receives the response.
4. The response is stored in the dialog context as ResponseFromBluePrism and used in subsequent dialog nodes.

---

Prerequisites

• Sign up for Blue Prism and define your automation processes.
• Download the Kore.ai BotKit SDK and update the integration details in BluePrismConnector.js.
• Enable RPA services on Blue Prism to accept external requests.

---

Integration Steps

1. Create a Dialog task and build the conversation flow for your use case.
2. Identify Webhook locations — places in the flow that need to invoke Blue Prism RPA services.
3. Build the BluePrismRequest object using Script nodes before each Webhook node.
4. Add Webhook nodes at those locations. See Webhook Node.
5. Review the request payload the Platform sends to BotKit.
6. Use the response (BluePrismResponse) in the dialog context for transitions and user responses.

---

Request Object

Populate the following structure in a Script node before the Webhook node:

var bluePrismRequest = {
  "url":       "<service endpoint for the RPA process>",
  "operation": "<RPA Process Name>",
  "attributes": {
    "UserInput1": "<input1>",
    "UserInput2": "<input2>"
  }
};

Parameters:

Parameter	Type	Description
operation	string	Name of the RPA process on Blue Prism
url	URL	Service endpoint of the RPA process
attributes	Blue Prism data types	Input data required to run the process

---

Response Handling

Blue Prism’s response is stored in the dialog context at ResponseFromBluePrism.

Sync mode — BotKit receives the response directly from the RPA service and passes it to the Platform.

Async mode — Blue Prism calls back to BotKit at:

http://<host>/sdk/blueprismConnector/<requestId>

• <host> — Your BotKit server hostname (for example, platform.kore.ai).
• <requestId> — The unique request ID associated with the Webhook node invocation.

After the Webhook node completes, the dialog resumes from that point. Use context.ResponseFromBluePrism in transitions, entity extraction, and user response composition.

---