Documentation

Chat

  • Getting Started
  • Installation
  • Core Concepts
  • Escalation System
  • Widget Keys
  • Secret Keys (sk_)
  • REST API
  • Channels & Integrations
  • Messaging Platform API

Voice

  • Voice Agent
  • Setup Guide
  • Phone Numbers
  • Outbound Campaigns

Platform

  • Billing & Pricing
  • Glossary
  • FAQ

Widget Keys

Manage and deploy your chatbot using widget keys.

What is a Widget Key?

A widget key is a secure token that allows you to embed your chatbot on your website. Each key is unique and can be configured independently with different settings, domains, and message limits.

Creating a Widget Key

  1. Go to Widget Keys in your dashboard
  2. Click "Create New Key"
  3. Give your key a name (e.g., "Production Website")
  4. Set allowed domains
  5. Configure message limits
  6. Click "Create"

Key Configuration

Allowed Domains

Specify which domains can use this widget key. This prevents unauthorized use of your key on other websites.

Message Limits

Set daily and monthly message limits for this key. Useful for managing costs and preventing abuse.

Custom Styling

Customize the chatbot appearance with your brand colors, logo, and welcome message.

Key Rotation

For security, you can rotate your widget keys. The old key will continue to work for 7 days during the grace period, giving you time to update your website.

Never share your widget keys publicly. Treat them like passwords.

Ready to transform your customer experience?

Join businesses already using Sampan to serve customers 24/7 and boost revenue with AI.

sampan.club

AI-powered customer service for businesses.

SAMPAN TECH
202603046389 (003825593-A)

Product

© 2026 SAMPAN TECH, trading as Sampan Club (sampan.club). All rights reserved.