Botium Connector for Omilia

This is a Botium connector for testing your Omilia chatbot.

Did you read the Botium in a Nutshell articles ? Be warned, without prior knowledge of Botium you won't be able to properly use this library!

How it works ?

Botium uses a Omilia Chat API to connect to your chatbot.

It can be used as any other Botium connector with all Botium Stack components:

• Botium CLI
• Botium Bindings
• Botium Box

Requirements

• Node.js and NPM
• a Omilia chatbot
• a project directory on your workstation to hold test cases and Botium configuration

Install Botium and Omilia Webhook Connector

When using Botium CLI:

> npm install -g botium-cli
> npm install -g botium-connector-omilia
> botium-cli init
> botium-cli run

When using Botium Bindings:

> npm install -g botium-bindings
> npm install -g botium-connector-omilia
> botium-bindings init mocha
> npm install && npm run mocha

When using Botium Box:

Already integrated into Botium Box, no setup required

Connecting your Omilia chatbot to Botium

Omilia API key, and chatbot region is required to connect your Botium instance to your Omilia chatbot.

Open the file botium.json in your working directory and add the Webhook settings.

{
  "botium": {
    "Capabilities": {
      "PROJECTNAME": "<whatever>",
      "CONTAINERMODE": "omilia",
      "OMILIA_APIKEY": "...",
      "OMILIA_REGION": "..."
    }
  }
}

Botium setup is ready, you can begin to write your BotiumScript files.

Supported Capabilities

Set the capability CONTAINERMODE to omilia to activate this connector.

OMILIA_APIKEY

Omilia API key

OMILIA_REGION

Omilia region

OMILIA_USER

Omilia user info, following this format:

{
   "user_id": "string",
   "email": "string",
   "first_name": "string",
   "last_name": "string",
   "fullname": "string",
   "phone_number": "string",
   "username": "string"
}

OMILIA_SEMANTICS

Contains key-value string pairs with semantic information related to the request.

OMILIA_INPUT_FIELDS

Contains input fields to be passed to the Omilia DiaManT