Docs

Loops

Add a bot to Loops using the official integration.

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

Setup

Step 1: Install the integration in Botpress

First, install the integration in Botpress:
In Botpress Studio, select Explore Hub in the upper-right corner.
Search for the Loops integration, then select Install Integration.

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.
Copy the webhook URL.

Step 2: Configure the webhook in Loops

Next, configure your Botpress webhook in Loops:

Log in to your Loops account.

Go to Settings > Webhook.

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

Copy the generated Signing Secret.

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:

In your Loops account, go to Settings > API.

Select Generate key.

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

Cards

Send Transactional Email

Send a transactional email to a client

inputobject

Triggers

Email Clicked

Sent when a link in a campaign or loop email is clicked. This event is not available for transactional emails because link clicks are not tracked in transactional emails.

payloadobject

Email Delivered

Sent when an email is delivered to its recipient.

payloadobject

Email Hard Bounced

Sent when an email hard bounces. Hard bounces are persistent email delivery failures, for example a mailbox that doesn't exist. The email will not be delivered.

payloadobject

Email Opened

Sent when a campaign or loop email is opened. This event is not available for transactional emails because email opens are not tracked for transactional emails.

payloadobject

Email Soft Bounced

Sent when an email soft bounces. Soft bounces are temporary email delivery failures, for example a connection timing out. Soft bounces are retried multiple times and some times the email is delivered.

payloadobject

Email Spam Reported

Sent when a recipient reports your email as spam.

payloadobject

Email Unsubscribed

Sent when a recipient unsubscribes via the unsubscribe link in an email. This event is not available for transactional emails because unsubscribe links are not included or required for transactional emails.

payloadobject