Facebook Messenger

Connect your Facebook Page to SendSeven to send and receive messages through Facebook Messenger. Messenger supports text, images, documents, video, buttons, carousels, reactions, and stickers.

Prerequisites

• A Facebook Page for your business
• Page Admin access
• A SendSeven API token with channels:create scope

Setup

Messenger channels are configured through the SendSeven dashboard:

1. Log in to SendSeven
2. Navigate to Settings > Channels
3. Click Add Channel > Messenger
4. Complete the Facebook OAuth flow
5. Select the Page to connect

You can also create the channel via API if you already have the Page credentials:

curl -X POST "https://api.sendseven.com/api/v1/channels" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "messenger",
    "name": "Company Messenger",
    "config": {
      "page_id": "123456789",
      "page_access_token": "EAABx..."
    }
  }'

Messenger Capabilities

Feature	Supported
Text	Yes
Image	Yes
Document	Yes
Audio	Yes
Video	Yes
Buttons	Yes
List messages	No
Carousel	Yes (generic template)
Reactions	Yes
Stickers	Yes
Read receipts	Yes
Comments to private reply	Yes (beta, incl. buttons and images)

Comments on your Page posts

Messenger channels can also receive comments on your Facebook Page posts and answer the commenter with a one-time private reply — which, unlike Instagram, may carry buttons, quick replies or an image. This requires the Page to be subscribed to the feed webhook field.

See Comments to Private Replies.

Required Scopes

Scope	Purpose
channels:create	Create a Messenger channel
channels:read	View channel details
messages:create	Send messages through Messenger

Send a Messenger Message

curl -X POST "https://api.sendseven.com/api/v1/messages" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "contact_fb_456",
    "channel_id": "ch_msgr_001",
    "text": "Hi! Thanks for reaching out through our Facebook page.",
    "message_type": "text"
  }'

tip

Messenger supports carousel messages using the generic template format. This makes it ideal for product catalogs and multi-option displays. See Carousel Messages.

Channel health

If Meta rejects several messages to different contacts with a permission error (#10 or #200), the channel stays active but is reported as degraded: degraded_reason, degraded_since and degraded_error_code on the channel, and a connection_status: "degraded" item in GET /api/v1/channels/health. It clears with the next successful send. See Permission warning.

Next Steps

• Send Text Messages -- sending messages across channels
• Carousel Messages -- multi-card carousels on Messenger
• Instagram DM -- related Instagram setup
• Comments to Private Replies -- turn public Page comments into DMs