Custom Domain Setup & Branded Chat

By default, custom chat widgets run under Septra's API endpoints. For a white-labeled experience, you can host the chat interface under your own brand's subdomain (e.g., assistant.yourcompany.com).

---

The Custom Domain Lifecycle

┌───────────────┐      ┌─────────────┐      ┌─────────────┐      ┌───────────────┐
│ 1. Add Domain │ ───> │ 2. Add DNS  │ ───> │ 3. Automated│ ───> │ 4. Active SSL │
│ In Dashboard  │      │ CNAME Record│      │ Validation  │      │ Branded Chat  │
└───────────────┘      └─────────────┘      └─────────────┘      └───────────────┘

Our platform automates SSL/TLS certificate generation and renewal, keeping your domain secure without manual maintenance.

---

Setup Steps

1. Register the Domain in Septra

1. Open your dashboard and navigate to Settings > Custom Domains.
2. Click Add Domain.
3. Input your desired subdomain (e.g., chat.example.com).
4. The dashboard will generate a unique CNAME Value and verification string.

2. Configure Your DNS Provider

Log in to your DNS registrar (e.g., Cloudflare, GoDaddy, Namecheap) and create a new record:

• Record Type: CNAME
• Name / Host: The subdomain prefix (e.g., chat or assistant).
• Target / Value: The destination URL provided in the dashboard.
• TTL: Auto or 1 hour.

3. Automated Certificate Ingestion

Once the CNAME record is active, our server network automatically detects the DNS change.

• We generate a secure, private SSL certificate to enable HTTPS communication on your subdomain.
• SSL certificates validate and renew automatically every 90 days.
• Latency: DNS propagation and SSL provisioning typically take 15–45 minutes to complete.

4. Updating the Chat Widget Code

Once your domain status displays as Active in the dashboard, update your embed code's apiUrl parameter:

window.SeptraChat.mount({
  agentId: "YOUR_AGENT_ID",
  apiUrl: "https://chat.example.com/api" // Use your custom subdomain
});