Skip to content

Happyfox Chat

The HappyFox Chat modules allow you to monitor the offline, missed and finished chats in your HappyFox Chat account.

Getting Started with HappyFox Chat

Prerequisites

Note

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

Connecting HappyFox Chat to Ibexa Connect

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

1. Log in to your HappyFox Chat account.

2. Click the top menu drop-down >Apps > REST API > Manage.

61f270089e4a2.gif

3. Copy the API key to your clipboard.

61f270121a787.png

4. Go to Ibexa Connect and open the Happyfox Chat module's Create a connection dialog.

61f270133c1cb.gif

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

6. In the API Token field, enter the token copied in step 3, and click Continue.

The connection has been established.

Chats

Note

Happyfox Chat allows only one instant webhook at a time, to watch all types of events, set up a custom webhook module.

Watch New Finished or Missed Chat

Triggers when a chat conversation ends or no agents pick up an incoming chat request.

Webhook Name Enter a name for the webhook.

Messages

Watch New Offline Message

Triggers when a visitor leaves a message when all agents are offline.

Webhook Name Enter a name for the webhook.

See Setting Up HappyFox Chat Webhooks to add webhook in your HappyFox Chat account.

Other

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://api.happyfoxchat.com For example: /v1/profiles

For the list of available endpoints, refer to the Happyfox Chat 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 already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Profiles

The following API call returns all the profiles from your HappyFox Chat account:

URL: /v1/profiles

Method: GET

61f2701584b2a.png

Matches of the search can be found in the module's Output under Bundle > Body > data. In our example, 9 profiles were returned:

61f27016a7734.png

Setting Up HappyFox Chat Webhooks

1. In your Ibexa Connect account, open any Watch module, establish a connection, click Save and copy the URL address to your clipboard. Click OK and save the trigger.

61f27017d5f2e.gif

2. Log in to your HappyFox Chat account.

3. Click Apps > Webhooks.

61f2701b1a7cb.gif

4. Add the URL address copied in step 1 and click Save.

61f2701e78b39.png

You have successfully added the webhook.

61f2701f5730a.png

61f2701b1a7cb.gif

4. Add the URL address copied in step 1 and click Save.

61f2701e78b39.png

You have successfully added the webhook.

61f2701f5730a.png