hiy docs
A hiy is an AI twin of you. It answers your audience's questions in your voice, shows where each answer came from, and says "I don't know" instead of guessing.
These docs cover the whole journey: building and tuning a twin, putting it in front of people, embedding it in your product, and understanding what happens to the conversations it receives.
Find your starting point
Start with the short path from an empty account to a private twin you can test, teach, and publish.
Learn how a Support Agent uses your knowledge, signed visitor tokens, and handoff when a customer needs a person.
Build your own interface around the same streamed chat endpoint used by hiy's hosted pages and embed.
Understand what the AI label, citations, conversation storage, and contact form mean for you as a visitor.
Note
Use the search button in the header, or press ⌘K on a Mac and Ctrl+K on Windows and Linux. Every result points to the section that contains the answer, not just the top of its page.
Browse the complete guide
The guide is organised by the job you're trying to do. The sidebar follows the same order, so you can browse here first and continue reading from any page.
Guide 01
Support Agents
Your product, answering its own users inside your site — and the same engine turned inward for your team.
- Support AgentsAn agent for your product, inside your own site, with inbox handoff.
- EmbeddingThe embed snippet, sizing, and how it inherits your accent.
- The chat APIPOST /api/chat, minting visitor tokens, every limit by name, every error shape, and what an agent can fetch.
- Team AgentsYou, answering colleagues from internal notes — invite-only.
Guide 02
Build your twin
Everything from a blank page to a twin that sounds like you.
- Getting startedWhat a hiy is, and how to get one working in about a minute.
- The three kinds of twinYour public twin, Support Agents and Team Agents — what each is for, and who can reach it.
- How hiy is set upThe seven screens of the guided create flow, and how to change your mind.
- SourcesEvery way to get your material in, and what happens to it once it's there.
- Knowledge Hub and Agent knowledgeOne library for the account, and each agent's own view of what it draws on — grouped, filtered and searchable.
- MindA 3D map of what your twin knows, built from its live sources.
- ChatGPT, Claude or GeminiGive your twin the facts an assistant already knows about you.
- Your public profileName, expertise line, bio, links and photo — all optional.
- First impressionThe greeting and suggested questions visitors see first.
- What your twin answersKeep it on your subjects instead of behaving like a general chatbot.
- TrainingWhy changes wait, what a train does, what the last one learned, and why checking happens after it goes live.
- Testing your twinThe private sandbox that doesn't count against anything.
- ChannelsSet workspace defaults, choose agent templates, and preview channel experiences.
- Saved questionsKeep the questions that matter and re-run them after every change.
- Your DashboardYour agents, the week, your plan, and the one queue of what needs you.
- An agent's OverviewHow complete one agent is, what to do next, and the box that teaches it.
- ActivityEvery conversation your agents had, as a run you can open.
- Deflection and escalationThe two rates at the top of Insights — what each one counts, and what neither of them claims.
- Handing over to a personWhen your agent stops trying, who the handover reaches, and what the visitor reads while it happens.
Guide 03
Grow
Turn conversations into people you can reply to.
- Follow-up requestsVisitors can leave their details — on by default, off in one tap.
- Where a lead came fromOpen the conversation behind any lead or booking-link click.
- Email notificationsFollow-ups, booking-link clicks, and what your twin answered — by email.
- Lists your twin can look upServices, open roles, products — your twin answers from the exact rows.
- ActionsThings your agent can do as well as answer, and what happens when it does.
- Sharing your twinYour link, deep links, and where to put them.
- The hiy.ai creditWhat the “Powered by hiy.ai” line is, and what no plan can remove.
- Plans & billingWhat each plan includes, how the trial works, and what never sits behind it.
- Free toolsThe repeat-questions calculator and the audience questions generator.
Guide 04
Trust & transparency
For anyone talking to a twin, not just the person who made it.
- How AI twins workWhere answers come from, and why they show their sources.
- If you're talking to a twinWhat it is, what it isn't, and what happens to what you say.
- Signing in and outHow your session works, and how to end one you no longer have.
- Deleting an agentWhat goes, what stays, and what happens to your hiy.ai address.
- Light and darkSwitch how hiy looks, and what your embedded twin does on someone else's site.
Guide 05
Policies
The rules we hold ourselves and everyone else to.
If something here doesn't match what you see in the app, that's a bug in the docs — tell us.