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:createscope (for API-based setup)
Setup
Dashboard Setup
- Log in to SendSeven
- Navigate to Settings > Channels > Live Chat
- Configure the widget appearance (colors, position, greeting message)
- Copy the embed code
- Paste the embed code into your website's HTML, just before the closing
</body>tag
Widget Capabilities
| Feature | Supported |
|---|---|
| Text | Yes |
| Image | Yes |
| Document | Yes |
| Audio | Yes |
| Video | Yes |
| Buttons | Yes |
| List messages | Yes |
| Carousel | No |
| Reactions | Yes |
| Read receipts | Yes |
| Typing indicator | Yes |
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.
Required Scopes
| Scope | Purpose |
|---|---|
widgets:create | Create and configure chat widgets |
widgets:read | View widget configuration |
widgets:update | Update widget settings |
messages:create | Send messages in live chat conversations |
Next Steps
- Send Text Messages -- responding to live chat messages
- Interactive Messages -- buttons and lists in live chat
- Webhook Events -- receive live chat message events