Overview
Most reader mail is a short list of questions you have already answered on a page: when an issue goes out, where the back issues are, what a paid membership includes.
This agent reads those pages and answers from them, with the passage shown. For anything about someone’s own account, it says so plainly and passes the question to you.
Why readers’ questions belong to your pages
A question about your schedule has one right answer, and you wrote it down. An agent that reads your page cannot disagree with it.
A question about one reader’s subscription needs a person. Saying “I’ll pass this to the team” is slower than a guess and far cheaper than a wrong promise.
What your pages do not cover waits on Unanswered, ranked by how often it is asked, and tells you which page to write next.
Step by step
Create the Support Agent
Open the agent switcher and choose New Support Agent. Give it your publication’s name and a handle.
Setup reads the pages at the address you give it. Check that it found the pages your visitors ask about.
hiy.ai/appThe switcher is where every agent after your first one starts. Give it the pages people ask about
Add anything it missed by its address, upload a PDF, or write a short page into Knowledge for something you only ever answer by email.
Remove what is out of date before you test. The agent repeats whatever is in front of it. Turn on site re-sync so new pages are offered after you publish them.
Knowledge · Add- Write a pageAnything you’ve written — notes, an FAQ, a bio.
- Upload a filePDF, Word, Markdown or plain text.
- Add a pageAny post or page address. We read the article text.
The ways to add material: write a page, upload a file, or add a page by its address. Ask it what your visitors ask
In the Test chat, ask “When does the newsletter go out?” in the words a visitor would use. Check that the answer cites the right page.
Then ask something your pages do not cover. It should say so plainly and not guess.
TestHow do I export a notebook?
The answer is built from your pages and carries its source. - A questionThe agent checks your material.
- Material foundAnswer with a citation that opens the passage.
- Material missingAdmit the gap and add it to your queue.
What happens at the edge of the material Start from the Refund questions rule
In Automations, start from the Refund questions template. It tags a message that mentions a refund or cancelling and sets it to high priority, so those rise to the top of your Inbox.
Like every automation, it saves switched off. Read it, then turn it on yourself.
Automations- Refund questionsWhen a visitor asks about a refund, tag it and set high priority.
The Refund questions template, ready to edit. Put it on your site, then work the gaps
Open Channels, choose Chat widget, and press Install. Where to paste shows the steps for your site’s builder, such as Ghost or WordPress. List your site under Allowed websites, choose Anyone on your sites, then paste the line it shows.
Watch Unanswered for the first fortnight. Answer each question once with Teach it and every similar question after it is covered.
Publish · Install- 1 · Your signing secret is under SecurityYour server signs every visitor token with it.
- 2 · Mint a token on your serverPer page load, for each signed-in user of yours. Fifteen minutes is plenty; an hour is the most we accept.
- 3 · What your site tells this agent
- 4 · Drop the widget on your pageWorks as the floating bubble or the chat bar.
The one line to paste into your site, with the steps for your builder.
What this will not do
Every playbook carries this section, because a recipe that only lists what works is marketing.
- It cannot change, pause or cancel a subscription. It tags the question and a person answers it.
- It does not read your newest post until the page is in its material. Re-sync your site after you publish.
- Anyone on your sites can open it, so treat what it knows as public.
- A citation shows where an answer came from, not that the page is right.