Getting Started: Initial Swym & Attentive Integration
This document outlines the integration between Swym and Attentive, a strategic partnership designed to convert shopper intent into revenue through personalized marketing. The integration's core function is to connect the rich, behavioral data captured by Swym's applications with Attentive's powerful AI-driven communication platform. Swym's role is to identify high-value shopper intent signals on your e-commerce site, such as when a customer adds a product to their wishlist, saves an item for later, or signs up for a restock alert. This data provides specific, actionable insights into which products a customer is actively interested in.
This granular event data is then transmitted in real-time to Attentive. As an advanced marketing platform specializing in hyper-personalized SMS and email, Attentive uses this information as a trigger for automated workflows, which it calls "Journeys." By leveraging Swym's intent data, you can build highly effective, behavior-driven campaigns that re-engage shoppers with timely and relevant content on the channels they use most. This synergy ensures that your marketing messages are not generic, but are instead direct responses to a customer's expressed interest, significantly increasing engagement and conversion rates.
The key marketing flows that merchants can implement with this integration include:
Automated reminders for products on a wishlist or saved for later.
Back-in-stock alerts for wishlisted products.
Price drop alerts for specific items on a wishlist.
Low stock alerts to create urgency and drive immediate purchase.
Account authorization emails to help users save and access their wishlists across devices.
Prerequisites
A Swym Wishlist Plus Starter Plan or higher.
An active Attentive Account.
The Swym app is installed on your Shopify store.
Initial Integration Steps
Authorize the Integration: From your Shopify Admin, navigate to the Swym Wishlist Plus app. Find the Integrations tab and select Attentive. Click the install or manage button, which will redirect you to Attentive.
Log in to Attentive: Log in to your Attentive account and authorize the OAuth permissions to grant Swym access.
Configure Sign-up Units: You'll be redirected back to the Swym settings page in your Shopify Admin. You need to get the Sign-up Unit IDs for both Marketing and Transactional messages from your Attentive account.
Note: You may need to contact your Attentive Customer Success Manager (CSM) to have these IDs created for you.
Save and Complete: Paste the obtained IDs into the corresponding fields on the Swym Admin page and click Save.
With these steps completed, your Attentive-Swym integration is active. Now you can enable specific event triggers to power your automated messaging journeys.
1. Low Stock Alerts
This journey notifies customers when a product they've wishlisted is about to sell out, creating a sense of urgency.
Step 1: Enable the Low Stock Event in Swym
Navigate to your Shopify Admin: Shopify Admin → Apps → Wishlist Plus.
Go to the Integrations tab and click Manage on the Attentive tile.
Enable the Wishlist Reminder event. This same event trigger is used for low stock alerts.
Configure the inventory threshold. Swym will send a low stock alert when a product's inventory drops below this number. The default is 10 units, but you can change it.
Test the Event: Scroll down to the ‘Test Events & Triggers’ section. Select “Send Low Stock Alerts,” enter a test email or phone number, and click “Send Test Trigger.”
Verify in Attentive: Go to your Attentive dashboard. Under the Subscribers tab, find the test profile. In the profile's Activities tab, you should see the Swym Wishlist Low Stock Alert custom event.
For further reference: http://www.getswym.com/playbook-how-tos/sending-low-stock-messages-via-attentive
Step 2: Create the Attentive Journey
In your Attentive account, go to Journeys from the left-hand menu and click Create Journey.
Select Start from Scratch.
For the trigger, choose Custom Journey and select the event Swym Wishlist Low Stock Alert.
Build Your Journey: A canvas will appear. Drag and drop steps to build your flow.
To message both SMS and Email subscribers: Add a Branch step. Configure one branch for subscribers who have opted into SMS and another for those opted into email.
Add Actions: Drag a Send Text Message or Send Email action into the appropriate branch.
Customize Your Message: Click on the "Send" action to edit the content. Use the merge tags (
{{}}) to pull in dynamic product information like the product name and URL.
End the Journey: Add an End Journey step after your message(s).
Activate: Once you're happy with the setup, click Turn On in the top right corner.
2. Price Drop Alerts
This journey automatically messages customers when a wishlisted item goes on sale, which is a powerful incentive to purchase.
Step 1: Enable the Price Drop Event in Swym
Navigate to Shopify Admin → Apps → Wishlist Plus → Integrations → Attentive.
Click Manage on the Attentive tile.
Enable the Price Drop Alert.
Configure the price drop threshold. The alert triggers when a product's price drops by this percentage. The default is 5%, but this is configurable.
Test the Event: In the ‘Test Events & Triggers’ section, select “Send price drop alert,” enter your test contact, and click “Send Test Trigger.”
Verify in Attentive: Check the test subscriber's Activities tab in Attentive for the Swym Wishlist Price Drop Alert event.
Step 2: Create the Attentive Journey
In Attentive, go to Journeys → Create Journey → Start from Scratch.
Choose the Journey Trigger: Custom Journey → Swym Wishlist Price Drop Alert.
Build Your Journey: Use the drag-and-drop editor.
Use a Branch step to create separate paths for SMS and email subscribers.
Add Send Text Message and/or Send Email actions.
Customize Your Message: Edit the message content. Be sure to include the product name (
{{product.name}}) and the new, lower price ({{product.price}}) using merge tags.
End and Activate: Add the End Journey step, save your work, and Turn On the journey.
For further information: http://www.getswym.com/playbook-how-tos/sending-price-drop-messages-via-attentive
3. Back in Stock Alerts
Recapture lost sales by automatically notifying shoppers the moment a previously sold-out item they wishlisted is available again.
Step 1: Enable the Back in Stock Event in Swym
Navigate to Shopify Admin → Apps → Wishlist Plus → Integrations → Attentive.
Click Manage on the Attentive tile.
Check the box for Send Back in Stock Alerts.
Test the Event: In the ‘Test Events & Triggers’ section, select “Send Back in stock alerts,” enter your test contact, and send the trigger.
Verify in Attentive: Check the test subscriber's Activities tab in Attentive for the Swym Wishlist Restock Alert event.
Step 2: Create the Attentive Journey
In Attentive, go to Journeys → Create Journey → Start from Scratch.
Choose the Journey Trigger: Custom Journey → Swym Wishlist Restock Alert.
Build Your Journey: Drag and drop your desired steps. You can send an immediate notification or add a Wait step for a short delay. Use a Branch to target both SMS and email channels.
Customize Your Message: Craft a clear message like, "Great news! The
{{product.name}}you wanted is back in stock. Get it before it's gone again!" and include the product URL.End and Activate: Complete the flow with an End Journey step and Turn On the journey.
4. Wishlist Reminders
This journey gently reminds shoppers about items they've added to their wishlist but haven't purchased, keeping your products top-of-mind.
Step 1: Enable the Wishlist Reminder Event in Swym
Navigate to Shopify Admin → Apps → Wishlist Plus → Integrations → Attentive.
Click Manage on the Attentive tile.
Enable the Wishlist Reminder event.
Configure the Delay. This sets how long after a user's last wishlist interaction the reminder will be sent. The default is 24 hours.
Test the Event: In the ‘Test Events & Triggers’ section, select “Send reminders on wishlisted items,” enter your test contact, and send the trigger.
Verify in Attentive: Check the test subscriber's Activities tab for the Wishlist-Reminder event.
Step 2: Create the Attentive Journey
In Attentive, go to Journeys → Create Journey → Start from Scratch.
Choose the Journey Trigger: Custom Journey → Wishlist-Reminder.
Build Your Journey:
It's a best practice to add a Wait step immediately after the trigger (e.g., 15-60 minutes) to prevent the message from feeling instantaneous.
Use a Branch to split the path for SMS and email.
Customize Your Message: Since a shopper can have multiple items, this journey supports sending a list of products.
In the email or MMS editor, use the dynamic list feature to display multiple products from the user's wishlist.
End and Activate: Add the End Journey step and Turn On the journey.
Advanced: Personalizing Messages with Merge Tags
Merge tags are essential for personalizing your messages. They pull customer and product data directly into your SMS and emails. To use them in Attentive, click the double curly braces icon {{}} in the message editor.
Below are the dynamic variables Swym sends to Attentive, which you can use in your messages.
EventTime: The timestamp of when the event was triggered. (e.g.,2024-01-31T21:12:19Z)Medium: The channel the shopper has opted into. (e.g.,emailorsms)ProductBrand: The brand of the product. (e.g.,Supply Dark)ProductId: The unique product identifier from your store. (e.g.,8076431786290)ProductCategory: The product's category as set in Shopify. (e.g.,snowboard)ProductName: The descriptive name of the product. (e.g.,18k Bloom Earrings)ProductPrice: The current price of the product. (e.g.,$495.95)ProductURL: The direct URL to the product page. (e.g.,https://.../products/watch-2)ProductQuantity: The quantity of the product. (e.g.,1)VariantSKU: The Stock Keeping Unit for the product variant. (e.g.,sku)VariantId: The unique ID for a specific product variant. (e.g.,44339644399922)VariantInfo: The description of the product variant. (e.g.,arch)ImageURL: The URL of the product image. (e.g.,https://cdn.shopify.com/.../earrings.jpg)ProductTags: Comma-separated tags associated with the product. (e.g.,Accessory, Sport, Winter)ProductsCount: The total number of products in the user's wishlist. (e.g.,3)Products: An array containing info for multiple products.
Handling Multiple Products (Product Arrays)
For complex events like Wishlist Reminder, Swym sends an array of products. To display these in an Attentive email:
In the email editor, click to add a new row and select Add List.
A pop-up will ask you to choose a list. Select Products.
Configure the dynamic list by mapping the placeholders (like image and text) to the correct product variables from the list above (e.g., set the image source to
ImageURLand link it toProductURL).
FAQ:
Where do I find the Attentive 'Sign-Up Unit IDs' for setup?
You need to contact your Attentive Customer Success Manager (CSM) to have these IDs created for you. Then, paste them into the Swym app's Attentive integration settings.
My test event from Swym isn't showing up in Attentive. Why?
Ensure the specific event (e.g., Back in Stock) is enabled and saved in Swym's settings. Then, verify the test by checking the Activities tab on the subscriber's profile in Attentive, not by looking for a sent message.
How do I add the product's name or price to my messages?
In the Attentive message editor, click the double curly braces icon {{}} to insert merge tags. This lets you add dynamic product details like {{product.name}} and {{product.price}}.
Can I send alerts on both SMS and email in the same flow?
Yes. In the Attentive Journey builder, use the "Branch" rule. This lets you create separate paths to send a text message to SMS subscribers and an email to email subscribers within the same journey.
Need further assistance? You can always reach out to us at [email protected]. If you're already on our Messenger, simply say "talk to an agent," and Fin will connect you with a member of our team who can provide further assistance.