Guide

Getting started with HatChat

The HatChat Dashboard: today's numbers, a setup checklist and a map of how chats flow from channels to AI agents and people
The Dashboard you land on after logging in. The "Get HatChat ready" checklist ticks itself off as you follow this guide.

Before you start

Have these ready:

  • A WhatsApp Business number connected through Meta's official WhatsApp Business API. We help you with this during onboarding.
  • An AI provider API key from OpenAI, Anthropic (Claude) or Google (Gemini). You pay the provider directly, usually a few sen per conversation.
  • Your business information: what you sell, prices you're happy for the AI to quote, branches, opening hours and your FAQs. PDFs and Word files are fine.
  • Your team's email addresses, if other people will follow up leads.

1. Connect your channels

Go to Settings → Inboxes → Add inbox and pick WhatsApp, Instagram, Messenger, web chat, email and more. Each channel becomes an inbox.

Then open the inbox and set two things:

  • Settings tab → Conversation Routing → Reopen same conversation. When a customer writes again, their previous chat reopens instead of starting a new one, so the AI keeps the full history and the same persona.
  • Business Hours tab → timezone. New inboxes start in Malaysian time. To change it, switch on business availability; the timezone picker appears below.

2. Create your AI agent

Go to Settings → AI Agents → New AI agent and start from a template: Front desk, Sales qualifier, Customer support or Appointment booker. You can change everything afterwards.

The AI Agents list showing a Front desk agent and two specialists, Appointments and Billing
Each AI agent shows whether it's live, its type and how many personas, lead details and inboxes it has.

On the General tab:

  • Agent name: name it after its job, for example Front desk, Claims or Sales. Specialists introduce themselves with this name.
  • Agent type: Lead qualification collects details and moves leads through the funnel; Customer support answers questions and resolves.
  • Inboxes: the channels where this agent takes the first message. Each inbox has one front desk agent.
  • AI model: choose the provider, paste your API key and press Test connection.

Switch the agent Live (top right) when you're ready, and press Save changes after every change.

The General tab of an AI agent with name, type and the inboxes it works in

3. Personas and instructions

Personas are the people your customers talk to. Add two or three with a name, a tone and an example greeting. Each new chat gets one at random and keeps it from hello to goodbye, so it feels like a team of real reps.

The Personas tab with an introduction setting and a persona named Aisyah

Instructions describe your business and the agent's job. Write them like you'd brief a new staff member: what you offer, what to say about prices, what never to promise. The AI replies in the customer's language (Malay, English or a mix) on its own.

The Instructions tab with a short description of a dental clinic

4. Details to collect

On the Lead fields tab (lead agents only), list what the AI should ask for: name, treatment, branch, preferred date, budget, anything. Mark the ones it must have as Required. Answers are checked, tidied (for example "ali@gmail" becomes [email protected]) and saved on the contact.

The Lead fields tab listing Full name and Treatment, with types and a required switch

The funnel moves on its own: New → Qualifying as answers come in → Complete once every required detail is in.

5. Knowledge

On the Knowledge tab, upload what the AI should answer from (PDF, Word or text):

  • Company files (all AI agents): company profile, branches, opening hours, contacts. Upload once and every agent uses them.
  • This agent's files: only for this agent, for example the claims procedure for a Claims agent, or price lists for Sales.
  • Help Center portals: if you publish FAQ articles in HatChat's Help Center, the agent answers from them and shares links.
The Knowledge tab with a company file uploaded for all AI agents

6. Behaviour and what happens next

Back on the General tab, the Behaviour box decides how the agent sounds, and After the AI finishes decides where each chat goes next.

The Behaviour settings: reply delay, typing pause and closing quiet chats, followed by the After the AI finishes section

Wait before replying

Each reply waits a random time in your range, for example 4 to 12 seconds, so it never feels timed. It also lets customers finish typing several short messages so the AI answers them together. Keep Longer replies take a little longer on for a natural typing pause.

Close quiet chats after

When a customer simply stops replying, the chat is resolved quietly after this many hours (12 by default) and keeps its stage. Nothing is sent to the customer, and the chat reopens if they write again. This keeps your Dashboard showing only live conversations.

After the AI finishes

One row for each moment the AI stops being the one in charge. For each row you choose what happens, who gets it and how it is shared.

After the AI finishes: six situations, each with what happens, which team or person gets the chat and how it is shared, with a plain-words summary below
WhenWhat it means
When a lead is completeEvery detail you asked for has been collected
When they ask for a personThe customer wants a human
When they are upset or complainingThe customer is unhappy or suspects a scam
When it can't answerThe question is outside its knowledge
When they refuse a detail twiceThe customer won't give a required detail
If the AI can't reply (error)The AI is unavailable, so a person always gets the chat

What happens can be one of four things:

OptionThe chatGiven to a personAI answers if the lead writes again
Pass the chat to peopleStays openYesNo, the person owns it
Give to someone and closeResolvedYesYes
Close the chatResolvedNoYes
Keep chatting with the AIStays with the AINoYes

If your team calls leads rather than chatting in HatChat, choose Give to someone and close for completed leads: each lead goes to someone, shows on their Leads page, and the AI still answers follow-up questions like "when will someone call me?".

Who gets it is the chat's current team, a team you choose, or one named person. How it is shared decides who in that team:

  • Round robin, online first: one at a time among people who are online, taking turns.
  • Fewest open chats: the online person with the least on their plate.
  • Let the inbox decide: the inbox's own automatic assignment picks the person.

If nobody is online, the chat waits with the team. Switch on If nobody is online, give it to the least busy person anyway if you would rather it always lands with someone. The In plain words box under the rows reads your choices back as sentences so you can check them at a glance.

7. Follow-ups

Many leads stop halfway through. With Follow-ups on, the AI nudges them in the persona's voice, picking up from the last unanswered question.

The Follow-ups settings: first nudge after 2 hours, second after 4 hours, quiet hours 22:00 to 08:00, close unanswered leads after 12 hours

For example, if the customer's last message was at 9pm:

StepDueSent
First nudge (2 hours)11pm, during quiet hours8am, when quiet hours end
Second nudge (4 hours later)12pm12pm
Close as "No response" (12 hours later)12amSilently, nothing is sent

Nudges only go out within 23 hours of the customer's last message, inside WhatsApp's free 24-hour window, so they never cost extra. Everything stops as soon as the customer replies or the lead completes.

8. Specialists and transfers

Bigger businesses can work like a real organisation: a front desk agent takes every first message and passes chats to specialist agents, such as Claims, Billing or Appointments, each with its own personas and knowledge.

  1. Create the specialist agent and leave its Inboxes empty. Only the front desk sits on the channel.
  2. On the front desk's Transfers to colleagues, add the specialist and describe when to transfer, for example "wants to change or cancel an appointment".
  3. Give the specialist a transfer back to the front desk for anything outside its job.
Transfer settings: who the customer talks to after a transfer, and transfers to the Appointments and Billing agents with a description of when

Under When a chat is passed to this agent, choose who the customer talks to:

  • A new colleague: the specialist introduces itself by name from its department ("Hi, I'm Farid from Appointments").
  • The same person: the customer keeps talking to the same name and never notices a hand-over.

The Dashboard draws your setup so you can check it at a glance:

The flow map: channels, the Front desk agent, the Appointments and Billing specialists, and the teams of people they hand over to

9. Your team

  • Invite people in Settings → Agents. They get an email to set a password.
  • Put them in a team in Settings → Teams, for example call team, and choose it under After the AI finishes on the agent.
  • Add them to the inbox under Settings → Inboxes → (inbox) → Collaborators. Keep Enable automatic conversation assignment on.
Inbox collaborators with automatic round-robin assignment switched on

How leads are shared: by default, round-robin, one at a time, among people who are online (you can change this per situation under After the AI finishes). People who are offline are skipped. To stay online even when HatChat isn't open, each person clicks their name at the bottom left, sets Online and switches off Mark offline automatically.

Admins see every lead. Agents see the leads assigned to them.

10. Google Sheets

On the agent's Google Sheet tab, completed leads can be added to your sheet as a row, the moment they complete.

  1. In console.cloud.google.com, create a project and enable the Google Sheets API.
  2. Create a service account, then Keys → Add key → JSON. A file downloads. Treat it like a password.
  3. Paste the whole file into step 1 and press Save changes. An email address appears in step 2.
  4. In your Google Sheet, Share with that email as Editor.
  5. Paste the sheet link and tab name in step 3, then Test access.
  6. Add your columns (lead details, phone, name, persona, chat link, time), press Write header row, switch Send leads to Google Sheets on and save.
The Google Sheet tab with the three setup steps and the column builder

11. Test, then go live

The Test chat tab lets you talk to the agent as if you were a customer. Nothing is sent or saved. Try a normal lead, a question it should answer from your files, a request for a human and, if you have specialists, a question that should be transferred.

The Test chat tab with the details collected so far shown beside the chat

Then switch the agent Live and send a real message from a second phone.

Every day: Dashboard and Leads

The Dashboard shows who's waiting, how much the AI handled, your lead funnel and the flow map.

In Conversations, the tabs Open, With AI (pending), Resolved and All show which chats need a person and which the AI is still handling, and the list says when a filter is hiding chats.

The Leads page is your CRM: one row per person with the channel, stage, details collected and who handled them. Click a lead to see every detail, a timeline of what happened and links to their chats. The cards on top show your conversion for whatever you filter, for example Instagram in the last 30 days. Export CSV downloads the filtered list.

The Leads page with stage summary cards, filters and an expanded lead showing details, a timeline and chats

Troubleshooting

The AI didn't reply

  • Is the agent Live, and is the inbox selected under Inboxes?
  • Is the chat assigned to a person and Open? The AI never talks over your team. Set the chat to Pending to give it back to the AI.
  • Did someone on your team reply in the chat? The AI steps back as soon as a person writes.

Nobody on my team got the lead

  • Check the agent's After the AI finishes rows: the situation you expect should say Pass the chat to people or Give to someone and close, with the right team or person.
  • The person must be in that team and in the inbox's collaborators, and be online. If nobody is online, the lead waits under Unassigned, unless you switched on If nobody is online, give it to the least busy person anyway.

A completed lead isn't in my Google Sheet

  • Press Test access on the Google Sheet tab. Most often the sheet isn't shared with the service account email, or the tab name doesn't match.
  • Leads that completed before the sheet was switched on aren't sent. Export them from the Leads page instead.

Follow-up nudges didn't go out

  • Follow-ups only apply to leads still New or Qualifying, with the AI (not a person) handling the chat.
  • A nudge that would land in quiet hours waits until they end, and one that would fall outside WhatsApp's 24-hour window is skipped.

Need a hand?

We set HatChat up with you during onboarding and we're happy to help any time.

Email [email protected]