Chat widget
How visitors use the public DocsChat widget on your site.
Opening chat
Public URL pattern:
https://your-domain/chat/{agent-slug}
Example: http://localhost:3000/chat/support
Open the link in a browser or tap it from your site menu.
What you can do
- Welcome message — set by the site owner
- Suggested questions — tap a chip to ask a common question
- Ask in your own words — answers include links to source documents
- Attach a file (Hobby plan and above) — upload a PDF for context in that chat
- Talk to a person — when the bot cannot help, you may be offered a transfer to support staff
Source links in answers
Assistant replies show which document passages were used. You can open the links to verify the answer.
Transfer to support
When the bot reaches its limits, you may see an option to connect with a human agent. Accepting sends the conversation to the site owner's helpdesk with the full chat history.
Plan limits you might notice
| Feature | Minimum plan (site owner) |
|---|---|
| Basic chat | Free |
| File attachments | Hobby |
| Transfer to helpdesk | Standard (with integration connected) |
If the chat says messages ran out, the site owner must upgrade or add credits — you do not pay DocsChat directly.
Embed on your site (for site owners)
Link or iframe to /chat/{slug}:
<a href="https://your-domain/chat/support">Ask support</a>
<iframe
src="https://your-domain/chat/support"
width="400"
height="600"
style="border:1px solid #e2e8f0;border-radius:8px"
></iframe>
White-label (Enterprise add-on)
When enabled, the Powered by DocsChat badge is hidden on the widget.
See also Visitor FAQ.