Postscript integrates with Swym, enabling merchants to send personalized retargeting and engagement marketing campaigns to subscribers via SMS. This article explains how to set up and use this integration.
About Swym
Swym is a shopper engagement platform equipped with back-in-stock and pre-order alerts, a full-featured wishlist, insights and analytics, and more.
Why You Should Set Up Swym
Send back-in-stock automations from Postscript using Swym-specific automation triggers.
Alert subscribers about price drops or stock running low.
Send reminders about their wishlist.
Seamlessly collect subscriber data from your Swym back-in-stock form.
Configure Swym in Postscript
Create a Postscript API Key
Select your Shop Name in the side menu of your Postscript dashboard, then select API.
Select Create Security Key Pair on the right side of the page, then confirm your action by selecting Yes.
Add a label to your API key so you can track where this API key is being used.
Select Show in the Private Key column to reveal your API key. Copy this key or write it down—you'll need to enter it in Swym later. Be sure to copy the Private key, not the public key.
Create a Postscript Keyword
To properly configure Postscript in Swym, you'll need to generate a keyword that you'll enter into Swym later. In this section, we'll walk you through how to create that keyword.
Select Acquisition in the side menu of your Postscript dashboard, then select Keywords.
Select Create Keyword in the top-right corner of the page.
Name your keyword. Aim for something that will allow you to easily identify that this keyword is associated with your integration.
Select Save Keyword.
You can customize your keyword reply and add additional actions via + Add Action if desired.
Be sure to activate your keyword before going live with the integration.
Configure Postscript in Swym
In your Shopify admin's left-hand menu, select Wishlist Plus under Apps, and then select Integrations.
Locate the Postscript tile and select the Connect button.
You will be prompted to enter the API key generated earlier, as well as a keyword, which is used when adding subscribers to Postscript. The keyword entered here must match a keyword you have already created in Postscript.
Since Postscript only supports the SMS channel, SMS is enabled by default, and no further changes are needed. Select the Save button.
Once connected, Wishlist Plus will send event triggers to Postscript that you can use to build automations in the Postscript Flow Builder.
Supported Events
Swym sends the following events to Postscript. Each can be used as an automation trigger.
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 | A product on a wishlist goes on sale |
Low Stock Alert | A product on a wishlist is running low on stock |
Back in Stock Alert | A product on a wishlist is restocked |
Frequently Viewed | A shopper visits a product page multiple times |
Swym Back in Stock Alerts app events
Event name | When this event is triggered |
Back in Stock Acknowledgement | A shopper subscribes to be notified when a product is back in stock |
Restock Alert | A product a shopper requested a back-in-stock alert for is restocked |
Restock Reminder | Follow-up alert (usually ~24 hours after the first restock alert, configurable) |
Note: The Save For Later reminder and Share Wishlist events are not supported.
Testing the Integration
Merchants can test the integration by sending test triggers to Postscript.
On the Postscript page in the Wishlist Plus app, select Test Events & Triggers.
Under Select Triggers, select the checkbox for each event you want to test. See Supported Events above for the full list of events Postscript supports.
Enter a Phone Number.
Select the Send Test Triggers button.
Next, switch to the Postscript app. Select Messaging and then select Automations.
Select the drop-down menu beneath Trigger event or property. You should see all of the event triggers you tested.
IMPORTANT! When using Swym's Back In Stock trigger, add a message delay of at least 5 minutes.
This allows Swym time to add any new subscribers sourced from the back-in-stock form to your Postscript account so that those subscribers are eligible to receive your back-in-stock messages.
Personalize Your Messages with Swym Metadata
Swym sends metadata along with each event that you can use to personalize your SMS templates. When building an automation, reference the custom event name below and insert the available variables into your message.
Note: Wishlist Reminder is a multi-product event—a shopper may have added more than one product to their wishlist. However, only the details of the first product in the shopper's wishlist is sent.
Wishlist Reminder — 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 |
Low Stock Alert — custom event name: Swym-lowstock
Variable | Details |
imageURL | URL of the 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) |
Price Drop Alert — custom event name: Swym-pricedrop
Variable | Details |
imageURL | URL of the 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 the 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) |
Back in Stock Alert — custom event name: Swym-backinstock
Variable | Details |
imageURL | URL of the 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) |
Restock Alert / Reminder — custom event name: Swym-backinstockReminder
Variable | Details |
imageURL | URL of the 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) |
Reminder Acknowledgement — custom event name: Swym-remindMe
Variable | Details |
imageURL | URL of the 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) |
Get Support
Have questions? Please feel free to reach out to our Support team at [email protected] or via live chat.
Need ongoing channel strategy guidance? Please fill out this form and we'll connect you to one of our certified partners.