WhatsApp is down: what happens to your Shopify order notifications
When Meta's API fails, are Shopify order WhatsApps lost, delayed or sent twice? Shopify's webhook retries, Beacon Messenger's queue, retries and dedupe key.
Five years ago today, on 4 October 2021, WhatsApp, Facebook and Instagram disappeared from the internet for about six hours after a routing configuration change at Meta. Stores that had moved their order notifications onto WhatsApp spent an afternoon not knowing whether confirmations had gone out, would go out later, or would go out twice when everything came back. Outages that long are rare. Partial ones, where the Cloud API returns errors for twenty minutes or throttles a number that is suddenly sending more than usual, happen often enough that a notification app should have a clear answer to three questions: what gets lost, what gets delayed, and what gets duplicated.
This post gives that answer for Beacon Messenger and, because half of the chain is Shopify's, for Shopify's webhooks too. The short version is that a notification is a row in a queue with a key, not a request fired at Meta the moment an order lands, and most of what follows is the consequence of that one decision.
Three links that can each break
An order confirmation on WhatsApp passes through three systems. Shopify notices the order and sends a webhook to the app. The app builds the message and calls Meta's Cloud API. Meta delivers it to the customer's phone. Each link fails differently, and a failure in one does not look like a failure in another, which is why "WhatsApp is down" is less useful than it sounds.
- Shopify to app: your app's server is restarting, overloaded or unreachable. The order exists, but nobody has been told about it yet.
- App to Meta: the Cloud API returns an error, times out or throttles. The app knows about the order and has a message ready, but cannot hand it over.
- Meta to phone: Meta accepted the message, but the customer's phone is off, out of coverage or has WhatsApp uninstalled. The message sits at sent and may become delivered hours later; this link is covered in the delivery verification post and is not an outage at all.
Shopify's side: webhooks are retried for two days
Shopify does not fire a webhook once and forget it. According to Shopify's webhooks documentation, a delivery has to be acknowledged with a 2xx response within five seconds; if it is not, Shopify retries the delivery 19 times over the following 48 hours, and only after 19 consecutive failures does it remove the subscription. So an app server that is down for an hour misses nothing: the orders placed during the hour arrive as webhooks once it is back, in the order Shopify retries them.
The five-second rule has a consequence for how a well-behaved app is built. If the app tried to call Meta inside the webhook request, a slow Meta response would push the app past five seconds, Shopify would count the delivery as failed and retry it, and the app would now have the same order twice. The right design is to acknowledge the webhook immediately, store what needs to happen, and do the sending somewhere else. That is what the queue is for.
Beacon Messenger's side: a queue, a lock and a key
When an order webhook arrives, Beacon Messenger verifies it, writes one row per enabled automation into a scheduled-message table and returns a 200 to Shopify. The row holds the trigger, the time it is due and a snapshot of the order details the template needs. Order confirmations are due immediately; cash-on-delivery confirmations are due after the delay you set; abandoned-checkout reminders are due after the reminder delay. A poller wakes every thirty seconds, claims due rows by stamping a lock on them, and sends each one.
The send has a fifteen-second timeout. If Meta answers with a server error (any 5xx status), with error code 4, which Meta documents as "API Too Many Calls", or with code 130429, "Rate limit hit", the row is released back to the queue with a later due time: two minutes after the first failure, four after the second. Meta's error code reference lists both. After the third failed attempt the row is written to the message log as failed, with Meta's error code and message attached, and it stops retrying on its own. Errors that are not worth retrying, a rejected template, a malformed phone number, a paused template, go straight to failed on the first attempt, because trying again would produce the same answer.
Rows that reach failed are not gone. The Messages page lists them with the error, and each has a Retry action that re-runs the send from the stored order snapshot, right now, regardless of how old the order is. After a real outage, filtering Messages to failed and retrying the handful of rows that exhausted their attempts is the whole recovery procedure.
Why nothing is sent twice
Duplicates are the failure merchants fear most, because a customer who receives the same confirmation twice assumes they were charged twice. Beacon Messenger prevents them with a dedupe key: one string per shop, trigger and object, so an order confirmation for order 1042 always has the same key however many times Shopify delivers the webhook. The key is also the id of the message log row. Before any send, the app checks whether a log row with that key already exists in a sent state, and if it does, the queue item is dropped without calling Meta.
Two other paths are closed by the same mechanism. A webhook that Shopify retries after the app had in fact processed it (the 200 was lost on the network) re-queues the same key, which simply moves the existing row rather than creating a second one. And when two copies of the app server run at once, each poller claims a row by updating it only if the lock has not changed since it was read, so a row is sent by whichever process won the claim and skipped by the other. Shipping updates work the same way with a key per fulfillment, which is why a later tracking edit does not resend the original message; the split shipments post has the details.
What the customer experiences after a long outage
A confirmation that could not be sent for ninety minutes arrives ninety minutes late, once, with the order details as they were when the order was placed. That is the intended behaviour; a late confirmation is still useful, and the alternative, dropping it, leaves the customer with nothing. Cash-on-delivery confirmations keep their original due time, so if the outage ends before the delay has elapsed nothing was ever late.
Two situations get a different answer. If the order was cancelled during the outage, Shopify's cancellation webhook removes the queued confirmation before it can be sent, so the customer does not receive a confirmation for an order that no longer exists. And an abandoned-checkout reminder that fell due during the outage is dropped if the customer completed the order in the meantime, because the order webhook cancels the reminder by its checkout key. What the outage cannot do is make a message skip the plan's monthly cap or the consent check; those run at send time, not at queue time, so a message held over an outage is judged against the same rules as one sent on time.
What to do while it is happening
- Check Meta's status page for the WhatsApp Business Platform before touching anything in your store. If Meta is reporting an incident, the problem is not your template, your number or your connection.
- Do not disconnect and reconnect the WhatsApp number, and do not re-enter the access token. The connection is not broken; the API behind it is. Reconnecting during an incident can fail in confusing ways and leave you debugging the wrong thing afterwards.
- Do not send confirmations by hand from a phone unless an order is urgent. The queue will send them when the API recovers, and a manual message plus a queued one is the only way to get a duplicate.
- When the incident is over, open Messages, filter to failed, and use Retry on anything that exhausted its attempts during the outage. Rows that were still retrying will have finished on their own.
- Remember that the email confirmation from Shopify went out as normal. WhatsApp is the convenient copy; email remains the complete record, and during an outage that is exactly the arrangement you want.
An outage is the one time the design of a notification app is visible from outside. Fire-and-forget designs lose messages when Meta is down and duplicate them when Shopify retries; a queue with a key does neither, at the cost of being a few minutes late. Beacon Messenger is built the second way, on a free plan with 50 automated messages a month, so you can watch the Messages page during the next small incident and see each row retry, succeed and stay single.
Frequently asked questions
If WhatsApp is down, are my Shopify order confirmations lost?
Not with a queue-based app. Beacon Messenger acknowledges Shopify's webhook immediately and stores the message in a queue. Sends that fail with a Meta server error or rate limit are retried after two and then four minutes, and anything that still fails is listed as failed in the Messages page with a Retry action. Shopify, for its part, retries any webhook the app did not acknowledge 19 times over 48 hours.
Can a customer receive the same WhatsApp order confirmation twice?
Not from Beacon Messenger. Every notification has a dedupe key made of the shop, the trigger and the order, and that key is the id of its message log row. A repeated webhook, a retried send or a second server process all resolve to the same key, and the app refuses to send when a sent row with that key already exists.
What do WhatsApp error codes 4 and 130429 mean?
Both are throttling. Code 4 is Meta's general "API Too Many Calls" limit and 130429 is "Rate limit hit" for the WhatsApp Business account's throughput. Neither means the message was wrong; they mean Meta wants it later. Beacon Messenger treats both as retryable and backs off before trying again.
Should I reconnect my WhatsApp number during an outage?
No. If Meta's status page reports an incident on the WhatsApp Business Platform, the connection is fine and the API behind it is not. Reconnecting adds a second variable to debug. Wait for the incident to clear, then retry any failed messages from the log.
More guides
- WhatsApp Business app drops order tools: move orders to Shopify
- A customer replied STOP to a WhatsApp order message. Now what?
- WhatsApp marketing templates leave the Cloud API in October 2027
- WABA to Messaging Account: what changes for Shopify WhatsApp
- Order paid later, refunded or edited: which WhatsApp messages send
- Edited your WhatsApp automation? What queued messages send
- How to add a WhatsApp chat button to your Shopify store (2026)
- How to send Shopify order confirmations and shipping updates over WhatsApp with the official Cloud API
- Cash on delivery on Shopify: confirm orders over WhatsApp before you ship
- Recovering abandoned checkouts on Shopify with WhatsApp, the compliant way
- Why WhatsApp apps get your number banned: linked device vs API
- How a "free" WhatsApp app for Shopify ends up charging you
- Por qué una app de WhatsApp "gratis" para Shopify te cobra
- Pushdaddy or SuperLemon alternative: WhatsApp apps compared
- How to verify Shopify WhatsApp notifications were delivered
- Chat button still on your store after uninstalling the app?
- WhatsApp API pricing changes on Oct 1, 2026: Shopify impact
- Setting up the WhatsApp Cloud API with Meta's MCP and an AI agent
- WhatsApp chat outside business hours: what shoppers should see
- WhatsApp product sharing on Shopify: tracking dark social
- WhatsApp template rejected? Fixing Shopify order templates
- One WhatsApp number or two? Shopify notifications & support
- Shopify Canvas and Beacon Messenger: what works today
- Shopify now collects WhatsApp marketing consent at checkout. Here is what it changes
- Split shipments on Shopify: how many WhatsApp updates to send
- WhatsApp's 250-a-day messaging limit and your Shopify store
- WhatsApp, SMS or email for Shopify order notifications?
- Shopify orders with no phone number: why WhatsApp messages get skipped
- Shopify rollout discounts and WhatsApp order messages
- Add a Track order button to WhatsApp order messages
- Which Shopify orders trigger a WhatsApp message?
- The abandoned checkout timer restarts every time the shopper comes back
- Blank names, twelve-item orders: what WhatsApp merge fields fall back to
- Who looked at your customers' phone numbers? The access log behind a WhatsApp app
- Send a WhatsApp test message before your first order: what the Connect and Test buttons check
- Disconnect, update credentials, app secret: what each does
- COD reply not tagged: how Beacon Messenger matches replies
- WhatsApp template language: why name alone is not enough
- Finding one WhatsApp message in the Beacon Messenger log
- WhatsApp automation is On but nothing sends: a checklist
- Mapping WhatsApp template variables to Shopify order fields
- Every WhatsApp chat button setting in the Shopify theme editor
- WhatsApp template examples for Shopify: order, shipping, COD, cart
- The Share on WhatsApp block, setting by setting
- WhatsApp order messages when customers speak several languages
- Reading the Beacon Messenger dashboard: sent, delivered, failed, skipped
- Shopify batch fulfilment: what happens to 250 WhatsApp shipping messages
- WhatsApp template status: approved, pending, paused, disabled, and what sends
- WhatsApp quality rating: the field on the Connected number card
- COD returns (RTO) on Shopify: confirm orders on WhatsApp first
- WhatsApp error codes on failed messages: a reference
- WhatsApp display name: what customers see on your order messages
- Shopify Messaging WhatsApp automations vs Beacon Messenger
- OXXO, bank transfer and pay-later orders: when the WhatsApp confirmation goes out
- How many WhatsApp messages will Black Friday send? Sizing your plan
- WhatsApp usernames and BSUIDs: what changes for Shopify order messages
- Reconciling your WhatsApp bill with the Beacon Messenger log
- Track with Shop vs WhatsApp shipping updates on Shopify
- Meta changed my WhatsApp template from utility to marketing
- Shopify's new app security review: what Beacon Messenger can access
- A shopper cancels their own Shopify order: what WhatsApp sends
- Customer erasure in 5 days: what the WhatsApp log keeps
- WhatsApp INR billing deadline: Indian Shopify stores
- WhatsApp template headers: text, image or document?
- Gift orders on WhatsApp: buyer's phone or the recipient's?
- WhatsApp order messages at night: when each one sends
- Downgrading a WhatsApp app plan after peak season: what changes
- Shopify subscription renewals and WhatsApp order messages