Technical Documentation

Sailthru

2 views 0

The Zephr Sailthru plugin allows you to create a Sailthru User upon registration of a Zephr User and trigger automated emails from the Sailthru Lifecycle Optimizer within Zephr Rules. These features allow a user to opt in to your Sailthru-based marketing seamlessly, whilst allowing you to trigger automated marketing flows wherever needed.

Enabling the Sailthru Plugin

The Sailthru integration can be turned on by enabling the plugin found under Settings > Plugins in your Zephr Admin Console. If you cannot see the plugin in this list, email support@zephr.com.

In order for Zephr to connect to Sailthru you need to provide the following details from Sailthru:

  • API Key
  • API Secret

Zephr-Sailthru API Configuration

If you wish to trigger events within the Sailthru Lifecycle Optimizer, you will also need to name the Sailthru event in the Sailthru Event field.

Enter these details into the corresponding fields under the heading Sailthru API details.

Zephr-Sailthru Mapping Configuration

Following this, you will need to add a JSON mapping under Sailthru Objects. This mapping allows you to map your User Schema Attributes to the Attributes stored against a user within a Sailthru List. For example, the following mapping would be used to map User Schema Attributes of First Name and Last Name:

{
    "first_name": "firstname",
    "last_name": "last-name"
}

Email is the key identifier between Sailthru and Zephr, so this doesn’t need to be added to your mapping.

When your details are correct, click Activate.

Once this has saved successfully, all users who are created within Zephr will be added as users within Sailthru.

Triggering Automated Marketing within a Zephr Rule

As part of our integration with Sailthru, we’ve created a way for your to trigger automated marketing, sent via Sailthru, from within a Zephr Rule. This feature uses the Sailthru Lifecycle Optimizser, and adds a new Sailthru option for you to drag and drop into the Zephr Canvas when creating a Rule.

In order for Sailthru to listen for Zephr triggers, you will first need to build a new flow within your Sailthru Lifecycle Optimizer with a custom event API, the event name, and the action to be done. Details on how to do this can be found in the Sailthru documentation page for the Lifecycle Optimizer.

Once set up, navigate to the Zephr rule where you would like to trigger the Lifecycle Optimizer from. On the left hand panel, you will see a drag and drop option for Sailthru, drag this into your Rule Canvas and choose your Event from the dropdown menu. Connect this node into your rule at the point you would like the email triggered.

Once you’re happy with your rule, click Save. Remember you will need to Publish your rule in order for it to go live on your site.