Skip to content

Typebot

The Typebot modules allow you to monitor the chats and retrieve the chatbot chat forms in your Typebot account.

Getting Started with Typebot

Prerequisites

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

Connecting Typebot to Ibexa Connect

  1. Log in to your Typebot account.

  2. Navigate to Account settings, then copy your email and the API token provided.

    type_bot_2.png

  3. Go to Ibexa Connect and open the Typebot module's Create a connection dialog.

  4. In the Email and Password fields, enter your Typebot's account email and API token.

    type_bot_1.png

  5. Click Save.

You have established the connection

The connection has been established.

Chats

Watch New Chat

Triggers when a new chat is started in the specified Typebot.

Note

You do not have to add the webhooks in the Typebot as it is automatically done for you once you add and save an instant trigger module to your scenario.

Webhook Name Enter a name for the webhook.
Typebot ID Select or map the Typebot ID whose result response format you want to retrieve.
Stop Question Index Enter (map) the total number of questions from where you want the webhook to be executed. For example, if set to 2, then the webhook will be triggered when the second question is answered.If left blank, the webhook is triggered after the form is completed.

Get a Chatbot Chat Form

Gets an example of the result of the response format.

Typebot ID Select or map the Typebot ID whose result response format you want to retrieve.
Stop Question Index Enter (map) the total number of questions that the request should return. For example, if set to 2, then the scenario returns only two questions even though the Typebot could contain more questions.

Other

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://europe-west3-typebot.cloudfunctions.net For example: /getResultExample

For the list of available endpoints, please contact the Ibexa Connect Support team. https://docs.crisp.chat/

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 already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - Get Example Results

The following API call returns all the example results from your Typebot account:

URL:

/v1/getResultExample

Method:

GET

61f27d49aa4cb.png

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

In our example, 3 questions were returned:

61f27d4ace1b7.png