Skip to main content
Messenger uses the same organization API key and webhook registration endpoints as WhatsApp. Use the FlowIQ API for all Messenger messages and events, whichever way your Facebook Page is connected to FlowIQ.

​
Authentication and recipients

Send Authorization: Bearer fiq_YOUR_API_KEY to https://api.flowiq.live. The key identifies your organization; no organization ID is needed. Messages go to an existing Messenger contact: someone who has messaged your Facebook Page. Use either contact_id (the FlowIQ contact UUID) or messenger_id (the Page-scoped ID, as a string). A name, email address or phone number is not a Messenger recipient ID. Use Messenger Conversations to list contacts and obtain their IDs.

​
Messages and history

Text supports 1–2000 characters. Media requires a public HTTPS URL; send captions as separate text messages. Messenger permissions and the 24-hour messaging window still apply. WhatsApp templates, calls and broadcasts are not supported by these Messenger endpoints. History comes from messages already stored in the FlowIQ inbox. Reading it does not mark messages as read or import earlier Messenger history. Only Messenger messages are returned, including when a contact also has a WhatsApp or Instagram conversation.

​
Webhooks

Use the existing webhook API with platform: "messenger":
Receive incoming messages, outgoing content, send confirmations and recorded receipt changes. Messenger Events documents each event and its identifiers. Delivery uses the same authentication options, static headers, HMAC signature verification, delivery log and retries as WhatsApp. List registrations using GET /get-webhooks?platform=messenger, and remove one using DELETE /set-webhooks with its id. See Create Webhook, List Webhooks and Delete Webhook.