Shopify

Connect your Shopify store to send WhatsApp messages on its own: a reminder when a shopper leaves checkout without paying, a confirmation when an order is paid, and a note when an order is cancelled. In the app it is called Shopify Marketing.

New store? Use the Shopify app

Shopify no longer lets stores create the custom app this setup needs, so new stores connect with the Splashify Pro app from Shopify instead. See Shopify. Stores that already use Shopify Marketing can keep it.

Before you start

Admin access to your Shopify store.
An approved WhatsApp template for each message, for example a cart reminder and an order confirmation. See Create a WhatsApp template. Most templates are approved within 24 hours.
Ask for a phone number at checkout. In Shopify, open Settings, then Checkout, and make the phone number required.

Where to find your Shopify keys

In our app	Where it comes from
Store URL	Your store's Shopify address, for example `https://acmeboutique.myshopify.com`
Admin API Access Token	Create a custom app for your store (in Shopify admin: Settings, then Apps and sales channels, then Develop apps), install it, and copy its Admin API access token. It starts with `shpat_`. Shopify shows it only once.
Webhook Secret Key	In Shopify admin, open Settings, then Notifications, then Webhooks. Under your webhooks, Shopify shows the key your webhooks are signed with. Copy it. It appears once you have added a webhook (step 3 below).

Connect Shopify

Open Shopify Marketing in the app
In the left sidebar, click Integrations. Under E-commerce, find Shopify Marketing and click Connect.
Copy the webhook URL
Scroll down to Paste this URL in Shopify Marketing and click the copy button next to the URL.
Copy the URL first. Shopify needs it to create the webhooks

Add the webhooks in Shopify

In Shopify admin, open Settings, then Notifications, then Webhooks, and click Create webhook. Add one webhook for each event you want, all with the same URL:

Shopify event	Sends the message for
Checkout creation	Abandoned Cart
Order payment	Order Paid. Always add this one if you use Abandoned Cart: it tells us the shopper paid, so no reminder goes out.
Order cancellation	Order Cancelled

For each one, choose JSON as the format, paste the URL, pick the latest API version and click Save. Then copy the signing key shown under your webhooks.

Add your keys in the app
Back in our app, under Add your Shopify Marketing keys, fill in Store URL, Admin API Access Token and Webhook Secret Key (the signing key you just copied).
Step 1: your store URL, the app token and the signing key
Choose a message for each event
Under Choose a message for each event, click Abandoned Cart. Pick a Template, leave Send it to on Customer Phone, and fill the blanks, for example Customer First Name and Checkout Recovery URL (a link that takes the shopper back to their cart).
Abandoned Cart: a reminder with a link back to the cart
Then click Order Paid and do the same, for example with Customer First Name and Order Number. Leave Order Cancelled empty if you do not want a message for it. (You can also leave Order Paid empty. The Order payment webhook still stops the cart reminder.)
Order Paid: a confirmation with the order number
Click Connect Shopify Marketing
Click Connect Shopify Marketing in the bar at the bottom. You will see Shopify Marketing is connected, and the top of the page says Active.
Check that it works
Place a test order in your store with a real phone number. Open the Activity tab on the Shopify Marketing page. You should see Sent, Message sent, for the paid order.
Abandoned carts wait an hour first, and are skipped if the shopper pays

How the abandoned-cart reminder works

Shopify sends Checkout creation as soon as a shopper starts checkout and types their contact details. We do not message them at once:

The reminder waits 1 hour. Activity shows it as Waiting, Abandoned cart: sent in 1 hour unless the order is paid first.
If the shopper pays within the hour, Shopify sends Order payment and the reminder is dropped. Activity shows Skipped, The customer placed the order within the hour, so no abandoned-cart message was needed.
If they have not paid after an hour, the reminder goes out and shows as Sent.

If you pause Shopify Marketing before the hour is up, the waiting reminder is not sent.

What you can put in the message

In Fill the variables	What it holds
Customer First Name	The shopper's first name
Checkout Recovery URL	A link back to the shopper's cart (Abandoned Cart only)
Cart Value	The total, for example `1499.00`
Order Number	For example `#1024`
Customer Phone	The shopper's phone. If the customer record has none, we use the phone from checkout or from the billing or shipping address.

Change, pause or disconnect

Change a message: open the event, make your change, then click Save changes at the bottom.
Stop one message: open the event and click Stop messaging for this event, then Save changes.
Pause: switch Active off on the right.
Disconnect: click the ⋮ button at the top right, then Disconnect, and confirm. Also delete the webhooks in Shopify.

If a message did not go out

Open the Activity tab.

What you see	What to do
Rejected, The webhook secret did not match	Copy the signing key from Shopify's webhook settings again into Webhook Secret Key.
Not sent, No phone number in the field you picked	The shopper gave no phone number. Make it required at checkout.
Skipped, No message is set for the orders/paid event	Normal if you left Order Paid empty: the event still stops cart reminders. For other events, pick a template or delete that webhook in Shopify.
A shopper who paid still got a cart reminder	The Order payment webhook is missing in Shopify. Add it with the same URL.

More fixes are in Troubleshooting.