Chatbot and commerce troubleshooting
Fixes for a bot that doesn't start or reply, webhooks and lead ads that don't fire, shop and catalog sync errors and orders that don't reach your store.
- Who can use this
- Account owner, Manager
Fixes for a bot that doesn't start or reply, webhooks and lead ads that don't fire, shop and catalog sync errors and orders that don't reach your store.
Start with what you see, then follow the fix. For the full list of builder warnings and log errors, see Common chatbot errors.
Note the customer's phone number and the time it went wrong. Logs and the Copilot search by phone and time.
A bot that never answers is usually switched off at one of the levels below, or has no bot to start. Check them in this order.
| What you see | Why | What to do |
|---|---|---|
| No bot replies anywhere | Chatbots are off for the whole workspace | Turn on Enable Chat Bot in the Bot card of Settings → General Settings. See Folders and bot settings. |
| No bot starts in new chats | No default bot is set for the conversation, the channel or the workspace | Pick a Default Chat Bot, a channel Chat Bot, or the conversation's Default Chatbot. See Default bot and per-conversation control. |
| One bot never replies on any number | The bot itself is off | Turn on Is Enabled for the bot. See Test, versions and enable. |
| No reply on one number only | Enable Chat Bot is off for that channel | Turn it on in that channel's card on the Channels tab of General Settings. See Folders and bot settings. |
| No reply in one conversation | Chatbot Enabled is off on that conversation | Turn it on in the conversation. See Default bot and per-conversation control. |
| Run button says "Enable the chatbot to run it" | Chatbot Enabled is off here | Turn it on first |
Nothing happens after #start SHORTCODE | The bot is off, or the chatbot is off for the workspace, channel or conversation | Check the three switches above |
| The bot keeps replying while an agent chats | Chatbot Enabled is still on | Turn it off, or end hand-over paths with Disable Chatbot |
| The bot starts over in the middle | The chat session expired | Raise Chat Session Expiration Duration (Minutes) |
| Messages fail outside 24 hours | Free-form messages need an open 24-hour window (Meta rule, checked 2026-10-22) | Start with a Template Message block |
| "Maximum bot limit exceeded - Please update the package!" | You reached your plan's chatbot limit. Bots in folders count too. | Delete unused bots, or upgrade |
Do Not Disturb (DND) on a contact does not stop the bot: bot replies are still sent. If you want the bot quiet for a contact, turn Chatbot Enabled off on the conversation.
| What you see | Why | What to do |
|---|---|---|
| Your system calls the webhook but nothing is sent | The webhook is Inactive, has no scenario (Pending Setup), or the phone field is empty | Switch it on, create the scenario, map the phone field. See Webhooks. |
| "Failed to create webhook" with Upgrade | Plan limit reached | Delete unused webhooks, or upgrade |
| Facebook connection expired in FB Leads | Facebook stopped letting the platform read leads | Click Reconnect |
| A form shows Not receiving or Leads skipped | Leads don't reach the automation, or an ad filter drops them | See Facebook lead ads |
| A webhook keyed on phone fails for some customers only | They use a WhatsApp username, so the phone is empty | See Customers with a WhatsApp username |
| What you see | Why | What to do |
|---|---|---|
| "The sync didn't finish" | Meta or the store failed | Try again in a minute |
| "Connect a Meta catalog first." | No catalog on this number | Run the setup in WhatsApp shops |
| "The catalog connection expired" | Meta access expired | Reconnect catalog |
| "Another catalog is linked" | Meta allows one catalog per WhatsApp account | Change it in Meta Business Manager, or use the linked catalog |
| "Meta had a temporary problem" / "Meta is busy" | Meta rate limit or outage | Nothing changed; try again in a minute |
| No products in your catalog | Products never reached Meta | Sync products (Shopify) or add them in Commerce Manager, then Refresh products |
| "E-commerce catalog is not connected for this workspace" (Logs) | A Catalog or order block ran without a connected shop | Finish WhatsApp shop setup |
| What you see | Why | What to do |
|---|---|---|
| Orders never reach your system | No store, no order webhook and no workspace default webhook | Connect a store or set an Order webhook. See Catalogs and product sync. |
| "No tenant-default webhook configured. Without an override here, orders on this catalog won't be delivered anywhere." | No webhook anywhere | Set a webhook URL or connect a store |
| Log: "…the connected store did not accept the change…" | The store refused the update | Fix the store connection; the change is kept for resending |
| Log: "The e-commerce service did not respond in time…" | A temporary outage | Check the connection; do not re-create the order |
Do it with Copilot
The Copilot checks the conversation's bot status and the logs.
Do it with Copilot
Do it with Copilot
Do it with Copilot
The Copilot's catalog and order tools are in a pilot and available only in some workspaces.