Skip to main content

Instagram DM

Connect your Instagram Business Account to SendSeven to send and receive Direct Messages. Instagram DM supports text, images, video, buttons, carousel, and reactions.

Prerequisites​

  • An Instagram Business Account linked to a Facebook Page
  • Facebook Login OAuth completed in the SendSeven dashboard
  • A SendSeven API token with channels:create scope

Setup​

Instagram channels are configured through the SendSeven dashboard using the Facebook OAuth flow:

  1. Log in to SendSeven
  2. Navigate to Settings > Channels
  3. Click Add Channel > Instagram
  4. Complete the Facebook Login flow and grant the required permissions
  5. Select the Instagram Business Account to connect
info

Instagram uses the Facebook Page subscription for webhooks. When you connect an Instagram Business Account, SendSeven automatically configures the webhook through the associated Facebook Page.

Instagram Capabilities​

FeatureSupported
TextYes
ImageYes
VideoYes
AudioNo
DocumentNo
ButtonsYes
List messagesNo
CarouselYes (generic template)
ReactionsYes
Read receiptsYes

Contact Identifiers​

Instagram contacts are stored with two identifiers:

FieldDescription
instagram_idInstagram-scoped ID used for API calls
instagram_usernameThe @handle used for display purposes

Required Scopes​

ScopePurpose
channels:createCreate an Instagram channel
channels:readView channel details
messages:createSend messages through Instagram DM

Send an Instagram DM​

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_ig_789",
    "channel_id": "ch_ig_001",
    "text": "Thanks for your interest! Here is more info about our products.",
    "message_type": "text"
  }'
warning

Instagram has its own messaging window rules. You can respond to a user's message within 24 hours. After that, messaging may be restricted depending on the type of interaction.

Next Steps​