Connect WaSMS to Shopify

Shopify can tell WaSMS about every order. For each event you switch on, WaSMS sends the buyer a WhatsApp message from your number, with the order’s details filled in. You need a connected WhatsApp number and a Shopify store you can manage.

1. Start in WaSMS

1. Open Integrations (under For developers in the menu) and click Set up on the Shopify card.
2. Click Start. WaSMS shows your webhook address. Click Copy.

2. Add the webhooks in Shopify

1. In Shopify admin open Settings → Notifications → Webhooks and click Create webhook.
2. Event: Order creation. Format: JSON. URL: paste the webhook address. Pick the latest API version and save.
3. Do the same for each other event you want: Order payment, Order fulfillment (shipped) and Order cancellation.

3. Paste Shopify’s signing secret

Below the webhooks list Shopify shows “Your webhooks will be signed with …”. Copy that secret and paste it into WaSMS (step 3 on the Shopify page), then click Save. WaSMS only acts on orders signed with it, so nobody else can send messages in your name.

4. Write your messages

Under Messages, choose the WhatsApp number to send from and switch on the events you want. Each event has its own message; WaSMS starts you with one you can change. These fill-ins are replaced with the order’s details:

• {{first_name}} and {{name}} — the buyer (a buyer with no name is greeted as “there”)
• {{order_number}} — for example #1001
• {{total}} — the currency and amount
• {{status_url}} — the order status page
• {{tracking_url}} — the tracking link, once the order has shipped
• {{shop}} — the store name you type

WaSMS sends to the buyer’s phone number: the customer’s, else the billing address’s, else the shipping address’s. Ask for a phone number with the country code at checkout.

5. Test it

Use Send a test on the Shopify page to get a sample order’s message on your own WhatsApp. Then place a real test order, or use Send test notification on a webhook in Shopify, and check Recent orders: every order Shopify sent is listed with what WaSMS did.

Good to know

• Each order event sends at most one message, even when Shopify sends the webhook again.
• Buyers who replied STOP to you get no messages.
• The messages count towards your plan’s WhatsApp sends and your number’s sending limits.
• Pause order messages stops them without removing anything. Disconnect removes the connection; delete the webhooks in Shopify too.

If a message did not arrive

Look at Recent orders. “The order has no phone number”: the buyer gave none. “The message for this event is switched off”: switch it on under Messages. “No connected WhatsApp number”: connect one on the WhatsApp page. If an order is missing from the list, check the webhook address and the signing secret.