Skip to main content

Postscript integration

Swym-Postscript Integration

Updated over a week ago

Integrating Wishlist Plus with Postscript allows you to send personalized retargeting and engagement marketing campaigns to your customers via SMS. This guide walks you through the steps to successfully set up and use this integration.

Prerequisites
Before you begin, ensure the following:
You’re on the Starter plan or higher on Wishlist Plus.
You have an active Postscript account​

Steps to Connect Wishlist Plus with Postscript

Step 1: Open the Integrations Tab in Wishlist Plus

Navigate to the Wishlist Plus app in your Shopify admin and click on the “Integrations” tab.

Step 2: Connect to Postscript

Find the Postscript tile and click “Connect.”

Step 3: Manage Your Connection

Once connected, you will be redirected to the Postscript page where you need to enter the Postscript Private API key and Keyword (Keyword will be used to add subscribers to Postscript).

Note: The Keyword entered here should match the keyword that you created on Postscript.

Where to find the Postscript Private API key?

On the homepage of your Postscript account, use the left-hand menu to click on the “Settings” button (the gear icon). In the additional drop-down menu, click on the “API” tab.

Now, click on the Create Security Key Pair button. This will create a Public and Private key pair with the Private key pair hidden by default. Click on Show button to see the private API Key.

Note: You need to provide the Private API key (and not the public API key) to Swym.

How to create a Keyword on Postscript? Refer to this article.

Step 4: Enable Communication Channels

Since Postscript supports only SMS channel, you will notice that SMS channel is enabled by default. You do not need to make any further changes. You can proceed to click the Save button.

That is all! Your Wishlist Plus is now successfully connected to Postscript! Wishlist Plus from now on will send event triggers to Postscript which you can use to build Automations using the Postscript Flow Builder.

Step 5: Send Test Events to Postscript

You can test the integration by sending triggers to Postscript. To send test triggers, follow the below instructions:

  1. Go to the “Test Events & Triggers” section in the Postscript page.

  2. Select the event(s) you want to test.

  3. Enter a phone number.

  4. Click “Send Test Triggers.”

Here is a list of events supported via Postscript:

Swym Wishlist Plus App Events:

Event Name

When this event is triggered

Wishlist Reminder

Reminder about items in a shopper’s wishlist

Price Drop alert

Product on a wishlist goes on sale

Low Stock alert

Product on a wishlist is running low on stock

Back in Stock alert

Product on a wishlist is restocked

Swym Back in Stock Alerts App Events

Event Name

When this event is triggered

Back in Stock Acknowledgement

Shopper subscribes to be notified when a product is back in stock

Restock Alert

Product a shopper requested a back-in-stock alert for is restocked

Restock Reminder

Follow-up alert (usually ~24 hrs after the first restock alert, configurable)

Note: Save For Later reminder and Share Wishlist events are not supported.

Now, head over to Postscript > Messaging > Automations and create a new automation. You should now see all the triggers you triggered under the Triggers list.

You can now build Automations on Postscript that trigger when the desired Swym event occurs. You can also personalise the SMS templates by using the metadata we send along with the event. Below is the list of metadata that we send for each of the Swym event:

  • Metadata available in the Wishlist Reminder event:

Custom event name: Swym-addedtowishlist

Variable

Details

productCount

Number of products in the current wishlist reminder event.

imageURL

URL of the first product’s image

variantInfo

Variant info or name if the product has any variants

productCurrentPrice

First product’s price

productBrand

Brand name of the first product (if any)

productQuantity

Number of products wishlisted

productName

Name of the first product added to wishlist

productCategory

Category of the first product

productURL

URL directing to the PDP of the first product

Note: Wishlist reminder is a multi-product event - ie, a shopper might have added more than one product in their wishlist. Since, Postscript doesn't support sending the list of products in the event payload, only the details of the first product in the shoppers wishlist is sent.

  • Metadata available in the Low Stock Alert

Custom event name: Swym-lowstock

Variable

Details

imageURL

URL of product’s image

productName

Name of the product added to wishlist

variantInfo

Variant info or name if the product has any variants

productCurrentPrice

Product’s price

productURL

URL directing to the PDP

productCategory

Category of the product

productQuantity

Number of products left in the inventory

productBrand

Brand name of the product (if any)

  • Metadata available in the Price Drop Alert

Custom event name: Swym-pricedrop

Variable

Details

imageURL

URL of product’s image

productName

Name of the product added to wishlist

variantInfo

Variant info or name if the product has any variants

productOriginalPrice

Product’s initial price before drop (compare at price)

productCurrentPrice

Product’s current price

productURL

URL directing to the PDP

productCategory

Category of the product

productQuantity

Number of products left in the inventory

productBrand

Brand name of the product (if any)

  • Metadata available in the Back in Stock Alert

Custom event name: Swym-backinstock

Variable

Details

imageURL

URL of product’s image

productName

Name of the product added to wishlist

variantInfo

Variant info or name if the product has any variants

productCurrentPrice

Product’s price

productURL

URL directing to the PDP

productCategory

Category of the product

productQuantity

Number of products left in the inventory

productBrand

Brand name of the product (if any)

  • Metadata available in the Restock Second Alert / Reminder

Custom event name: Swym-backinstockReminder

Variable

Details

imageURL

URL of product’s image

productName

Name of the product added to wishlist

variantInfo

Variant info or name if the product has any variants

productCurrentPrice

Product’s price

productURL

URL directing to the PDP

productCategory

Category of the product

productQuantity

Number of products left in the inventory

productBrand

Brand name of the product (if any)

  • Metadata available in the Reminder Acknowledgement

Custom event name: Swym-remindMe

Variable

Details

imageURL

URL of product’s image

productName

Name of the product subscribed to

variantInfo

Variant info or name if the product has any variants

productCurrentPrice

Product’s price

productURL

URL directing to the PDP

productCategory

Category of the product

productQuantity

Number of products left in the inventory

productBrand

Brand name of the product (if any)

Did this answer your question?