Skip to main content

Nutshell Chat: How to set up and manage your live chat and AI chatbot

Learn how to configure Nutshell's chat widget on your website and manage your chat conversations in your CRM

Written by Hamida Bapoo

Nutshell Chat is available on the Engagement Foundation plan and above. The ability to customize chatbot appearance is available on the Engagement Pro plan.

Your website visitors are often your warmest prospects—they’re curious, they have questions, and they’re exploring if your business can help them. With Nutshell Chat, you can make sure no opportunity slips through the cracks.

See how to set up and manage your AI chatbot:

Ways to connect with visitors

Nutshell Chat gives you a few ways to connect with your web visitors:

  • Live chat with your team: Your team can reply directly to visitors in real time, building relationships and answering questions personally.

  • AI chatbot: An always-on teammate that automatically responds to questions. When a human touch is needed, the chatbot can hand the conversation off to your team.

  • Smart nudges: Serve AI-generated suggested questions and contextual conversation starters on each page on your website. Smart nudges are prompts that help visitors begin a chat based on the content or context of the page they’re viewing.

  • Engagement bar: The Engagement bar allows you to set up and display multiple calls to action (CTAs) in the chat widget. You can configure the Engagement bar to guide visitors toward actions that matter most for your business, such as:

    • Chat

    • Book a meeting

    • Call

    • Text

    • Quote

    • Email

  • Homepage: The Homepage is a welcome screen for your chat widget. It greets visitors, lists your configured actions in a friendlier way, and still includes a way to start chatting right away. Visitors can navigate to the Homepage from any screen in the chat widget while it's turned on.

  • Business card: Gives visitors a quick way to reach you outside of chat, with your company's contact info, logo, and hours.

Visitors can interact with these CTAs directly from the chat widget, making it easier for them to take the next step while browsing your site.

💡 Tip: Want to track chat and Engagement bar conversions in Google Analytics? If Google Analytics is enabled on your website, Nutshell can automatically emit chat events and chat action form submissions to Google Analytics—no configuration required.

Together, these tools ensure that your website is never a dead end for a curious prospect, whether it’s during business hours or after.

Why use Nutshell Chat?

Instead of hoping your visitors will call or fill out a form, you can:

  • Meet them where they are, right on your website

  • Offer instant answers, day or night

  • Collect leads, meeting bookings, and form submissions automatically

  • Jump in personally whenever someone needs a human response

With just a little setup, you’ll have both your team and your chatbot working side by side to engage your visitors and win more business.

Get started with Nutshell Chat

To get started, your admin will first need to configure and embed your chat widget.

  • Click on Engagement > Setup > Chat

Chat settings is organized into five tabs: Overview, Actions, Branding, Knowledge, and Chatbot behavior. Here's what each one covers.


The Overview tab: choose how visitors can reach you

The Overview tab is where you turn on the different ways visitors can reach you, and control what they see when they first land on your site. Each setting below is a card you can expand, enable, and disable independently.


Engagement bar

The Engagement bar helps guide visitors toward completing key actions while browsing your site, giving them easy access to the options that matter most for your business. Here you can configure which actions are visible and accessible to visitors in your chat widget.


Turn on Show engagement bar to make it visible to visitors. Then choose up to 5 visible actions. The available actions are Chat, Quote, Text, Email, Call, and Book. Drag to reorder them, and toggle each one on or off. Actions you turn off move to the Hidden actions section.

Homepage

Turn on Enable homepage to show visitors a home screen when the engagement bar opens. Visitors see a greeting, your enabled actions as buttons, and a chat field they can use to start a conversation right away.

Business card

Turn on Enable business card to give visitors a quick way to reach you outside of chat.


The Homepage and Business card icons appear in the widget header, so visitors can jump between them from any screen.


Page load behavior

Controls how the engagement bar introduces itself when a page loads. Click into it to set:

  • Automatically open – choose what happens when a visitor lands on a page:

    • Nothing – let visitors open chat on their own terms

    • Smart nudges – AI-powered prompts that nudge a visitor to engage

    • A specific page – open straight to the home or actions page

  • Which page? – if you've chosen A specific page, pick which screen it opens to: your Homepage, or one of the engagement bar actions (Chat, Book, Email, Call, Text, Quote). This isn't a URL on your website — it's which screen inside the widget visitors land on.

  • Visible – choose whether this applies Only on desktop or Always

  • Call to action – the short text shown to invite visitors in (25 characters max)

Excluded URLs

Add custom URLs where you don't want chat to appear, like a signup page or billing form. Click + Add path to add a URL, and the chat widget won't load on that page for visitors.

The Actions tab: configure what visitors see

The Actions tab is where you can configure the actions that appear in your chat widget. You can customize the opening message your user will see before the first form field, edit the form, and set lead creation rules.

Within the chat configuration action, you can add a customizable message that will appear at the start of a chat. You can format it with bold or italics, include links (such as to your privacy policy), and use it to let visitors know that chats are recorded.

By default, forms are added for Chat, Email, Call, Text, and Quote. You can edit/change these forms at any time. For the Chat action, you can also choose to create a lead for each inbound chat, and which pipeline the lead should be added to when a conversation generates a new lead.

For the Quote action, you can choose to create a lead after a visitor completes a quote request and which pipeline the lead should be added to.

For the Booking action, you can select a meeting from the available meetings in the dropdown. If no meetings are configured, you will be directed to Scheduler so you can set one up.

💡Tip: Using the Booking action? Track how your meeting link is performing (bookings and availability trends) in the Scheduler report.

You can also customize the text that appears on each action in the Engagement bar to match your messaging. The action label text is limited to 8 characters.

Homepage

Before you turn on the Homepage in the Overview tab, configure it here. Choose an Actions layoutStacked (each action as a full-width row) or Grid (a 2-column grid) — then customize the label shown for each enabled action, up to 25 characters each.

Disabled actions won't appear on your Homepage; enable them from the Overview tab if you'd like them included.

Business card

Before you turn on the Business card in the Overview tab, configure it here. Nutshell automatically populates this with the information you've already added in your account's General settings (Setup > Administration > General) — company name, address, business hours, and so on. Just double-check the details, make any edits you'd like, and add your company logo.


Visitors can open the business card from any screen in the widget, alongside the Homepage icon in the widget header.

The Branding tab: personalize your chatbot

Nutshell Chat is more than a widget—it’s often the first impression visitors will have of your business.

Here you’ll be able to customize the:

  • Company & chatbot name: The name you’d like to display on the chat widget, like your company name and perhaps a different name for your chatbot

  • Show ‘Powered by Nutshell’ watermark: This will be displayed at the bottom of your chat widget

  • Logo + Chatbot icon: Choose from default options for your chatbot icon, and upload a custom image for your logo/avatar

  • Widget color: Select from default colors for your primary (widget) and secondary (the customized nudges within the chat widget) colors, but you can also choose a specific color by clicking the '+' button

As you make edits to the look and feel of your widget, you’ll be able to see the preview of what it looks like on the right side.

The Knowledge tab: teach your chatbot about your business

The chatbot can only be as helpful as the knowledge it has access to. That’s where the Knowledge tab comes in. Here, you’ll give your chatbot the content it needs to respond accurately to your visitors.

  • Add your content: Upload PDFs (like brochures, FAQs, or guides) or provide website URLs.

  • See what’s been indexed: Each item shows a title or summary, the date it was crawled, and whether it’s active or disabled.

  • Take action anytime:

    • View the content

    • Exclude/disable without deleting

    • Recrawl for updates

    • Delete permanently

Pages are re-crawled automatically in the background, so the chatbot stays current as your site changes without any manual effort on your part.

Use the Chat tester on the right to check how the chatbot responds to any question.

You'll see the answer and the pages it drew from. If something looks off, you can recrawl a page or add a custom answer right from there.

You’ll also see a knowledge capacity bar on the bottom left of the sidebar that shows how much words of content been added. Each Nutshell account can store up to 75,000 words of content across up to 100 pages. If you run into the limit, simply disable less important pages to make room for new ones.

The result: a chatbot that sounds like it knows your business inside and out.

Want to preview how your chatbot will look and work before you commit to the chatbot?

You can either:

  • Click the Nutshell chatbot card on the dashboard

  • Click the Preview button in Chat setup

  • Enter your website URL

  • You’ll instantly see a test version of the chatbot. You can ask it questions and see how the chatbot responds directly in Nutshell. You can also click the ‘Copy link’ button in the top right to view the preview in a new window

The Chatbot behavior tab: customize your chatbot's behavior

Think of this as setting your chatbot’s “personality” and deciding when it should step in to help.

Here’s what you can customize:

  • When should the chatbot respond?: Options include:

    • Always: The chatbot replies right away, even if your team is online.

    • Only when your team is offline: The chatbot acts as backup, covering for your team when no one’s available.

    • Never (disable chatbot): Turn the chatbot off if you only want human-to-human chat.

  • Set the conversation tone: Choose whether you’d like your chatbot to sound Neutral, Friendly, or Professional, depending on how you want to represent your brand.

  • Answer length: Decide how detailed responses should be: Concise, Normal, or Complete.

  • Add guidance:

    • You can write custom Q&A pairs. If there's a question you want the chatbot to answer in a specific way, add it here and the chatbot will use your answer over anything it learned from crawling your site

    • Give your chatbot helpful hints about how it should respond (for example, Encourage visitors to order the August promotion).

  • Topics to avoid: List any subjects you’d prefer your chatbot not mention or answer. For example: competitor information

  • Handoff rules: You can configure how you assign threads when your team members are online in different ways:

    • Round-robin: Evenly distribute chats among your team

    • Specific-user: Always direct chats to a designated person

    • Nobody: Leave the conversation open for team members to pick up themselves

Configure your offline form

You can configure an offline form that visitors will see if no team member is available to chat. Access the form by clicking the Edit form link:

You can:

  • Customize the form fields

  • Configure your spam prevention preference

  • Customize your success message seen after form submission

  • Set up rules for creating Person, Company, or Lead rules

  • Set up notifications so your team is alerted whenever a visitor submits the form

You can also view your offline form engagement, submissions, and respondents list.

Set up your team as agents

Agents are team members with an Engagement license, allowing them to manage and respond to chats. They play a key role in providing support, and their availability helps determine how visitors interact with your team.

Assigning Engagement licenses

Engagement licenses are purchased and assigned per user. Head to the Users & teams page, where you’ll be able to toggle the Engagement license on for the user/s you’d like to allocate it to.

Managing agents as an admin

Admins have full access to the Agents page in the Engagement sidebar menu. This page serves as the central hub providing your admin with a full view of their agent list. Additionally, they can:

View agent's status

Set individual availability to "Available" or "Not accepting chats."

Monitor the number of open chats each agent is handling, with a clickable link to dive into those conversations.

Setting availability as a non-admin agent

Non-admin agents can easily manage their availability status. To update your availability, click on your avatar in the top right corner of the app and toggle the "Available" setting. When set to "Available," chats will be automatically assigned to you. If you're not ready to accept chats, simply toggle it off.

Additionally, you can set your availability to automatically toggle on when using Nutshell. This way, you won’t need to manually update your status each time.

When this setting is on and you'd like to mark yourself as 'Not accepting chats', you can toggle it on, and it will remain off until the next business day.

Embed and enable your chat widget

To make your chat widget live on your website, you’ll need to embed the chat widget and ensure it’s enabled.

On the Chat settings page, look for the Chat snippet button in the header and follow the prompts.

To make the chat visible to your website visitors:

Enable the Visible on your website toggle next to the Chat snippet button on the Chat settings page.

With these steps complete, the chat widget will be active on your site, ready to connect visitors with your team.

Managing chat threads

It's easy to drill down into all the conversations and leads originating from your chat widget. The Engagement page in the main navigation menu is the hub of your organization’s chat and text message threads, organized by thread status. ​

On this page, you’ll see:

  • Engagement bar

    • Leads: All the leads created via the Engagement bar actions, which you can filter by specific actions. You can also customize the list to include specific columns.

    • Chatbot threads: Your chatbot threads. There are three tabs within the chatbot thread:

      • Active: All your known visitors with active chats

      • Unidentified: Visitors that are not yet known to Nutshell that have an open chat thread

      • Inactive: Closed threads

  • Agent thread overview:

    • All: Your chat inbox, including opened and closed threads.

    • Unassigned: Chats that have not been assigned to an agent based on configuration/availability.

    • Your inbox: Your active chats.

    • Closed: Conversations that are completed, i.e. marked as closed by the agent.

    • Thread assignment: Each thread shows who it’s assigned to. Admins can reassign threads if needed, while non-admins will only see their assigned threads.

Visitor presence in chats​

While engaging with visitors, you’ll be able to see their real-time presence:

  • Active visitors will show a green dot and a “Chatting now” status, indicating they are actively chatting with you.

  • Inactive visitors will appear with a gray dot, and you’ll also be able to see when they were last seen, helping you know when they were last active in the chat.

Creating a lead from a chat

You can turn a web chat visitor into a lead directly from the chat thread view.

In the chat thread sidebar, you'll see a +Create Lead button. Clicking this button lets you quickly create a lead and assign it to a specific pipeline, connecting the visitor's details to your sales process. This ensures you can capture potential opportunities directly from your chat conversations.

Reporting on chat widget engagement

If you want a clear, numbers-first view of how your chat widget is performing, check out the Engagement report. You can see how many people saw your widget, opened it, completed an action, became leads, and even became customers.

Learn how to use the Engagement report.

If you want to understand what people are actually asking—and where your chatbot needs a tune-up—head to the Chatbot report. It highlights common topics, top nudges clicked, feedback and frustration, and knowledge gaps.

Go to Reports > Other > Chatbot, or learn how to use the Chatbot report.

Privacy and usage guidelines

This AI chatbot is designed exclusively to assist visitors with information about the company's products and services. The chatbot has been trained specifically on the company's website content and is programmed to provide accurate, helpful responses only within the scope of the business offerings. If visitors ask questions outside this domain, the chatbot will politely redirect the conversation back to topics it can assist with. Interactions with the chatbot are used solely to improve the visitor experience and help connect them with the team—conversations are not used for unrelated purposes or shared with third parties.

Please note that the chatbot is a customer service and lead generation tool, not a substitute for professional advice. It cannot and will not provide medical, legal, financial, or other professional guidance. The chatbot's purpose is to answer questions about the company, help visitors understand how the solutions might meet their needs, and facilitate scheduling sales meetings or submitting contact forms. For any matters requiring professional expertise beyond the business scope, visitors are encouraged to consult with appropriate licensed professionals.

The chatbot operates within strict guidelines to protect visitor privacy while helping them find the information they need. If at any point the chatbot cannot adequately address a question, it will offer to connect the visitor directly with a member of the team who can provide more personalized assistance.

FAQs

How do I set specific hours when my team is available for chats?

While agent availability is set individually, you can also use the Offline settings on the Goals page to customize the experience for visitors who reach out during off-hours.

Can admins reassign a chat to a different agent?

Yes, admins can reassign chats directly from the chat thread view. This ensures chats reach the right agent if a reassignment is needed for expertise or availability.

Is there a limit to the number of agents I can have?

The number of agents is determined by the Engagement licenses your team has purchased. You can assign and manage these licenses in the Users & teams page.

Can visitors send attachments through the chat widget?

Currently, visitors can only send text-based messages, URLs included.

What if I want to temporarily disable chat?

You can disable the chat widget by unchecking the Visible on website toggle in Web chat settings.

How can I notify a visitor that a chat might take longer to respond to?

You can include this information in the welcome message or offline form message. For example, you can set a custom message like, “Thanks for reaching out! We’ll respond as soon as we can.”

What happens to chats if an agent goes offline in the middle of a conversation?

If an agent goes offline during a chat, the conversation remains in the chat queue.

Can I see chat threads on timelines?

Absolutely, you’ll see closed chat threads right at the top of a Person, Company, or Lead timeline. Clicking on it will open the sidebar where you can view the full conversation in read-only.

How do I update or improve chatbot responses over time?

Pages are re-crawled automatically in the background, so the chatbot stays current as your site changes. For extra control, you can still manually recrawl any page, disable outdated content, or add custom Q&A pairs under Guidance in the Chatobot behavior tab. Use the Chat tester in the Knowledge tab to spot-check answers at any time — type a question, see the response, and see exactly which pages it came from.

How do I ensure the chatbot is giving updated information?

Regularly review and update the knowledge base, suggestions, and topics to avoid. This keeps responses accurate and aligned with your current offerings.

Can the chatbot handle multiple visitors at the same time?

Yes! The AI chatbot can engage with many visitors simultaneously, making it perfect for busy periods without requiring extra staff.

Can I turn off chat on specific pages?

Yes. Add the page's URL under Excluded URLs in the Overview tab, and the chat widget won't load there — useful for pages like a signup form or billing page where you don't want chat showing up.


Can I control what visitors see when they first load my site?

Yes. Under Page load behavior in the Overview tab, choose whether the engagement bar automatically opens to Smart nudges, opens straight to a specific screen (your Homepage or one of your engagement bar actions), or shows nothing until a visitor engages on their own terms. You can also set whether this applies on desktop only or everywhere, and customize the call-to-action text visitors see.

What's the difference between the Homepage and Smart nudges?

Smart nudges are AI-generated conversation starters based on the page a visitor is viewing. The Homepage is a home screen that greets visitors with your configured actions when the engagement bar opens. Neither is turned on by default, so you can use one, both, or neither.

Did this answer your question?