Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Messenger

Facebook Messenger lets your business reach the ~1B monthly Messenger users from the same unified Orbit Messaging API used for SMS, WhatsApp, and email. Outbound replies are delivered through the Pages messaging surface; inbound user messages, postbacks, and referrals are POSTed to your webhook in real time.

​
Send a message

curl -X POST https://orbit-api.devotel.io/api/v1/messages/messenger \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "<recipient_psid>",
    "from": "<your_page_id>",
    "type": "text",
    "text": "Hi! Thanks for messaging us."
  }'

​
Response

{
  "data": {
    "message_id": "msg_msgr_abc123",
    "status": "queued",
    "channel": "messenger"
  },
  "meta": {
    "request_id": "req_xyz789",
    "timestamp": "2026-05-09T00:00:00Z"
  }
}

​
Capabilities

  • Text, media, files — text, image, video, audio, generic file attachments.
  • Buttons — postback, web_url, and phone_number button types via the structured-message body.
  • Generic templates — single + multi-card carousels with title, subtitle, image, and up to 3 buttons per card.
  • One-time notifications (OTN) — request and consume OTN tokens for a single follow-up outside the 24-hour window.
  • Persistent menu + greeting text — managed via the channel settings UI in the dashboard or directly via Graph API.
  • Webhook events — message.received, messenger.postback, messenger.referral, messenger.optin, plus message.delivered, message.read, message.status_updated.

​
Onboarding flow

  1. From the dashboard, navigate to Channels → Messenger.
  2. Click Connect Page. Meta’s OAuth dialog requests pages_messaging, pages_messaging_subscriptions, pages_show_list, and pages_read_engagement.
  3. Select the Page(s) you want to attach. Orbit subscribes the Page to webhooks automatically.
  4. Customise the persistent menu and greeting text from Channels → Messenger → Settings.

​
Messaging windows

TagWindowAllowed content
Standard 24hWithin 24h of the user’s last messageAny allowed content
HUMAN_AGENT7 daysReplies from a human agent only
MESSAGE_TAG (CONFIRMED_EVENT_UPDATE / POST_PURCHASE_UPDATE / ACCOUNT_UPDATE)AnytimeTagged transactional content only
One-time notification (OTN)One message per tokenPromotional and re-engagement content

​
Common errors

CodeHTTPCauseFix
MSGR_INVALID_PAGE_TOKEN401Page access token expired (Meta rotates ~every 60 days).Reconnect from Channels → Messenger → Reconnect.
MSGR_OUTSIDE_24H422Outbound message outside the standard 24h window without a tag.Switch to a MESSAGE_TAG, HUMAN_AGENT window, or use a consumed OTN token.
MSGR_PAGE_NOT_SUBSCRIBED409Webhook subscription dropped (rare; happens after page admin changes).Click Re-subscribe on the channel detail page.
MSGR_RECIPIENT_NOT_FOUND404The recipient PSID is invalid or the user has blocked the Page.Verify the PSID source; remove from your audience if blocked.
MSGR_RATE_LIMITED429Per-Page rate limit exceeded.Honour Retry-After; batch via campaigns when possible.

​
Pricing

Inbound messages are free. Outbound messages within the 24-hour standard window are free. Tagged or OTN messages are billed at PAYG rates per Meta’s pricing. See the pricing page.