Facebook Messenger logo
Facebook Messenger
Facebook Messenger is a chat-family channel. Messages merge into your Qor’s canonical chat — the web UI and TUI see them alongside every other chat-family channel.

​
At a glance

Familychat-family
Setup sourceMeta Developer Portal
InboundWebhook / long-poll / socket — see below
Outboundqorven channels send --channel facebook or auto-reply from the agent loop
MediaText + attachments (where the transport supports it)
Group chatsGroup handling →

​
Setup

1

Create the channel binding in Settings → Channels

In the web UI: Settings → Channels → Add channel → Facebook Messenger. Paste the credentials from Meta Developer Portal.
2

Configure the webhook URL (if the provider pushes events)

Qorven exposes POST /v1/webhooks/facebook on the web listener. Use your public URL (or a tunnel like Cloudflare / ngrok for dev).
3

Assign a Qor

Bind this channel to one Qor. That Qor receives every inbound message. You can always delegate onward.
4

Test with one message

Send a message from Facebook Messenger. Watch it appear in the web UI canonical chat with the Facebook Messenger badge.

​
Routing & overrides

By default, every inbound Facebook Messenger message is routed to the Qor bound to this channel. You can override:
  • By sender — route VIP senders to a different Qor
  • By keyword — “URGENT” → escalation Qor
  • By group — if it’s a group chat, use group-scoped settings
See Channel routing →.

​
Common issues

  • Check qorven channels status facebook — is the binding active?
  • Check the webhook URL is reachable from the internet (provider needs to hit it)
  • Check /var/log/qorven/channels.log for webhook 4xx/5xx entries
  • Rate limits: every channel has a per-tenant quota; see quotas
  • Check the Qor has the send_message tool in its allowlist
  • Check the LLM isn’t emitting malformed tool calls — qorven logs --filter agent.loop.tool_error
  • Check the channel binding’s credentials haven’t expired (OAuth channels rotate tokens)
  • Usually webhook retries. Qorven dedupes by (channel, external_id) but some providers send different IDs on retry. Open an issue with logs.
Logo displayed under nominative fair use. See trademarks & attribution for owner, source library, and removal requests.

All channels

Catalog + concepts.

One Qor, one chat

How chat-family channels merge.

Channel routing

Custom routing rules.

qorven channels CLI

Scripted channel management.