Skip to main content

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

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

Hamida Bapoo avatar
Written by Hamida Bapoo
Updated this week

Web chat is available on the Engagement Suite Foundation plan and above.

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.

Ways to connect with visitors

Nutshell Chat gives you two 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, collects Scheduler bookings and form submissions, and even creates leads for you. When a human touch is needed, the chatbot can hand the conversation off to your team.

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

1. Personalize your chatbot

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

Appearance

Here you’ll be able to customize the:

  • Widget color: There are default colors that you can select from, but you can also choose a specific color by clicking the '+' button

  • Icon: There are three default icons available for you to choose from. Alternatively, you could upload a custom image to add as your icon

  • Name: The name you’d like to display on the chat widget, perhaps your company name

  • Conversation starter message: This is the message that automatically shows in the chat widget to your visitors

  • Nudge message: Including a nudge message helps draw attention to visitors on your website, encouraging them to start a conversation. For example: Hi there! How can we help you today?

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 left side.

2. 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

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

3. Customize your intake

The Intake form lets you collect important information from visitors before they connect with your team. After a visitor sends a message, they’ll be prompted to fill out the form with their details. You can view the submitted information directly on the Person page in Nutshell.

  • Name: This field is required and automatically included in the form.

  • Phone and email: These fields are optional. You can choose whether or not to include them based on your preferences.

  • Intake type: Choose how to display the form, either by displaying a form in the widget or showing the form in a conversational format.

  • Creating a lead: Choose to automatically create a lead if your visitor doesn’t fill out any forms or meeting bookings. If the chat remains unanswered after an hour, a lead will automatically be created and added to the pipeline you selected.

Any collected details are automatically turned into leads inside Nutshell, so you don’t need to worry about copy-pasting info later.

4. Add Goals

Your chatbot is here to help guide your visitors toward your preferred outcomes. Decide what success looks like and choose one or more goals:

  • Schedule a meeting using Nutshell Scheduler: The chatbot can offer visitors to book a meeting using Scheduler.

  • Collect information through a form: Gather important details like name, email, company, or specific needs so your team has the context to follow up effectively.

  • Hand off to a teammate if someone is available: When a visitor’s question or request needs a human touch, the chatbot can connect them directly to the right teammate.

Assignments can be handled 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

By setting these goals, you make sure your chatbot steers conversations toward the outcomes that matter most to your business.

5. 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?

    • 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.

  • Choose a chatbot name or icon
    You can set a specific name for your chatbot and an icon from the available options

  • Set the 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
    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

6. 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.

7. 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.

Click it to open the embed modal, where you’ll find the code snippet for your chat widget.

To make the chat visible to your website visitors:

  • Check the Enable chat on your website checkbox next to the Chat snippet button on the Chat settings page.

  • Alternatively, you can toggle the widget on directly within the embed dialog after copying the code.

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

Managing chat threads

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:

  • Chat 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

    • Chatbot: the inbox for all open chatbot threads.

    • 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.

    • Filter: Admins can filter text messages by team members, and non-admins will only see threads assigned to them.

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, you'll see a +New Lead button next to the visitor's name. 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.

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 Enable chat for your website 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?

You can edit suggested answers, update the knowledge base it draws from, and review conversation logs to refine its behavior.

How do I prevent the chatbot from giving outdated 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.

Summarize this Article with AI

Did this answer your question?