Skip to main content

Live Chat Widget

The SendSeven Live Chat widget lets you embed a real-time messaging interface on your website. Visitors can start conversations directly from your site, and your team can respond from the SendSeven dashboard or API.

Prerequisites​

  • A SendSeven account
  • Access to your website's HTML to add the widget script
  • A SendSeven API token with widgets:create scope (for API-based setup)

Setup​

Dashboard Setup​

  1. Log in to SendSeven
  2. Navigate to Settings > Channels > Live Chat
  3. Configure the widget appearance (colors, position, greeting message)
  4. Copy the embed code
  5. Paste the embed code into your website's HTML, just before the closing </body> tag

Widget Capabilities​

FeatureSupported
TextYes
ImageYes
DocumentYes
AudioYes
VideoYes
ButtonsYes
List messagesYes
CarouselNo
ReactionsYes
Read receiptsYes
Typing indicatorYes

Responding to Live Chat Messages​

Live chat messages appear in the Conversations view alongside messages from other channels. You can respond via the dashboard, mobile app, or API:

curl -X POST "https://api.sendseven.com/api/v1/messages" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "conv_livechat_001",
    "text": "Hi! Welcome to our site. How can I help you today?",
    "message_type": "text"
  }'
tip

Live chat is the only channel that supports both buttons and list messages alongside the full set of media types. It is the most feature-rich channel for interactive conversations.

Visitor attachments​

Choose which kinds of files website visitors may send in live chat. Each category is on until you switch it off.

curl "https://api.sendseven.com/api/v1/channels/ch_livechat_001/live-chat-settings" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00"
{
  "channel_id": "ch_livechat_001",
  "attachments": { "images": true, "audio": true, "video": true, "documents": true }
}

Update with PUT. Only the categories you send change, and the full settings come back:

curl -X PUT "https://api.sendseven.com/api/v1/channels/ch_livechat_001/live-chat-settings" \
  -H "Authorization: Bearer s7_api_a1b2c3d4e5f6789012345678abcdef00" \
  -H "Content-Type: application/json" \
  -d '{ "attachments": { "video": false } }'
CategoryMax size per file
images10 MB
audio25 MB
video50 MB
documents25 MB

The widget reads these switches from its public settings as live_chat_attachments, one entry per category with enabled, max_size_bytes and accept (the file extensions and MIME types for the file picker).

Errors: 404 when the channel doesn't exist, 422 when it isn't a live chat channel or the body has unknown keys or non-boolean values.

Appearance, layout & channels​

The widget's look and feel — layout style, corner radius, the size it opens at, the agent-type transparency indicator, and whether visitors can react to messages — is configured with a set of optional, backwards-compatible options. The widget can also offer RCS as a channel. See Widget Appearance & Channels for the full reference.

Required Scopes​

ScopePurpose
widgets:createCreate and configure chat widgets
widgets:readView widget configuration
widgets:updateUpdate widget settings
channels:readRead the visitor attachment settings
channels:updateChange the visitor attachment settings
messages:createSend messages in live chat conversations

Next Steps​