Skip to main content
At the end of this page, you have a link and a QR code that open your published agent as a full-page conversation. The same page can also run on a subdomain you own, which needs a DNS change and an iframe snippet.

​
Before you start

Before you start, sign in to the dashboard and select the organization you want to work in.
1

Open the Agent Link view

In the builder sidebar, select Distribute. The Agent Link view opens first, under the Web group.
2

Copy the link

In the Agent Link card, select the copy icon next to the link field.
The icon changes to a check mark and the message Link copied to clipboard appears.
3

Open the link to test it

Select the open icon next to the copy icon. The agent opens as a full-page conversation in a new tab.
The Share card sends the same link to common destinations without leaving the view.

​
Download a QR code

The QR Code card shows a code that opens your agent when scanned. Select a size before you download. The message QR code downloaded as PNG or QR code downloaded as SVG confirms the download.

​
Serve the agent on your own subdomain

The On Your Domain view, under the same Web group, serves the full-page agent from a subdomain you own, such as chat.example.com. The view has no input fields. It lists three steps and gives you an iframe snippet with your agent filled in.
1

Add a CNAME record

In your DNS provider, add a CNAME record for your subdomain. Point it at the host that step 1 in the view shows.
2

Configure the subdomain

Step 2 in the view points you to General settings, but the dashboard has no subdomain field. Complete steps 1 and 3, then ask Tars support to map your subdomain.
3

Embed the iframe

Select the copy icon at the top right of the snippet. Add the snippet to any page on your domain.
The icon changes to a check mark and the message Code copied to clipboard appears.
The iframe loads the same full-page conversation as the agent link. To place a launcher-style widget on your site instead, see Embed the widget.

​
Verify

Open the agent link in a private browser window. The agent starts the conversation exactly as end users see it. Scan the QR code with a phone camera to confirm it opens the same page. If you set up your own subdomain, open a page that contains the iframe and confirm the conversation loads inside it.