Plugin Flow Builder

---

For more information, refer to GitHub.

---

What Does This Plugin Do?

Botonic Plugin Flow Builder is one of the available plugins for Botonic.

Flow Builder is a no-code, drag-and-drop chatbot builder that makes the process of creating and editing chatbot journeys faster and more intuitive. From Hubtype we offer a suite of tools and features that let you build, test and deploy both automated and agent-based journeys at scale. This plugin allows you to connect to our Flow Builder.

Features

• Support for a wide variety of content types, including buttons, text, carousels, images, videos, and more.

• Custom functions to allow dynamic bot behavior, as for example checking the queue status or determine the channel (Whatsapp, Webchat, ...) from which the user is writing.

• Seamless transfer to a human agent.

• Artificial intelligence-based detection of keywords and user intent.

Advantages

• Ease of use: Flow builders are designed to be user-friendly and intuitive, allowing even non-technical users to create and edit chatbot flows with ease.

• Time-saving: With a flow builder, you can quickly create and edit chatbot flows using drag-and-drop functionality, saving you time and effort compared to manually coding each interaction.

• Visual representation: Flow builders provide a visual representation of your chatbot flow, allowing you to easily see the overall structure and make adjustments as needed.

• Flexibility: Flow builders offer a range of customization options, allowing you to create chatbot flows tailored to your specific needs and use cases.

Setup

Create an account at Hubtype

1. Create an account at https://www.hubtype.com.

2. Once you have deployed your bots, in the Bots section you can access the flow builder by clicking on any of your bots and in the button that says:

Install the Plugin

1. Install the plugin in your bot's project by running:

npm install @botonic/plugin-flow-builder

Use

Configuring the bot

1. Add the following code to your plugins.js file:

import * as hubtypeFlowBuilder from '@botonic/plugin-flow-builder'

const flowBuilderOptions = {
  flowUrl: 'HUBTYPE_FLOW_BUILDER_URL',
  getAccessToken: () => 'HUBTYPE_FLOW_BUILDER_ACCESS_TOKEN',
  getLocale: () => 'YOUR_LOCALE',
}

export const plugins = [
  {
    id: 'hubtypeFlowBuilder',
    resolve: hubtypeFlowBuilder,
    options: flowBuilderOptions,
  },
]

By doing this, we are passing configuration parameters to the bot. This way we can pass parameters to the Plugin from outside. This gives us more flexibility when configuring the plugin.

Below are the parameters that we can pass to the plugin:

• flowUrl: This is the URL where the Flow is located. The bot will automatically collect this URL, so in most cases, we don't have to pass it. It is used in cases where the Flow URL is in a testing environment.

• flow: In some situations, we may want to test a flow locally instead of using the Flow Builder service. To do this, we can define the flow and its corresponding tree of nodes in a JSON file and pass it to our plugin through this variable. By doing so, we can run and test our flow locally without relying on the external service.

• customFunctions: We are able to pass custom functions to the plugin by defining them in our code and then passing them as parameters. This allows us to extend the functionality of the plugin beyond its default capabilities and execute custom logic that is tailored to our specific needs. We can add custom functions in the frontend of the Flow Builder and pass them to the plugin through this variable.

• getLocale: We can pass an array of locales to the plugin to specify which language our bot will use.

• getAccessToken: When our bot is deployed in Hubtype, the plugin will automatically retrieve the access token. However, when testing our bot locally, we need to pass the access token as a variable.

2. Modify the routes.ts file, where routes map user inputs to actions which are in fact React Components:

import { Input, Session } from '@botonic/core'
import FlowBuilderAction from '@botonic/plugin-flow-builder/lib/esm/action'

type RouteRequest = { input: Input; session: Session }
export function routes(request: RouteRequest) {
  return [
    {
      path: 'hubtype-flow-builder',
      type: /.*/,
      payload: /.*/,
      action: FlowBuilderAction,
    },
  ]
}

For personalized behavior, create an action in your bot. For other cases, let the plugin handle all actions.