> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatflows.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting ChatFlows for Shopify

> A message didn't send, a template was rejected, or a Shopify event didn't run? Find the cause and the fix.

Start here when something doesn't work as you expect.
For any message, the first place to look is **Setup → WhatsApp Message Log**. It lists every message sent and shows why a message failed.
See [WhatsApp Message Log](https://docs.chatflows.io/core-setup/whatsapp-activity-log.md).

## A message didn't send

> [accordion] The customer hasn't written to you in 24 hours
>
> Outside the 24 hours, you can only send an approved **template**. A normal text message won't go through.
> Start your automation or campaign with a template. See [the 24-hour rule](https://docs.chatflows.io/getting-started/concepts.md).

> [accordion] The template isn't approved yet
>
> A template can only be sent when it shows **Approved**. Check its status in **Message Templates → WhatsApp**.

> [accordion] The customer opted out
>
> A customer who replied **STOP** no longer gets marketing messages. Order updates and other Utility messages still go out.
> See [Opt-out](https://docs.chatflows.io/settings/opt-out.md).

> [accordion] The customer has no phone number
>
> WhatsApp needs a phone number. Check that your Shopify checkout asks for one.

> [accordion] Meta stopped the message
>
> Meta can stop messages, for example when there's no payment method on your WhatsApp Business account, or you reached your messaging limit.
> The reason shows in the **WhatsApp Message Log**. See [WhatsApp costs](https://docs.chatflows.io/billing/whatsapp-costs.md).

## A cart reminder wasn't sent

> [accordion] The shopper ordered before the wait was over
>
> That's expected. ChatFlows checks the checkout again before it sends. A shopper who ordered gets nothing.

> [accordion] The wait isn't over yet
>
> Each cart automation waits for its **Send after (minutes)** time. Check what you set. See [Recover abandoned carts](https://docs.chatflows.io/shopify/cart-recovery.md).

> [accordion] The automation is off
>
> Go to **Automations** and check that the automation is switched on.

> [accordion] The shopper didn't give a phone number
>
> Shopify only shares a phone number if your checkout asks for one.

## An order update didn't run

> [accordion] Out for delivery or Delivered never runs
>
> These two events need delivery tracking. Your shipping carrier or shipping app must send tracking updates to Shopify.
> If you mark orders as fulfilled by hand, these events never run.

> [accordion] Delivery updates are off
>
> Your store was connected before ChatFlows asked for delivery access.
> Go to **Settings → Shopify** and click **Reconnect**, then approve the access in Shopify.

> [accordion] Nothing runs for any order
>
> Go to **Settings → Shopify** and check that your store shows **Connected**.
> If it shows **Needs attention**, read the reason and click **Reconnect** or **Retry setup**.
> See [Your store and the Shopify app](https://docs.chatflows.io/shopify/shopify-admin-app.md).

## A template was rejected

Meta reviews every template. If it's rejected, you get a notification. Common reasons:

* The category is wrong. For example, an offer inside a **Utility** template.
* The template starts or ends with a variable.
* The example values are missing or unclear.

Fix the wording and submit it again. See [Template examples](https://docs.chatflows.io/messaging/template-examples.md) for wording that works.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.