Skip to main content
When a Flow step fails, open Settings → Logs (or the delivery / error log for the contact) and match the message below. Most issues are empty content, messaging windows, template parameters, or a disconnected channel.
Also see Channel errors for connection and authorization problems outside the Flow canvas.

​
Messenger and Instagram

A Message block is empty, or a placeholder like {{Response}} has no value.Fix: Ensure every Message block has text or a valid attachment, and that custom fields used in the message are set before the block runs.
You are messaging outside Meta’s 24-hour customer care window, or previewing a Flow while outside that window.Fix: Have the contact message the bot again, then retry. For proactive outreach, use an approved message tag / OTN where applicable.
Delivery fails until the channel is re-authorized.Fix: Go to Settings → Channels and reconnect Messenger or Instagram.
Another Facebook app owns the conversation (Handover Protocol).Fix: Make the Fliqr AI app the primary receiver on the Facebook Page handover settings. Move the chat out of live chat / “done” on both the Fliqr Inbox and the Page Inbox if needed.
A button or image URL is missing https:// or is malformed.Fix: Use full https:// URLs for buttons and image blocks.
The person blocked Page messages, or they only commented and never opted into Messenger — then a Delay / sequence tried to message them.Fix: Do not send delayed follow-ups until the contact has opted into messaging. For blocked users, an admin can try a manual Page Inbox reply.
Another app controls the thread / Fliqr is not the primary receiver.Fix: Set Fliqr AI as the primary receiver under Page Handover Protocol, then retry the persistent menu.
The file type is not supported on Messenger.Fix: Use a supported format/extension and retry.
You are sending with a notification tag without OTN permission.Fix: On the Facebook Page, go to Settings → Advanced messaging and request one-time notification permission.
The connected Facebook user is not a Page admin (or 2FA is required).Fix: Connect with a Page admin account and enable 2FA if the business requires it.
Comment automation allows a single reply message (Facebook limit).Fix: Reply with one text (optionally with a button that continues into a Flow). Do not chain multiple messages or a Continue node from the start step of the comment tool.

​
WhatsApp

Free-form WhatsApp Flows do not support open-URL buttons.Fix: Put URL buttons only in approved WhatsApp template messages.
Template body or header parameters do not match the approved template (missing text, wrong header media type, and similar).Fix: Open the template in Flow Builder and fill every variable. Match header type (image/video/document) to the approved template.
Free-form session messaging window expired.Fix: Send an approved template, or wait until the contact messages you again.
You tried to send an empty WhatsApp message.Fix: Add text (or a valid template) before the send step.
WhatsApp rejects GIFs and unsupported audio codecs.Fix: Images: PNG or JPEG. Audio: ogg (opus), mpeg, amr, mp4, or aac.
Fliqr AI could not download the media URL.Fix: Use a publicly reachable URL (try another host/domain). Confirm the file still exists.
WhatsApp product lists are capped at 30 items per message.Fix: Split the catalog presentation across multiple messages or sections under the limit.
Catalog is not linked correctly, or Meta requires extra commerce compliance.Fix: Connect the catalog in WhatsApp Manager and add products (spreadsheet import is recommended). Follow Meta’s catalog help docs for compliance.

​
External Request and APIs

The HTTP call did not complete successfully.Fix: Verify URL, method, headers, and body. Test the endpoint outside Fliqr AI, then recheck Response Mapping. See External requests and Dynamic content.
OAuth grant for Google Sheets is stale.Fix: Disconnect and reconnect the Google Sheets integration.
The API key is wrong or revoked.Fix: Paste a valid MailerLite API key in the integration settings.

​
Email and SMS

The Flow tries to send SMS without Twilio or ClickSend connected.Fix: Connect an SMS provider under channel / integration settings.
SMTP username/password is wrong. For Gmail, normal passwords often fail.Fix: Use a Google App Password in Fliqr AI SMTP settings when using Gmail.
The contact has no email, or has not opted in.Fix: Confirm {{email}} is set and the contact is opted in for email.

​
Account and ads

Demo / trial workspaces allow a limited number of contacts.Fix: Upgrade the plan or remove test contacts you no longer need.
The Facebook login session expired (password change or security reset).Fix: Reconnect the bot / Facebook channel in Settings → Channels.

​
Quick checklist

  1. Is the Message / template block empty or missing variables?
  2. Are you inside the channel messaging window?
  3. Is the channel still connected under Settings → Channels?
  4. For APIs — do headers, body, and JSON paths match a real test response?
  5. Check {{last_error_log}} on the contact if you need the last runtime error in a Flow.

​
Next

External requests

Build and map API calls correctly.

System fields

Use the right placeholders in messages and mappings.