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

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.

Next Steps

• Send Text Messages -- sending messages across channels
• Carousel Messages -- multi-card carousels on Messenger
• Instagram DM -- related Instagram setup