SilentChat

Quickstart: Set up chat widget

Last updated: September 9, 2026

Follow these steps to go live in a few minutes.

Step 1: Create Widget

  1. Go to Settings → Widgets
  2. Click "Create Widget"
  3. Enter a name (e.g., "Homepage" or "Support")
  4. Configure the basic settings:
    • Primary color: Matching your branding
    • Position: Bottom right (default) or bottom left
    • Welcome message: The text that greets visitors
    • Language: German, English, etc.

Step 2: Add Domain

  1. In the widget details, go to the "Domains" tab
  2. Click "Add Domain"
  3. Enter your domain (e.g., www.example.com)
  4. Verify Domain: Add the displayed DNS TXT record
    • Record type: TXT
    • Name: _silentchat-verify
    • Value: The displayed verification code
  5. Click "Verify" (DNS propagation can take up to 24h)

Step 3: Embed Snippet

  1. Click "Show Snippet" in the widget
  2. Copy the JavaScript code
  3. Add the code before the </body> tag of your website:
<script
  src="https://cdn.silentchat.de/silentchat.min.js"
  data-widget-key="pk_YOUR_WIDGET_KEY"
  data-api-url="https://api.silentchat.de"
  data-ws-url="wss://ws.silentchat.de"
  async
></script>

For Single-Page Apps (React, Vue, Angular): The script can also be placed in the <head> — it initializes automatically.

Step 4: Test

  1. Open your website in a new browser tab
  2. The chat widget should appear at the bottom right (or left)
  3. Send a test message
  4. Switch back to the SilentChat Dashboard — the conversation appears in the inbox

Next Steps

Common Issues

Widget not appearing?

  • Check if the domain is verified
  • Check the browser console for errors
  • Ensure no ad-blocker is blocking the script

Messages not coming through?

  • Check if at least one agent is online
  • Check the widget status (active/inactive)
Quickstart: Set up chat widget — Help Center — SilentChat | SilentChat