# Serve your assistant on your own domain | Busymate AI

Source: https://busymate.ai/tr/docs/guides/custom-domain
Last modified: 2026-09-04T13:24:41+03:00
Every Busymate AI workspace answers at its own address on our domain from day one. To serve bro at your own address, you claim it in the Console, add two DNS records at your domain provider — one TXT record to prove you own the domain and one CNAME record to route traffic to us — verify, and the certificate (TLS) is set up for you. Then you point your embed at the new address.

## Your address on our domain

Your workspace's `<slug>.busymate.ai` address works from the moment the workspace exists. An address that is not yet mapped to a workspace stays plain and unbranded — your customers never see a half-branded window.

## 1. Claim your address

1. Open [Console → Domains](https://busymate.ai/console/domains) for your workspace.
2. Add the address, for example `ai.yourdomain.com`, and choose whether it is your primary one.
3. The Console returns a TXT value and a CNAME target. Copy both from the screen — never type them from memory.

From your AI tools the same step is `request_tenant_custom_domain` with `tenant_id`, `host`, `is_primary` and `confirm`. An address the platform owns, or one another workspace already claimed, is refused.

## 2. Add the DNS records

At your domain provider, add the two records exactly as returned:

| Type | Name | Value |
|---|---|---|
| TXT | `_busymate-support.ai.yourdomain.com` | the TXT value from step 1 — proves you own the domain |
| CNAME | `ai.yourdomain.com` | the CNAME target from step 1 — routes traffic to us |

Leave no other record at the CNAME name. Changes usually take minutes to spread; some providers cache longer.

## 3. Verify

Back in Domains, press **Verify** (or call `verify_tenant_custom_domain`). We look the TXT record up ourselves; while it is missing you get a pending result that names the exact record to add. On success the address is mapped and the certificate (TLS) is set up automatically — nothing to upload.

Before retrying, confirm the records resolve from outside your network with any DNS tool.

## 4. Move your embed

1. Change the embed script's `src` on your site to `https://ai.yourdomain.com/embed/v1.js`, and any hosted links to the new address.
2. If your site's addresses changed too, add them to your allowed list and publish a new version.

The snippet below is the embed with placeholder values; the Console's Integration section renders it with your address:

{{snippet:embed-script}}

## Search and canonical

Keep one primary address. Your workspace's search setting decides whether the address is indexable; its `sitemap.xml` and `robots.txt` are generated from your settings.

## Remove

Domains → Remove (or `remove_tenant_custom_domain`) unmaps the address and cleans up. Your address on our domain keeps serving.

## Troubleshooting

- **A 200 on `/` is not proof.** Until the address is mapped and published, signed-in paths answer 403 with `unknown_host`. Test a signed-in path, not the landing page.
- **TXT not found** — check the exact record name (`_busymate-support.` plus your address) and wait for the change to spread.
- **CNAME conflict** — an A, AAAA or TXT record at the same name blocks the CNAME at most providers.

## Verify

1. `https://ai.yourdomain.com/` renders your brand, not the plain shell.
2. A signed-in path at the new address no longer answers 403.
3. `https://ai.yourdomain.com/sitemap.xml` lists your address.

<!-- qa:start -->
### Do I need DNS for the address on our domain?
No. `<slug>.busymate.ai` is live from the start. DNS is only for your own domain.

### Who sets up the certificate?
We do, automatically, once verification succeeds. There is nothing to upload or renew.

### Can I keep both addresses?
Yes. Mark one primary; both answer with your brand. Links and the sitemap follow the primary one.

### Why does my address answer 403?
It is not mapped yet, or the version that maps it is not published. Verify the domain and publish; the 403 disappears.
<!-- qa:end -->

## Next

- **[Getting started](https://busymate.ai/tr/docs/getting-started)** — workspace, web address, sign-in, systems, publish.
- **[A white-label AI assistant on your own domain](https://busymate.ai/tr/platform/white-label)** — why the domain is the product.
- **[White-label AI for agencies and resellers](https://busymate.ai/tr/solutions/agencies-white-label)** — one address per client.
