Viral Loops

The Viral Loops modules allow you to watch milestones, register new user, and list the participants of your campaigns in your Viral Loops account.

Getting Started with Viral Loops

Prerequisites

  • A Viral Loops account

In order to use Viral Loops with Make, it is necessary to have a Viral Loops account. You can create a Viral Loops account at viral-loops.com.

Note

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

Connecting Viral Loops to Make

To connect your Viral Loops account to Make you need to obtain the API Token from your Viral Loops account and insert it in the Create a connection dialog in the Make module.

  1. Log in to your Viral Loops account.

  2. Open the campaign for which you want to establish a connection and click Edit > Installation.

    61f27dbc341d8.gif
  3. Copy the API Token to your clipboard.

    61f27dbe9101d.png
  4. Go to Make and open the Viral Loops module's Create a connection dialog.

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

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

The connection has been established.

Milestone Campaigns

Triggers when someone joins our campaign.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Viral Loops account.

See the Connecting to Viral Loops Webhook using Make to add the webhook to your Viral Loops account.

Triggers when you redeem a reward via your campaign dashboard.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Viral Loops account.

See the Connecting to Viral Loops Webhook using Make to add the webhook to your Viral Loops account.

Triggers when someone reaches a milestone.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Viral Loops account.

See the Connecting to Viral Loops Webhook using Make to add the webhook to your Viral Loops account.

Registers a new user.

Connection

Establish a connection to your Viral Loops account.

Email

Enter the email address of the user.

First Name

Enter the user's first name.

Last Name

Enter the user's last name.

Extra Data

Add the extra data:

Name

Enter the custom field name. For example, Company.

Value

Enter the field value. For example, company name.

Referral Source

Enter the details from where you received the source details. For example, Webinar.

Retrieves information about your participants.

Connection

Establish a connection to your Viral Loops account.

Limit

Set the maximum number of participants Make should return during one scenario execution cycle.

Other

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Viral Loops account.

URL

Enter a path relative to https://api.viral-loops.com/api/. For example: v2/participant_data

Note

For the list of available endpoints, refer to the Viral Loops 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.

The following API call returns the participants from your Viral Loops account:

URL:

v2/participant_data

Method:

GET

61f27dc1eb249.png

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

In our example, 3 participants were returned:

61f27dc30821a.png

Connecting Viral Loops Webhook using Make

  1. Open any Watch module, establish a connection as mentioned in the respective modules, Click OK, and copy the URL address to your clipboard. Save the trigger.

    61f27dc44ebaa.gif
  2. Log in to your Viral Loops account. Go to the Campaign in which you want to add the webhook.

  3. Click Edit > Integration > Enable the Webhook.

  4. Enable the endpoint, in the Endpoint URL field, enter the URL address copied in step 1, and click Save.

    61f27dc6e7323.gif

The webhook is added successfully.