Integrating Wishlist Plus and/ or Swym Back in Stock Alerts with Cordial allows you to send personalized retargeting and engagement marketing campaigns to your customers via email, SMS or push notifications. This guide walks you through the steps to successfully set up and use this integration.
Prerequisites
Before you begin, ensure the following:
You are on the Enterprise plan on Wishlist Plus or Swym Back in Stock Alerts app.
You have an active Cordial account
Successfully connecting your Wishlist Plus or Swym Back in Stock Alerts app to Cordial involves three key steps. It’s important to complete all of them to ensure that your shoppers actually receive the notifications you intend to send.
Connect your Swym app to Cordial
Establish the connection so that your Wishlist Plus or Back in Stock Alerts app can securely communicate with Cordial.
Subscribe to events you want to send
Choose which Swym events (e.g., price drop, back in stock, wishlist reminder) should be sent to Cordial. Without selecting events, no triggers will reach Cordial.
Build Email/ Podium Automations in Cordial
Set up email/ Podium automations that use these events to send personalized emails, SMS or push notifications to your shoppers. This is what ensures that the right communication goes out when an event occurs.
⚠️ Note: We often see merchants stop at just connecting the apps, without subscribing to events or building automations. Make sure you complete all three steps for the integration to work as intended.
Step 1: Connect your Swym app(s) to Cordial
Connecting Cordial with Swym is currently not self-serve. Hence, you would need to reach out to us on [email protected] and share the following details:
1. API Key: You can get this by navigating to Settings > API Keys > New on your Cordial account and creating an API key. In the IP Address field, please enter 0.0.0.0/0 so this key can be used by all IP ranges. You can ignore selecting any Permissions.
You can refer to this Cordial help doc if you need any further help on creating an API key
2. List Name (optional): This is needed if you have enabled Add to Mailing List functionality. We will use this to add contacts to your mailing list.
Once the above are shared with us, we will set up the integration for your store and confirm the same over the email.
Step 2: Subscribe to events you want to send
After the integration has been set up from our end, on your Wishlist Plus app head over to the Marketing tab and scroll to the “Automations” section. Here, you will notice various events that you can subscribe to. Enable the desired events.
Below are the list of events we support:
Swym Wishlist Plus App Events:
Event Name | When this event is triggered |
Swym - Wishlist Reminder | Reminder about items in a shopper’s wishlist |
Swym - Save for Later Reminder | Reminder about a shopper’s Saved for Later items |
Swym - Price Drop Alert | Product on a wishlist goes on sale |
Swym - Low Stock Alert | Product on a wishlist is running low on stock |
Swym - Back in Stock Alert | Product on a wishlist is restocked |
Swym - Share Wishlist | When a wishlist is shared by one shopper to another via an email |
Swym - Add to Wishlist | When a product is added to a shopper's wishlist |
Swym Back in Stock Alerts App Events
Event Name | When this event is triggered |
Swym - Back in Stock Acknowledgement | Shopper subscribes to be notified when a product is back in stock |
Swym - Back in Stock Alert | Product a shopper requested a back-in-stock alert for is restocked |
Swym - Back in Stock Second Reminder | Follow-up alert (usually ~24 hrs after the first restock alert, configurable) |
Step 3: Build Email/ Podium Automations in Cordial
You will have to build separate email/ podium automations for each of the events you subscribed to in order to automate sending out personalised emails/ sms/ push notifications to your shoppers.
Here, your Customer Success Manager/ Account Manager/ Solutions Architect at Cordial will help you set up the email/ sms templates that utilize the custom event attributes.
Attributes available in the Swym - Wishlist Reminder event:
Variable | Details |
ProductsCount | Number of products in the current wishlist reminder event |
Products[] | List of products. Each element in the products list has the following fields. |
ImageURL | URL of product’s image |
VariantInfo | Variant info (Size, Color, etc) or name if the product has any variants |
ProductPrice | Product’s price |
ProductBrand | Brand name of the product (if any) |
ProductQuantity | Number of products wishlisted |
ProductName | Name of the product added to wishlist |
ProductCategory | Category of the product |
ProductURL | URL directing to the PDP |
ProductTagsList [] | Array of product tags |
Attributes available in the Swym - Save for Later Reminder event:
Variable | Details |
ProductsCount | Number of products in the current reminder event |
Products[] | List of products. Each element in the products list has the following fields |
ImageURL | URL of product’s image |
VariantInfo | Variant info or name if the product has any variants |
ProductPrice | Product’s price |
ProductBrand | Brand name of the product (if any) |
ProductQuantity | Number of products wishlisted |
ProductName | Name of the product added to wishlist |
ProductCategory | Category of the product |
ProductURL | URL directing to the PDP |
ProductTagsList [] | List of product tags |
Attributes available in the Swym - Low Stock Alert event:
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 |
ProductPrice | 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) |
ProductTagsList [] | List of product tags |
Attribtues available in the Swym - Price Drop Alert event:
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 |
ProductPriceOriginal | Product’s initial price before drop (compare at price) |
ProductPrice | 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) |
ProductTagsList [] | List of product tags |
Attributes available in the Swym - Back in Stock Alert event:
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 |
ProductPrice | 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) |
ProductTagsList [] | List of product tags |
Attributes available in the Swym - Share Wishlist event:
Variable | Details |
SenderEmail | Email ID of the sender |
SenderName | Name of the sender |
Note | Message/ note left by the sender |
ShareURL | URL to the shared wishlist page |
ListName | Name of the wishlist list being shared |
ProductsCount | Number of products in the shared wishlist |
products[] | List of products. Each element in the products list has the following fields |
ImageURL | URL of product’s image |
VariantInfo | Variant info or name if the product has any variants |
ProductPrice | Product’s price |
ProductBrand | Brand name of the product (if any) |
ProductQuantity | Number of products wishlisted |
ProductName | Name of the product added to wishlist |
ProductCategory | Category of the product |
ProductURL | URL directing to the PDP |
ProductTagsList [] | List of product tags |
Attributes available in the Swym - Back in Stock Second Reminder event:
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 |
ProductPrice | 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) |
ProductTagsList [] | List of product tags |
Attributes available in the Swym - Back in Stock Acknowledgement event:
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 |
ProductPrice | 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) |
ProductTagsList [] | List of product tags |