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
});