Botium Connector for Facebook Messenger Bots

This is a Botium connector for testing your Facebook Messenger Bots.

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 the Unofficial Facebook Chat API to connect to your chatbot on Facebook Messenger.

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 Facebook Messenger Bot
• a project directory on your workstation to hold test cases and Botium configuration

Install Botium and Facebook Messenger Bots Connector

When using Botium CLI:

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

When using Botium Bindings:

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

When using Botium Box:

Already integrated into Botium Box, no setup required

Connecting your Facebook bot to Botium

{
  "botium": {
    "Capabilities": {
      "PROJECTNAME": "<whatever>",
      "CONTAINERMODE": "fbmessengerbots",
      "FB_PAGEID": "...",
      "FB_USER": "...",
      "FB_PASSWORD": "..."      
    }
  }
}

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

Supported Capabilities

Set the capability CONTAINERMODE to fbmessengerbots to activate this connector.

FB_PAGEID

Facebook page id

FB_USER

Faceboook username (email)

FB_PASSWORD

Facebook password