Skip to content

Chatforma

The Chatforma modules allow you to monitor new inputs, send messages, add, delete the users in a segment, and list bots, forms, users, messages, segments, dialogue users, and user messages in your Chatforma account.

Getting Started with Chatforma

Prerequisites

  • A Chatforma account

In order to use Chatforma with Ibexa Connect, it is necessary to have a Chatforma account. If you do not have one, you can create a Chatforma account at chatforma.com.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Chatforma to Ibexa Connect

To connect your Chatforma account to Ibexa Connect you need to obtain the API Key from your Chatforma account and insert it in the Create a connection dialog in the Ibexa Connect module.

  1. Log in to your Chatforma account.

  2. Click My Profile > Profile > Integration > Create a token.

  3. Enter a name for the token and click Create.

    61d5aa57a84a8.gif

  4. Copy the token to your clipboard.

    61d5aa5d3715c.png

  5. Go to Ibexa Connect and open the Chatforma module's Create a connection dialog.

    61d5aa5e8329e.gif

  6. In the Connection name field, enter a name for the connection.

  7. In the API Key field, enter the token copied in step 4, and click Continue.

The connection has been established.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative tohttps://api.pro.chatforma.com/public. For example: /v1/bots.

For the list of available endpoints, refer to the Chatforma API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we've already done that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Bots

The following API call returns all the bots from your Chatforma account:

URL:

/v1/bots

Method:

GET

61d5aa60dc75f.png

Matches of the search can be found in the module's Output under Bundle > Body.

In our example, 3 bots were returned:

61d5aa621d438.png