Skip to content
Getting started

Where everything is on an agent

Every agent has 8 pages, in the row under its name: Overview, Instructions, Knowledge, Actions, Handoff, Channels, Tests, Settings. Each setting lives on exactly one of them. The quickest way to any of them is ⌘K (Ctrl+K on Windows) while you are looking at the agent: type what you want to change — “voice”, “hours”, “colour” — and it opens the right page with the field highlighted. The overview lists what is inside every page, and the foot of each page says where the things people look for there actually are.

Updated 2026-10-23 · 3 min read · More in getting started

The ones people look for in the wrong place

Most settings are where their page's name says. These are the exceptions — each has one home, and the page you might have tried first links to it at the bottom.

  1. Answer from knowledge

    Under Instructions, not Knowledge. Switch searching your knowledge on or off.

  2. Procedures

    Under Instructions › Procedures, not Actions. Step-by-step scripts for refunds, cancellations and other things it must not improvise.

  3. Message limit

    Under Instructions, not Channels. Stop answering a chat, email or WhatsApp conversation after so many messages.

  4. Notes & text

    Under Knowledge, not Instructions. Prices, plan limits, policies, FAQs — the facts it should quote.

  5. Help centre & docs sync

    Under Knowledge, not Actions. Zendesk Guide, Intercom Articles, Notion or Confluence, kept in step on its own.

  6. Capture leads

    Under Actions, not Channels. Take a name, plus a phone number or email when offered.

  7. Open helpdesk tickets

    Under Actions, not Handoff. Hand a customer to your team as a ticket in Zendesk, HubSpot or another helpdesk.

  8. Connect a helpdesk

    Under Actions › Connections, not Handoff. Zendesk, Freshdesk, HubSpot, Intercom, Help Scout, Gorgias or Odoo.

  9. Zendesk Messaging

    Under Actions › Connections, not Channels or Handoff. Answer first in your Zendesk Web Widget and apps, and pass chats to your Zendesk team.

  10. Transfer calls to a person

    Under Handoff, not Channels or Actions. Hand a live call to your cell or desk line when the caller asks for someone.

  11. A person in chat & email

    Under Handoff, not Actions. Let chat and email customers ask for a person, and tell them one is coming.

  12. Business hours

    Under Handoff, not Settings. When chat and email customers may ask for a person. Phone transfers ignore them.

  13. Chat opening message

    Under Channels › Website chat, not Instructions. The first message a visitor sees in chat.

  14. Allowed domains

    Under Channels › Website chat › Install, not Settings. Stop a copy of your snippet working on someone else's site.

  15. Verified visitors

    Under Channels › Website chat › Install, not Settings. Sign each logged-in user so the agent knows who they are.

  16. Voice

    Under Channels › Phone, not Instructions. The voice it speaks in on calls. Play a sample before you pick.

  17. Phone greeting

    Under Channels › Phone, not Instructions. What it says, word for word, when it picks up a call.

  18. WhatsApp number

    Under Channels › WhatsApp, not Actions. Connect a WhatsApp Business number from your Meta app, and its webhook.

  19. Wording per channel

    Under Channels › Website chat, not Instructions. Different instructions for chat, phone, email or WhatsApp, at the foot of each channel.

  20. Name

    Under Settings, not Instructions. What it calls itself, everywhere.

  21. Version history

    Under Settings, not Instructions or Channels. Every saved change — instructions, voice, transfer, the chat widget — and one click to put one back.

  22. Delete this agent

    Under Settings, not Overview. Delete it, with 30 days to undo; then its number and knowledge go. Conversations stay.

Overview

What is live, what is left to do.

  1. Setup checklist

    What is left before customers can reach it.

  2. Try it in chat

    Chat with the saved agent in a panel beside whatever page you are on.

  3. Try it on a call

    Talk to it in your browser, exactly as a caller would. No number needed.

Instructions

What it knows about your business and how to behave, on every channel, plus procedures.

  1. Instructions

    About your business and how to behave, on every channel.

  2. Remember callers

    Keep notes per customer across conversations.

  3. Answer from knowledge

    Switch searching your knowledge on or off.

  4. Procedures

    Step-by-step scripts for refunds, cancellations and other things it must not improvise. On the Procedures page inside Instructions.

  5. Message limit

    Stop answering a chat, email or WhatsApp conversation after so many messages.

Knowledge

The pages, files, Q&A and notes it answers from, and its unanswered questions.

  1. Website

    Crawl your site so it answers from your own pages.

  2. Notes & text

    Prices, plan limits, policies, FAQs — the facts it should quote.

  3. Q&A answers

    One question, the ways people ask it, one answer. Used ahead of pages and files.

  4. Files

    PDF, Word, Excel, CSV or HTML.

  5. Help centre & docs sync

    Zendesk Guide, Intercom Articles, Notion or Confluence, kept in step on its own.

  6. Test a question

    Ask like a customer and see what it would find.

  7. Sources

    What it has read — see the pages, remove one.

  8. Unanswered questions

    The questions it had no answer for, grouped by meaning, with the answer one click away. On the Unanswered page inside Knowledge.

  9. Topics

    Your own list of the subjects Analytics files conversations under. On the Topics page inside Knowledge.

Actions

Take a lead, book a meeting, look up an order, call your systems — and the accounts they use.

  1. Capture leads

    Take a name, plus a phone number or email when offered.

  2. Book meetings

    Put a meeting on your Cal.com calendar mid-conversation.

  3. Call your API

    Look something up or write it back to your own systems.

  4. Open helpdesk tickets

    Hand a customer to your team as a ticket in Zendesk, HubSpot or another helpdesk.

  5. Answer billing questions

    Plan, invoices, cancelling and the card on file, from Stripe, for the customer's own account.

  6. Look up orders

    Order status, product search and return requests, from Shopify.

  7. Book on Calendly

    Offer open times and book meetings on your Calendly.

  8. Connect a helpdesk

    Zendesk, Freshdesk, HubSpot, Intercom, Help Scout, Gorgias or Odoo. On the Connections page inside Actions.

  9. Connect Stripe or Shopify

    A restricted Stripe key, or your Shopify store's app credentials. On the Connections page inside Actions.

  10. Connect Calendly

    A personal access token, so the agent can book on your Calendly. On the Connections page inside Actions.

  11. Zendesk Messaging

    Answer first in your Zendesk Web Widget and apps, and pass chats to your Zendesk team. On the Connections page inside Actions.

  12. Slack, Twilio and more

    The tools being built next, and the ones set up with us. On the Connections page inside Actions.

  13. API keys

    The encrypted secrets your actions sign in with. On the Connections page inside Actions.

Handoff

When and how it brings in a person: live transfer, a person in chat, your hours.

  1. Transfer calls to a person

    Hand a live call to your cell or desk line when the caller asks for someone.

  2. A person in chat & email

    Let chat and email customers ask for a person, and tell them one is coming.

  3. Business hours

    When chat and email customers may ask for a person. Phone transfers ignore them.

Channels

Website chat, phone, email and WhatsApp — each with everything about it, from the chat widget to the voice.

  1. Website chat

    Switch the chat widget on or off, and see whether it is on your site. On the Website chat page inside Channels.

  2. Chat opening message

    The first message a visitor sees in chat. On the Website chat page inside Channels.

  3. Suggested questions

    One-tap questions a visitor sees before they type. On the Website chat page inside Channels.

  4. Suggested follow-ups

    Next questions under each reply, for visitors to tap. On the Website chat page inside Channels.

  5. Answer ratings

    Thumbs up and down under each reply in chat. On the Website chat page inside Channels.

  6. Voice typing

    A mic in the chat box so visitors can speak instead of type. On the Website chat page inside Channels.

  7. Disclaimer

    A line of small print under the message box, with one link if you like. On the Website chat page inside Channels.

  8. Header & icon

    The name, tagline and icon at the top of the chat. On the Website chat page inside Channels.

  9. Colours & fonts

    Theme, accent colour, typeface, text size and corners. On the Website chat page inside Channels.

  10. Launcher

    The button that opens the chat: colour, label, size, position. On the Website chat page inside Channels.

  11. Embed snippet

    The one line that puts it on your site. On the Website chat › Install page inside Channels.

  12. Platform guides

    Where the snippet goes on WordPress, Shopify, GTM and more. On the Website chat › Install page inside Channels.

  13. JavaScript API

    Open the chat from your own button, prefill a question. On the Website chat › Install page inside Channels.

  14. Allowed domains

    Stop a copy of your snippet working on someone else's site. On the Website chat › Install page inside Channels.

  15. Verified visitors

    Sign each logged-in user so the agent knows who they are. On the Website chat › Install page inside Channels.

  16. Phone number

    Get a number, forward your own line to it, or remove it. On the Phone page inside Channels.

  17. Voice

    The voice it speaks in on calls. Play a sample before you pick. On the Phone page inside Channels.

  18. Phone greeting

    What it says, word for word, when it picks up a call. On the Phone page inside Channels.

  19. AI & recording notice

    Tell callers they are talking to an AI and may be recorded. On the Phone page inside Channels.

  20. Record calls

    Keep the audio of each call, played back beside its transcript. On the Phone page inside Channels.

  21. Rating question

    Ask callers if they got what they needed, as the call ends. On the Phone page inside Channels.

  22. Email address

    The address customers write to, and who replies come from. On the Email page inside Channels.

  23. WhatsApp number

    Connect a WhatsApp Business number from your Meta app, and its webhook. On the WhatsApp page inside Channels.

  24. Wording per channel

    Different instructions for chat, phone, email or WhatsApp, at the foot of each channel. On the Website chat page inside Channels.

Tests

A simulated customer talks to it, and each conversation is graded.

  1. Your tests

    Each test's latest pass rate; run them again after a change.

  2. Create a test

    A customer to play, what has to happen, and what actions return. On the New test page inside Tests.

Settings

Its name, every earlier version of it, and deleting it.

  1. Name

    What it calls itself, everywhere.

  2. Version history

    Every saved change — instructions, voice, transfer, the chat widget — and one click to put one back.

  3. Delete this agent

    Delete it, with 30 days to undo; then its number and knowledge go. Conversations stay.

FAQ

Related questions

Under Channels › Phone, with everything else about calls: the number, the voice, the phone greeting, the AI-and-recording notice and recordings. Every voice has a play button, so you can hear them all before you pick. To hear a whole call, save a voice, press Preview at the top of any page inside the agent and open the Call tab. It needs no phone number, and works whether or not the phone channel is on.

Still stuck? A person will answer.