Navigation
Resources HubAll guides

Integrations

Connect your chatbot to WhatsApp, your website, SMS providers, and more.

Integrations connect your chatbot to the channels where your users actually are. Each chatbot can be connected to multiple channels simultaneously.

To access integrations: open a chatbot → click Integrations in the sidebar.

The Integrations page is organised into tabs, one per integration type.

WhatsApp Meta

Connect your chatbot to WhatsApp Business using the Meta (Facebook) Business Platform.

Prerequisites

  • A Meta Business Account
  • A WhatsApp Business Account with a verified phone number
  • A Meta system user access token with the required permissions

Setup

  1. Open the WhatsApp Meta tab.
  2. Click Connect (or Edit if already connected).
  3. Fill in:
    • Phone Number ID — The ID of the WhatsApp phone number to use
    • WhatsApp Business Account ID — Your WABA ID from Meta Business Manager
    • Access Token — A system user permanent access token from Meta
  4. Click Save.

Status Indicators

StatusMeaning
ConnectedThe integration is active; the bot can send and receive WhatsApp messages
PendingConfiguration is saved but verification is in progress
DisconnectedNot configured

Tip: After connecting, send a test message to the configured phone number to verify the integration is working.

Editing or Disconnecting

  • Click Edit to update credentials.
  • Click Delete to remove the WhatsApp integration.

Web Widget

Embed your chatbot on any website as a chat widget that appears in the corner of the page.

Configuration

  1. Open the Web Widget tab.
  2. Click Configure (or Edit).
  3. Customise:
    • Widget title — The name shown in the widget header
    • Greeting message — The first message users see when they open the widget
    • Primary colour — The widget's accent/brand colour
    • Widget position — Bottom-left or bottom-right
    • Conversation starters — Suggested prompts users can tap to begin a conversation
  4. Click Save.

Getting the Embed Code

After configuring the widget:

  1. Scroll to the Embed Code section.
  2. Copy the generated HTML snippet.
  3. Paste it into the <body> of your website's HTML — typically just before the closing </body> tag.

The widget will appear on every page where you embed the snippet.

Previewing the Widget

A live preview is shown on the right side of the configuration panel, updating as you change settings. You can switch between mobile and desktop preview modes.

REST API

Use the REST API integration to send and receive messages programmatically — for custom applications, backend services, or any system that can make HTTP requests.

Details Provided

The REST API tab shows:

  • API Base URL — The endpoint for sending messages to the chatbot
  • Webhook URL — Where the chatbot sends events back to your system
  • Authentication — Choose the auth type:
    • API Key — Pass an API key in the request header
    • Bearer Token — Pass a bearer token in the Authorization header
    • None — No authentication (not recommended for production)

Making a Request

Use the displayed base URL with your selected auth method. Example using curl with an API Key:

bash
curl -X POST https://your-api-url/chat \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello", "session_id": "user123"}'

The response includes the chatbot's reply and any session data.

Code Snippet

The Code Snippet integration provides a JavaScript snippet for embedding the chatbot on your website — similar to the Web Widget but with more control for developers.

Getting the Snippet

  1. Open the Code Snippet tab.
  2. Click Copy to copy the generated JavaScript code.
  3. Paste it into your website's HTML.

The snippet loads the chatbot widget asynchronously without affecting your page performance.

Africa's Talking (SMS)

Connect your chatbot to Africa's Talking to send and receive messages via SMS.

Setup

  1. Open the Africa's Talking tab.
  2. Click Configure.
  3. Enter:
    • API Key — Your Africa's Talking API key
    • Username — Your Africa's Talking username
    • Phone Number (Short Code) — The short code or sender ID to use
  4. Click Save.

Testing

After configuring, use the Test button to send a test SMS to verify the connection.

Beem (SMS)

Connect your chatbot to Beem Africa for SMS messaging.

Setup

  1. Open the Beem tab.
  2. Click Configure.
  3. Enter your Beem API credentials:
    • API Key
    • Secret Key
    • Sender Name
  4. Click Save.

Knowledge Bases (via Integrations)

The Knowledge Bases tab inside Integrations lets you attach or detach Knowledge Bases from this chatbot.

  1. Open the Knowledge Bases tab.
  2. You see a list of all Knowledge Bases in your workspace.
  3. Click Connect next to any KB to attach it to this chatbot.
  4. Click Disconnect to detach a KB.

For more on creating and managing Knowledge Bases, see Knowledge Bases.

Integration Status Reference

All integration cards show a status badge:

StatusMeaning
Connected / ReadyIntegration is active
PendingConfiguration saved; awaiting verification
DisconnectedNot configured
ErrorConfiguration exists but there is a problem (check credentials)
PreviousKnowledge BasesNextTeam & Settings