Log in

Bots

Custom domains

Custom domains let you serve your bot's chat widget and embed from a domain you control, like chat.yourcompany.com, instead of the default embed.chatthing.ai. This gives your bot a fully white-labelled experience that matches your brand.

Prerequisites

🚨

Paid addon required

Custom domains are available as a paid addon. You can purchase the Custom Domain addon from your billing page. Each addon provides one custom domain slot across your team.

Adding a custom domain

  1. Navigate to your bot's dashboard and click the Channels tab.
  2. Open the Web channel settings.
  3. Scroll down to the Custom domains section.
  4. Enter your desired domain in the Domain field (e.g., chat.yourcompany.com).
  5. Click Add domain.

custom domains section

After adding your domain, Chat Thing will create a Cloudflare custom hostname and generate the DNS records you need to configure.

Setting up DNS records

Once you've added your domain, you'll need to add three DNS records to your domain's DNS provider (e.g., Cloudflare, GoDaddy, Namecheap, etc.).

1. Certificate validation TXT record

This record is used by Cloudflare to issue an SSL certificate for your domain.

  • Type: TXT
  • Name: The value shown in the UI (typically _acme-challenge.yourdomain.com)
  • Value: The value provided in the UI
ℹ️

Note

The certificate validation record values may take a few moments to generate after adding your domain. The UI will show a loading spinner while they are being generated.

2. Hostname ownership TXT record

This record verifies that you own the domain.

  • Type: TXT
  • Name: The value shown in the UI
  • Value: The value provided in the UI

3. CNAME record

This record points your domain to Chat Thing's embed server.

  • Type: CNAME
  • Name: Your domain (e.g., chat.yourcompany.com)
  • Target: embed.chatthing.ai
ℹ️

DNS propagation

DNS changes can take a few minutes to propagate. If verification fails on the first attempt, wait a few minutes and try again.

Verifying your domain

After adding all three DNS records, click the Verify DNS button next to your domain. Chat Thing will check that your DNS records are configured correctly.

Your domain will go through the following statuses:

  • Pending - Domain has just been added and is awaiting initial setup.
  • DNS pending - DNS records have been detected but the SSL certificate is still being issued.
  • Active - Your domain is fully configured and ready to use.
  • Failed - There was an issue verifying your domain. Check your DNS records and try again.

Using your custom domain

Once your domain status is Active, the embed code snippets shown in the UI will automatically update to use your custom domain.

custom domain active with embed code

You can embed your bot using either an iframe or the chat widget, just as you would with the default domain:

Iframe embed:

<iframe src="https://chat.yourcompany.com/bots/YOUR_BOT_ID/embed" width="100%" height="600" frameborder="0" allow="clipboard-write; microphone;"></iframe>

Chat widget:

<script>window.chatThingConfig = { url: "https://chat.yourcompany.com" };</script>
<script src="https://chat.yourcompany.com/chat-widget.js" type="text/javascript" id="YOUR_BOT_ID" async defer></script>

Managing your domains

Removing a domain

To remove a custom domain, click the Remove button next to the domain you want to delete. This will remove the domain from your bot and free up the addon slot for use with another domain.

Domain quotas

Each Custom Domain addon you purchase provides one domain slot across your team. You can see how many slots you've used and how many are remaining in the Domain usage section. To add more domains, purchase additional Custom Domain addons from your billing page.