Share a hosted chatbot link

What it is

The hosted page is Agentency's own chat page for your chatbot, at /agent/{handle}. It is a complete, branded chat experience on a web address you can send to anybody.

Visitors do not sign in to Agentency and do not need an account. They open the link and talk.

It is the fastest way to put a chatbot in front of real people, and it is the one public surface available on every plan including Free. If you are not sure where to start, start here.

When you would use it

• A QR code on a poster, a table card, or a receipt.
• A link in your social media bio.
• An email signature.
• A support link in an order confirmation.
• Sharing with a colleague or client for feedback before you touch your website.
• Any situation where editing your website's theme is more effort than the task deserves.

Where to find it

Open Dashboard → Chatbots → your chatbot → Integrations → Messaging → Direct link.

Before you start

Three things must be true before the link works for anyone else:

1. The chatbot is Active. A draft or paused chatbot returns a 404 to visitors, however well it works for you.
2. Knowledge is trained. An active but untrained chatbot loads and politely explains it cannot answer yet — see The hosted page says the chatbot is not ready.
3. You have tested it yourself in a private window. Your dashboard session hides both of the above.

Steps

1. Open Dashboard → Chatbots → your chatbot → Playground and set the chatbot to Active.
2. Go to Integrations → Messaging. Direct link is the first card and it is always visible, on every plan.
3. Open the card and copy the /agent/{handle} URL.
4. Optionally set who may open it — public, secret link, shared password, or named accounts. See Control who can open the hosted page.
5. Open the URL yourself in a private browsing window.
6. Ask a real question. You should land on a session URL as the conversation starts.
7. Find that conversation under Conversations. Its channel is the direct link, not the website widget.
8. Now share it.

What you will see

Direct link is the first card on Integrations → Messaging. The drawer shows the full URL, a copy button, and the access options.

Opening the URL as a visitor gives a full-page chat carrying your chatbot's name, avatar, and colours. Once a conversation starts, the address gains a session identifier — that is normal, and it is how the visitor's own conversation is kept separate from everyone else's.

Making the link presentable

The default URL contains the chatbot's numeric id. It works, but /agent/47 is not something you want printed on a poster.

Set a handle — a short readable slug — and the URL becomes /agent/your-brand. That is worth doing before you print anything or record it in a video. See Change the hosted page handle.

One caution about print: renaming the handle breaks the old URL. If you expect to rebrand, either settle the handle before you print, or accept a reprint later. Old /bot/{id} links keep redirecting, but an old handle does not.

Where it fits among your options

Surface	Needs	Plan
Hosted page	A URL and an active chatbot	Every plan, including Free
Website widget	A script on your site plus an allowed-domain list	Paid
Messaging apps	A connected channel	Paid, availability varies

The hosted page and the widget draw on the same knowledge, the same instructions, and the same message credits. They differ in how the chatbot is identified and how access is controlled. See Hosted page vs website widget.

There is no reason to choose only one. Many people share the link on day one and add the widget a week later once the answers are good.

Limits and plan notes

• Draft or inactive chatbots return 404. This is deliberate: an unfinished chatbot should not be reachable.
• An active but untrained chatbot loads and explains itself rather than 404ing.
• The direct link is not plan-gated. Free keeps it; Free locks the website script and the plugin integrations.
• Conversations here spend message credits like any other channel. See How message credits work.
• Public message caps apply, so a link that suddenly goes viral is bounded rather than unlimited.
• Access control is optional and off by default. Anyone with the URL can chat until you say otherwise.

Common problems

The link shows a 404.

The chatbot is not active. Activate it on the Playground tab. See The hosted page is 404.

It works for me and 404s for everyone else.

You are signed in and they are not. Always test in a private window — that is the only view that matches a visitor's.

I am on Free and thought I had no public chat.

You have this link. Free locks the website script and the plugin integrations, not the hosted page.

The chatbot loads but says it cannot answer yet.

Active but untrained. Add knowledge and wait for training to finish.

I shared the link and now anyone can use it.

That is the default. Add a gate — see Control who can open the hosted page.

Conversations from the link are not in my list.

Check the channel filter on the Conversations page, and confirm you are on the same chatbot and the same workspace.

Can I embed this page in my own site?

Yes, in an iframe — useful when a site builder will not let you add a script. See Iframe embed and direct link.