Loops

Add a bot to Loops using the official integration.

Open in Hubv

The official Loops integration allows your bot to send emails to your customers via Loops.

Setup

You will need:

• A published bot
• A Loops account

Step 1: Install the integration in Botpress

First, install the integration in Botpress:

1. In Botpress Studio, select Explore Hub in the upper-right corner.
2. Search for the Loops integration, then select Install Integration.
3. In the Configuration menu, you should see two fields: API Key and Webhook Signing Secret. Leave these blank for now—you’ll come back to them after configuring the integration in Loops.
4. Copy the webhook URL.

Step 2: Configure the webhook in Loops

Next, configure your Botpress webhook in Loops:

1. Log in to your Loops account.

2. Go to Settings > Webhook.

3. Paste your integration’s webhook URL into the Endpoint URL field, then select Update URL.

4. Copy the generated Signing Secret.

5. Paste it into the integration’s Webhook Signing Secret field in Botpress.

Step 3: Create a Loops API key

Then, create your Loops API key:

1. In your Loops account, go to Settings > API.

2. Select Generate key.

3. Copy the generated key, then paste it into the integration’s API Key field in Botpress.

Your Loops integration is ready. You can use the integration’s Cards and Triggers to interact with your customer emails.

---

Cards

Here’s a reference for all Cards available with the integration:

Send Transactional Email

input · object

Show child attributes

dataVariables · array · required

Show array item properties

key · string · required

value · string · required

fileData · array

Show array item properties

filename · string · required

contentType · string · required

data · string · required

output · object

This Card has no output.

Triggers

Here’s a reference for all Triggers available with the integration:

You can access data returned from any of these Triggers by reading event.payload after the Trigger fires.

Email Clicked

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop

Email Delivered

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop, transactional

Email Hard Bounced

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop, transactional

Email Opened

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop

Email Soft Bounced

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop, transactional

Email Spam Reported

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop, transactional

Email Unsubscribed

payload · object

Show child attributes

sourceType · enum<string> · required

Available options: campaign, loop