General Information

Chatfuel dashboard uses HTTP API to create/modify your bots and pages.

Base URL for all the API methods:

All methods require an authorization token. You need to add this HTTP header to all your requests:

Authorization: Bearer {token}

This article only covers some of the API methods we currently have. Feel free to ask our team if you need any additional methods that might be useful for you, we'll be super happy to understand your needs and provide more useful API methods in the future!

However, keep in mind that this API is designed primarily for internal use and is subject to change without prior notice.

How to Get a Token

  1. Click on your profile photo

  2. Click Dashboard API Token

  3. Click Generate Token button in the pop-up window

Keep in mind that you won't be able to retrieve a token again after you've generated it. You will only be able to revoke your current token and generate a new one instead. Therefore, make sure to write down your token and keep it safe.

Retrieving an Existing Bot ID

If you want to use this API to modify your existing bots, you will want to get their bot IDs. In order to do it you should open your bot in the Chatfuel dashboard and check the URL in your browser. You will find your Bot ID here:

Create an Empty Bot

In order to create a new bot you should send a POST request:

POST /bots
    "title": "Bot Title"

As a response you will receive an object describing your new bot:

    "success": true,
    "result": {
        "id": "{botId}",

Clone a Bot

Even though this method is called "clone" a bot, it's closer to "copy to another" bot as it doesn't create a new cloned bot. You need to create a target bot manually and then copy the content from the original bot to the target.

POST /bots/{targetBotId}/clone_from/{originalBotId}

POST /bots/{botId}/invite/{role}

Currently supported roles: ADMIN, EDITOR, MARKETER, OPERATOR, VIEWER.
As a response to this request, you will receive a description of your invite link:

    "success": true,
    "result": {
        "token": "{token}",

You should use the token field from the response to get your invite link:{token}

Disconnect a Chatfuel Bot from a Page

This method only works for pages that have a connected Chatfuel bot. There's no way for Chatfuel to connect/disconnect bots from other systems/platforms. This method should not be called on pages without a Chatfuel bot.

POST /pages/{pageId}/unbind

Connect a Chatfuel Bot to a Page

Keep in mind that you have to be an Admin of the page (Facebook Admin, not Chatfuel Admin) in order for this method to work.

POST /pages/{pageId}/bind/{botId}

Did this answer your question?