Deploying is covered in Build an AI agent. This page is about the second one.
Plan limits, before you build
Both limits are enforced at the moment you publish, not while you build. It is entirely normal to design four agents on Free and discover the cap only when you deploy the second — so check the numbers first. Published agents — deployed agents live in your workspace at any one time:
On Free, the message reads “Your Free plan can publish 1 agent or automation at a time. Drafts are always unlimited. Upgrade to Essential to publish more.”
Read that carefully, because it describes a limit you cannot actually reach on Free: the builder itself needs a paid plan. A Free workspace opening Agent Builder gets an Agent Studio upgrade panel — “Build AI agent virtual assistants on any paid plan.” — so there is no canvas to draft on. Unlimited drafting is true from Essential upward, not on Free.
Public agent UIs — chat assistants exposed on the web:
On Free the Public UIs button is not shown at all: “Public Agent UIs are available on the Essential plan and above.”
Publish a public UI
1
Open Public UIs
Select Public UIs on the Agent Builder page. The Public Agent UIs screen shows a live preview beside the editor and a badge counting how many of your allowance you have used.
2
Choose an agent
Under Choose an agent, select Enable on the one you want. Only deployed agents that are set to de-identified and use safe tools can be made public; anything ineligible says why on its row. A public agent can check availability, book, and say when the clinic or a provider is away (Get away dates — the dates, never why); it can never move, cancel or confirm an existing appointment, or change events, tasks or Out of Office.
3
Set the address
Your link appears under Your link. On Team you can set your own address; on lower plans the address is generated and Regenerate issues a new random one. Custom links are a Team feature.
4
Write what visitors see
Under Content, set the Title, Headline, Welcome message, Input placeholder, up to six Suggested prompts and a Footer note (your own note, which stays as you wrote it). The Show “Powered by ClinikEHR” line sits beneath it: it stays on for Free, Essential and Starter practices, and Team and Enterprise can turn it off. Under Branding, set an accent colour, a Theme and a logo.
5
Set the abuse caps
Under Access & limits, keep Live on, and set Messages / minute per visitor, Daily messages per visitor and a Monthly run cap. Turn on Require email to chat if you want visitors identified before they can ask anything — disposable addresses are blocked.
6
Save changes
Select Save changes. The preview and the live page both update.
Put it on your website
The Add to your website card gives you what your plan allows: a widget snippet on Essential, and on Team the full widget options (Floating button or Inline on the page, its position and its Button text) plus the raw<iframe>. Paste the snippet into your site’s HTML. See Embeds.
A public UI can also live on your own domain — assistant.yourclinic.com — via Custom domains.
Take one offline
Live switches the page off without losing the configuration. Take offline & remove deletes the public UI entirely: the link stops working immediately, and a new one later gets a new address.Bookings made through the assistant
An assistant that books appointments follows the same rules as your booking page:- It asks for the visitor’s name and email. If the email matches one of your clients, the booking goes on that client’s record and is marked Email not confirmed for your team to check — the assistant never tells the visitor whether they are a client, and never uses a record from another clinic.
- Prices and visit lengths come from your services. A service with options needs an option chosen, and add-ons are added under their service.
- Services set for existing clients only, hidden services and times inside your minimum notice are not booked from the chat.
- If your booking page requires a card on file, the assistant asks the visitor to book on your booking page instead, because a card can’t be taken in a chat.
What a visitor sees while they wait
Replies are written into the page as the assistant produces them, rather than appearing all at once when it has finished. If the assistant needs to look something up first — availability, your services, your booking policy — the visitor sees a short line saying so, then the answer arrives word by word. Two things worth knowing:- The finished reply is what counts. If the assistant says something like “let me check that for you” before looking something up, that line is replaced by the real answer — the page always ends up showing exactly the reply recorded on the Runs page.
- Nothing about your limits changes. A streamed reply is still one message against Messages / minute per visitor, your daily limit and your monthly cap, and it debits the same credits.
The QR code
The QR code card gives you a code people scan with a phone camera to open your assistant page. A chat is counted as Started a chat from the code when the visitor sends the first message of a new chat. The counts are kept for each assistant.- It is in your assistant page’s own colour, with your logo in the middle. If that colour is too light for a camera to read reliably, the code is drawn in near-black and the card says so. If your logo cannot be loaded, the code is drawn without it and the card says that too.
- Only a code that has been checked is offered. Before Download PNG or Print appear, the finished picture is read back on your device and must open exactly the address printed under it. If that check fails, the card says the code could not be checked and offers nothing to print.
- It always uses the saved address. Change the address or the look, save, and the code is drawn again. Anything you have typed but not saved is never printed.
- If the page is switched off, the code still works the moment you turn it on; until then anyone who scans it sees that the page is unavailable, and the card warns you.
Poster and card
Select Poster and card to open Print your code. Choose Poster (A4) for a wall or window, or Reception card (A6) for the front desk, then Download PDF or Download PNG. Both carry your assistant name and logo in your colour, the line “Scan to chat with us”, and the short address for people without a camera. Everything is in words, so it reads the same on a black-and-white printer. The file is made on your device; nothing is uploaded.How many people used it
Owners and managers see Last 30 days on the card: Opened from the code and Started a chat from the code. These are counts only. No name, device or address is kept with them. The counts are approximate, and refreshing the page in the same tab counts once.Check it worked
- The counter at the top of Public Agent UIs has gone up.
- Opening your link in a private browser window shows the branded chat, with your headline and suggested prompts.
- A message sent from that window appears on the Runs page and debits credits.
If something goes wrong
Deploy failed because of a limit
Deploy failed because of a limit
You have reached your plan’s published-agent cap (Free 1). Take an agent offline, or move up a plan. Nothing you have drafted is lost.
My agent isn't in the list to enable
My agent isn't in the list to enable
Only deployed agents can be made public, and only ones set to de-identified that use safe tools. Deploy it first, and check the reason shown on its row.
I can't set my own address
I can't set my own address
Custom addresses are a Team feature. On Essential, use the generated link, or Regenerate for a different one.
Visitors are burning through credits
Visitors are burning through credits
Lower Messages / minute per visitor and Daily messages per visitor, set a Monthly run cap, and turn on Require email to chat. Switching Live off stops it immediately.
Related
Build an AI agent
Drafting, triggers, and deploying inside your workspace.
Agent credits
What public conversations cost you.
Custom domains
Serve the assistant from your own address.
Change your plan
Raise the publishing and public-UI limits.