Lesson 2 of 7 · 8 min

Website chat widget with knowledge-base answers

Add a website chat that answers questions from the knowledge base.

Read the lesson

Goal: Install the website chat, give it owner-approved answers, and test it so it never guesses.

You need: Access to the client's ServiceAgent account and website. AI chat replies need Growth or Franchise. On Launch and Core, chat replies are manual.

Why this matters

Some visitors will not call and will not fill in a form. They have one question first. Do you work in my town? Are you open Saturday? If nobody answers, they go back to the search results.

Website chat answers that question while the visitor is still on the page. On Growth, the AI answers at any hour. Then it points the visitor to the booking page.

Fig 1

How a chat becomes a booking

  1. VisitorAsks: do you work in my town?
  2. ChatAnswers from approved facts
  3. ChatOffers the booking link
  4. VisitorBooks a time
  5. TeamSees the chat in Conversations
The chat answers one question, then moves the visitor to the booking page.

A wrong answer is worse than no answer. Say the chat promises service in a town the business does not cover. The owner then stops trusting the whole system. So this lesson is half setup and half testing.

How the plan level changes the job:

  • Launch and Core. The chat widget works, but replies are manual. A person must answer from Conversations. For an owner-operator, this often means slow replies. Be honest about that.
  • Growth and Franchise. AI replies in the chat. This is the right plan when the chat must work at night.
  • Multi-location. Each location may have different hours, towns and services. The answers must say which location they cover.
Fig 2

Who replies in the chat, by plan

Launch and Core
  • Chat widget works
  • A person replies by hand in Conversations
  • Night chats wait for a person
Growth and Franchise
  • Chat widget works
  • AI replies at any hour
  • 0.5 credits per AI chat interaction
AI chat replies start on Growth.

What the chat can answer

The chat AI answers from the facts you give the business's account. It does not search the internet for the client. It does not know prices unless you add them. Good chat content comes from four places:

SourceExampleWho approves
Service list"Drain cleaning, water heaters, repipes"Owner
Service area"Towns we serve: Maple Grove, Plymouth"Owner
Hours and closures"Mon to Fri 7 am to 6 pm"Office
Common questions"Do you charge a trip fee?"Owner

Write each answer the way the owner would say it. Keep each one short. One question, one answer. Read the answers aloud to the owner before you add them. They will catch a wrong town or an old price in seconds. Ask them to sign off on the list by email, so you have a dated record.

There is a simple rule for prices. The chat says only prices the owner approved in writing. If there is no approved price, the chat says a person will confirm it. It offers the booking link.

Build it in ServiceAgent

  1. Open the client's account. Check the plan in Settings → Plan & Billing → Current plan. If it is Launch or Core, tell the owner that chat replies are manual.
  2. Go to Widgets → Chat & phone → Configure. Set the greeting, colors and the business name.
  3. Write the greeting as a question the visitor can answer. Example: "Hi! What can we help you with today?"
  4. Add the facts the chat needs. Use the business's knowledge sources and short question-and-answer pairs. The voice agent's Knowledge tab has Knowledge sources and Quick answers. Check in the client's account which sources the chat reads.
  5. Add the booking page link to the answers. Get it from the default booking page with Copy link.
  6. Go to Widgets → Chat & phone → Install. Copy the code for the website.
  7. Add the website's address to the Domain Allowlist on the Widgets page. The widget only loads on allowed sites.
  8. Paste the code into the website, or send it to the web designer. Ask for it on every page, not only the home page.
  9. Test 10 real questions. Use the call reasons from the voice course if you have them.
  10. Test 2 questions the chat should not know. A good chat says it will check and offers the booking link. A bad chat makes something up.
  11. Fix every wrong or invented answer. Add an owner-approved answer, then ask the question again.
  12. Check that chats appear in Conversations, so the team sees them.

Check it works: 10 known questions get correct answers. 2 unknown questions get "a person will confirm" plus the booking link. Every chat shows in Conversations.

Fig 3

Before chat go-live

  • Greeting set in Configure
  • Service area, hours and approved prices added
  • Booking link in the answers
  • Site on the Domain Allowlist
  • 10 known questions pass
  • 2 unknown questions get a safe reply
  • Chats show in Conversations
Do not go live until every line passes.

When a person must take over

The AI chat does not do everything. Some chats need a person. Agree on these with the owner before go-live:

  • Emergencies. A visitor writes "water is coming through the ceiling". The chat should give the business phone number at once. A chat is too slow for an emergency.
  • Complaints. An unhappy customer needs a person, not an AI answer. The chat says someone will reach out, and the team replies from Conversations.
  • Custom quotes. Large jobs need a site visit. The chat offers the booking link for an estimate visit.
  • Anything outside the approved facts. The chat says a person will confirm.
Fig 4

When a person takes over the chat

  1. A visitor writes in the chat
  2. Is it an emergency?YesGive the business phone number at onceEnds hereNoCheck the next question
  3. Is it a complaint?YesSay someone will reach out; the team repliesEnds hereNoCheck the next question
  4. Is the answer in the approved facts?YesAnswer, then offer the booking linkNoSay a person will confirm; offer the link
  5. The team sees the thread in Conversations
Agree these rules with the owner before go-live. Every chat still lands in Conversations.

Every chat lands in Conversations. So the team sees what the AI said and can step in. Set a response target so these chats do not wait. Go to Settings → Service Catalog → SLAs → Inbox SLA. Set the Unread Thread Threshold in minutes. The app checks hourly, and a breach creates a task for the team.

Running the chat on Launch or Core

Many small clients start on Core. The chat still helps them, but a person must reply. Make that work with a simple routine:

  1. Turn on notifications for new chats for the person who replies.
  2. Agree on a reply target, such as 15 minutes in business hours.
  3. Write 5 saved answers the person can paste for the common questions.
  4. After hours, the greeting says when a person will reply. It also offers the booking link, so the visitor can book at once.

Be honest in the sales meeting. On Core, the chat captures the question and shows the booking link. It does not answer by AI at night. If night chat matters, Growth is the right plan.

How business size changes the build

An owner-operator such as Rivera Heating and Air gets few chats. The main value is the booking link at night. A fleet such as Polar Air Services gets many chats. It needs clear handoff rules and an Inbox SLA, or chats pile up. A business with several locations needs answers that name the location. For example: "Our Plymouth shop is open Saturday. Our Maple Grove shop is not."

Credits and cost

On the Credit Calculator, an AI Chat Interaction is 0.5 credits. Check Billing → Usage history after the first week. The real count depends on how many messages each chat has.

Worked example: Green Acre Lawn and Landscape

Green Acre has 5 crews on Growth. Its website gets many evening visitors in spring. Example inputs: 200 AI chat interactions a month.

Credit math:

  1. 200 interactions x 0.5 credits = 100 credits a month.
  2. Growth includes 6,000 credits a month.
  3. 100 / 6,000 = about 1.7% of the monthly credits.
Fig 5Example numbers

Green Acre's chat credits

AI chat interactions a month200
×Credits each0.5
Credits a month (about 1.7% of 6,000)100
The chat uses a small part of Growth's 6,000 monthly credits. Check Usage history for the real count.

Now the test. You ask the chat 12 questions before go-live.

QuestionResultFix
Do you mow in Oak Ridge?CorrectNone
Are you open Sunday?CorrectNone
How much is spring cleanup?Invented "$199"Owner approves "from $250, confirmed on site"
Do you do snow removal?Invented "Yes"Owner says no; add "We do not offer snow removal"
Other 8 questionsCorrectNone

Two of 12 answers were invented. That is about 17%. You do not go live. You add two owner-approved answers and test again. Both now answer correctly. Then you go live.

Fig 6

The two gaps, after the fix

  1. noteRetest before go-live
  2. VisitorHow much is spring cleanup?
  3. Green Acre chatSpring cleanup is from $250, confirmed on site. You can book a visit here: [booking link]
  4. VisitorDo you do snow removal?
  5. Green Acre chatWe do not offer snow removal. For mowing or cleanup, you can book here: [booking link]
Both invented answers now use owner-approved words and offer the booking link.

Common mistakes

  • Going live after testing only easy questions. Ask questions the chat should not know. A chat that guesses gives wrong facts to visitors.
  • Promising AI replies on Core. Core chat replies are manual. Say so before the owner pays you for night coverage.
  • Installing on the home page only. Visitors arrive on service pages from search. Put the widget on every page.
  • Forgetting the Domain Allowlist. The widget will not load on a site that is not listed.
  • Prices with no written approval. The chat says only approved prices. Otherwise it offers a visit.

Do this now

Write 10 question-and-answer pairs for one roster business. Include the service area, hours and 3 price questions. Mark which prices need owner approval. Then write 2 test questions the chat should not answer, and the safe reply for each.

Practice the conversation

  1. Owner I don't want a robot telling people wrong prices.
  2. Operator Neither do I. The chat only says what you approve in writing.
  3. Owner What if someone asks something new?
  4. Operator It says a person will confirm, and it offers your booking link.
  5. Owner And at night?
  6. Operator On Growth, the AI answers at night. On Core, a person answers in the morning.
  7. Owner How do I know it works?
  8. Operator I test it with questions it should not know. If it guesses, we don't go live.
  9. Owner Can I see the chats?
  10. Operator Yes. Every chat lands in Conversations, next to your texts and emails.

Quick check

  1. Before go-live, you ask a Growth client's website chat 2 questions that the knowledge base cannot answer. The chat makes up an answer each time. What do you do?
    • Go live anyway, because the answers it did know were right
    • Tell the owner to check every chat by hand at night
    • Turn off the knowledge base, so the chat has nothing to guess from
    • Add owner-approved answers for those gaps, then test again before go-live
  2. A Core client wants the chat to answer by AI at 11 pm. What do you tell the owner?
    • Core chat replies are manual; AI chat replies need Growth or Franchise
    • Core covers it once you add more Quick answers
    • AI chat needs Franchise only, because it uses the API
    • Any plan can do it if the widget is on every page
  3. A Growth client has about 400 AI chat interactions a month. How many credits does that use, at the Credit Calculator rate?
    • 100 credits
    • 200 credits
    • 400 credits
    • 1,200 credits

ServiceAgent UniversityLearn to run a service business on autopilot. Free courses, Blueprints and certification for Service Operators.

Learn

Get certified

Community