โ˜• Grab a cup of coffee, this is going to be long, but worth every minute of your time

JoyzAI Platform Walkthrough

Your complete guide to setting up, training, and launching your AI-powered business assistant โ€” from first message to going live.

๐Ÿš€ Quick Setup (5โ€“10 Minute Launch Guide)

1
Add Knowledge Base
2
Set Chatbot Personality
3
Choose AI Model
4
Test Chatbot
5
Connect Website / WhatsApp
6
Go Live

That's it.

Table of Contents

๐Ÿ‘‹ What is JoyzAI?

What is JoyzAI? (a little context)

If you're new to JoyzAI, think of it like hiring a super-smart assistant who works 24/7 for your business, no matter if it's 10 PM or 2 AM.

Here's how it helps step by step:

โšก

๐Ÿ‘‰ Replies instantly 24/7

Late-night enquiries, early-morning questions, or weekends, JoyzAI responds instantly, even when your team is offline.

๐Ÿ”„

๐Ÿ‘‰ Handles repetitive queries

Customers often ask the same questions, such as pricing, timing, and services. JoyzAI handles those automatically, so you don't repeat yourself a 100 times.

๐Ÿค

๐Ÿ‘‰ Works like your team member

You can train JoyzAI by adding your business details to the knowledge base. Once it has the information, it will reply to customer queries as your support agent would.

โฐ

๐Ÿ‘‰ Saves you time and energy

Instead of spending hours answering small queries, you can focus on growing your business while JoyzAI takes care of customer conversations.

๐ŸŒ

๐Ÿ‘‰ Answers in the customer's language

Customers can ask questions in Punjabi, Gujarati, Tamil, and more. JoyzAI replies in the same language, naturally.


๐ŸŽฏ Audience

Who Is This For?

Founders overwhelmed with enquiries
Marketing teams who want to qualify leads better
Sales teams who don't want to waste time calling un-interested leads
Support teams answering the same questions daily
Businesses using WhatsApp for growth
Companies that want automation without complexity

๐Ÿ› ๏ธ Dashboard

Step-by-step breakdown of JoyzAI features

When you sign up for JoyzAI, you get a simple dashboard to set up and manage your chatbot. The idea is to help your business talk to customers 24/7 on your website and WhatsApp without losing sales or leaving customers frustrated.

The dashboard has 7 main categories:

๐Ÿ’ฌ
Chats
๐Ÿ“ข
WA Bulk Messages
๐Ÿค–
Chatbot
๐Ÿ”„
Workflows
๐Ÿš€
Go Live
๐Ÿ‘ค
Contacts
๐ŸŽŸ๏ธ
Tickets
Now, let's first head to the Chatbot option and understand it in detail. That's where you build your bot step by step. Think of it like training a new staff member who will talk to your customers 24/7.

๐Ÿค– Feature 1

1. Chatbot

Inside Chatbot, you'll see 6 subcategories:

Knowledge Base
Chatbot Personality
Unanswered Questions
AI Configuration
Test Chatbot
AI Agents
1.1 โ€” Knowledge Base ๐Ÿง 

This is the brain of your chatbot. It's where you give information about your business.

You can add information in 3 ways:

โœ๏ธ

Manual

Manually type info related to your business.

๐Ÿ”—

Website link

If you already have a live website, just add the link. The bot will read your pages (like Pricing, About Us, Blogs) and learn from them.

๐Ÿ“„

PDF

Upload a PDF with your business details to train the chatbot.

You can also edit and update content, and check when it was last updated on the platform, so the bot stays up to date with the latest information.
1.2 โ€” Chatbot Personality ๐Ÿ˜Ž

Next, you decide how your chatbot should look and talk to the customers.

Tone & Style

Do you want your bot to sound professional or casual?

Example: If you're using it for banking services, you may choose a professional tone but if you're a cafe, you may choose a more friendly and casual tone.

Reply Length

Short answers or detailed?

Example: A clothing shop may reply short ("Yes, we have this in stock"). A hospital may reply in detail ("We're open from 9 AM to 6 PM, here's the doctor schedule").

Use of Emojis

Some businesses (such as food delivery or gyms) may use emojis, while law firms might avoid them.

Bot Identity

You can name your bot ("AskJoyz" or "CareBuddy"), decide what it should say if it doesn't know an answer ("I'll get back to you soon!"), and list words it should avoid.

Custom Instructions

You can add rules like:

  • Always ask the customer's name first.
  • Reply only in English.
  • Capture intent (if someone asks for a price, the bot knows to share pricing details).
โ›ณ But remember that custom instructions aren't rigid parameters that the bot will follow. It depends on the conversation's context, and if the bot chooses to use them, it will.
1.3 โ€” AI Configuration ๐Ÿ›œ

Here, you select the AI model and type of knowledge base best suited for your task to get personalised, accurate, and efficient responses.

Here's the list of AI models that you can choose from:

Gemini 2.5 Flash
โ‚น7 / conversation
OpenAI O4 Mini
โ‚น9.5 / conversation
Gemini 2.5 Pro
โ‚น10.5 / conversation
Gemini 3 Pro Preview
โ‚น14 / conversation

Here's the list of knowledge base models that you can choose from:

DefaultFree
Hybrid Searchโ‚น1.5 / Conversation
Search With Titlesโ‚น2.5 / Conversation
DON'T PANIC, we'll be talking about the remaining subcategories (Unanswered questions, Test Chatbot, and AI agents) later. But first, let's talk about CHATS.

๐Ÿ’ฌ Feature 2

2. Chats

The Chats section shows all conversations between your customers and your chatbot. Think of it as your inbox, where you can see who messaged, what they asked, and whether the bot handled it.

Inside Chats, there are 3 parts:

๐Ÿ“ฅ

2.1. Unassigned Chats

These are the messages the bot hasn't answered yet.

For example: A customer asks your restaurant bot, "Can I get catering for 200 people?" If your bot doesn't have that info in its knowledge base, the chat will land here. You (or your team) can step in and answer manually.

๐Ÿ‘ค

2.2. My Chats

This is where you (or your staff) personally talk to customers.

Example: If a client asks about a special bulk discount or a custom request that the bot can't handle, you can reply directly from here. It's like taking over the conversation yourself.

๐Ÿค–

2.3. Bot Chats

These are conversations that your chatbot answered on its own.


โ“ Feature 3

3. Unanswered Questions

No bot is perfect on day one. This section shows you the questions your bot couldn't answer.

Example: A customer asks, "Do you have gluten-free pizza?"

If your restaurant never offers that, you can mark it as irrelevant.

If you actually do offer it but the bot doesn't have the information, you can add that info to the Knowledge Base. Over time, this helps your bot get smarter and more helpful.

Mark as irrelevant

If the product or service doesn't exist in your business, simply mark the question as irrelevant. The bot won't be flagged by it again.

Add to Knowledge Base

If you do offer it but the bot didn't know โ€” add that info to the Knowledge Base. Over time, this helps your bot get smarter and more helpful.


๐Ÿค– Feature 4

4. AI Agents

Think of an AI Agent as a focused team member with a clear job. Instead of one chatbot trying to do everything, you can create different agents for different tasks, like:

Lead qualification
Bookings and cancellation flow
Automate support queries
Payment collection
Remember that an agent cannot operate independently and must be integrated into workflows.

Here's a step-by-step breakdown of how to set up AI agents:

1

Step 1: Name your AI Agent

Start by giving your AI agent a clear name.

For example: "Sales Enquiry Agent" / "Order Support Agent" / "Lead Collection Assistant"

2

Step 2: Set the Agent Objective

Next, define the AI agent's main goal. This tells the AI what it should try to achieve during conversations.

For example:
โ€” Help customers get the right information and move them towards a purchase
โ€” Answer common support questions and raise tickets when needed
โ€” Collect customer details and pass serious enquiries to your team

This keeps the AI focused and prevents it from giving random or unnecessary replies.

3

Step 3: Define Agent Steps

AI Agents work best when you guide them. Instead of guessing, you tell the agent what to do at each step of a conversation.

You can:

  • Add steps one by one
  • Decide what happens next
  • Choose what actions the agent is allowed to take

For example:
โ€” Understand what the customer is asking
โ€” Look for the answer in your knowledge base
โ€” Save important details from the conversation
โ€” Take action, like sending data or creating a ticket

This makes conversations consistent and reliable.

Actions

Actions are the tools your AI agent can use while chatting.

Search your knowledge base

The AI can answer questions using your saved FAQs, documents, and policies. Instead of guessing, it replies with your actual business information.

Read user details

The AI can review customer details, including name, past interactions, and preferences.

Make API calls

This enables the AI to communicate with other tools or systems you already use. In simple terms, the AI can request information from another system or send data to it.

For example: Fetch order or booking details / Send lead information to your CRM / Update records automatically

MCP (Model Context Protocol)

MCP is what turns your JoyzAI chatbot from just replying to actually doing things. With MCP, your AI can connect to real systems, fetch live data, and take actions while chatting with users. In simple terms, MCP is how your AI agent interacts with your business tools in real time.

Using MCP, JoyzAI can connect with your existing tools and systems so the AI can:

  • Fetch real-time data (orders, payments, records)
  • Update information automatically
  • Search live information when needed

All of this happens inside the conversation, without human intervention.

4

Step 4: Action Permissions

Contact Field Permissions

To keep things safe and simple, you can allow access to up to 5 contact fields per permission type.

Read access

Choose what information the AI can view.

For example: name, email address, status, source

Write access

Choose what information the AI can save or update.

For example: name, email address, status, source

Ticket Creation Permissions

You can also decide whether the AI is allowed to create tickets. Choose:

  • Which ticket types can the AI create
  • What information is allowed to fill in
Only the first 5 fields of each ticket type are editable by AI.

๐Ÿ”„ Feature 5

5. Workflows

A workflow is a set of rules that tells the system what to do when an event occurs.

Every workflow follows the same structure:

Trigger Something happens
โ†’
Condition Should the workflow run?
โ†’
Action What should be done next?
"If this happens, and these conditions are true, then do this."

You can create and manage automated workflows to handle chats, contacts, and support actions with JoyzAI.

5.1 Chat Workflows
5.2 Contact Workflows
5.3 Support Ticket Workflows

Chat workflows control what happens during conversations.

Triggers โ€” When should the workflow start?

Triggers determine when the workflow begins.

Trigger
First incoming message

The workflow starts when a user sends their very first message.

For example: A user messages "Hi" for the first time โ†’ the workflow starts.

Trigger
Incoming message

The workflow starts every time a message is received.

For example: A user asks another question in the same chat โ†’ the workflow runs again.

Trigger
From the second incoming message

The workflow starts only with the user's second message.

For example: First message: "Hello" (ignored). Second message: "What are your prices?" โ†’ workflow starts.

Trigger
WACA template only

The workflow starts only when a user replies to a WhatsApp template message.

For example: A template is sent asking "Reply YES to continue" โ†’ user replies "YES".

Trigger
On sending the WACA template

The workflow begins when you send a WhatsApp template.

For example: A reminder template is sent โ†’ workflow starts immediately after.

Trigger Conditions โ€” Should the workflow continue?

Conditions determine whether the workflow should proceed.

Condition
If Recent message conditions

Checks the most recent message content or type.

For example: If the message contains the word "price".

Condition
If Conversation conditions

Looks at the overall state of the conversation.

For example: If the conversation is still open and not assigned to anyone.

Condition
If Intent conditions

Uses AI to understand what the user wants.

For example: If the user's intent is detected as a booking or enquiry.

Condition
If Contact conditions

Checks details about the person messaging.

For example: If the contact is marked as a returning user.

Condition
Else condition

Runs when none of the above conditions match.

For example: If the system cannot clearly understand the user's message, then this condition branch will work.

Actions โ€” What should happen?

Actions are what the system does after conditions are met.

Action
Send message

Sends an automatic message.

For example: Sending a reply with basic information.

Action
AI Agent

Hand the conversation to an AI agent that responds using any actions that take place with an AI agent.

For example: Answering FAQs based on business information provided.

Action
Send WACA template

Sends Meta approved WhatsApp template message.

For example: Sending a confirmation or reminder message.

Action
Delay

Waits for a set time before the next action.

For example: Waiting 10 minutes before sending a follow-up.

Action
API Call

Sends or fetches data from another system.

For example: Fetching order status from an external system.

Action
Send notification

Notifies your internal team.

For example: Alerting a team member that a conversation needs attention.

Action
Save data

Stores information from the conversation.

For example: Saving the user's preference or response.

Contact workflows control what happens when contact information changes.

Triggers

Trigger
On contact creation

Runs when a new contact is created.

For example: A new phone number is added to the system.

Trigger
On WhatsApp contact creation

Runs when a contact is created via WhatsApp.

For example: A user messages your WhatsApp number for the first time.

Trigger
On the website contact creation

Runs when a contact is created via the website.

For example: A user fills out a form.

Trigger
On WACA contact creation

Runs when a contact is created on whatsapp API integrated number through campaigns or an incoming msg on the number.

For example: A user clicks an ad and starts a WhatsApp chat.

Trigger
On contact updation

Runs when contact details are changed.

For example: A contact's status is updated.

Condition

Condition
If condition

Checks if specific rules are true.

For example: If the contact's country is India.

Actions

Actions here work the same way as chat actions.

For example: Sending a welcome message, assigning an owner, or saving data.

Support ticket workflows automate what happens around support tickets.

Triggers

Trigger
On support ticket creation

Runs when a new support ticket is created.

For example: A user submits a support request.

Trigger
On support ticket updation

Runs when a ticket is updated.

For example: The ticket status changes from open to resolved.

Trigger Conditions

Condition
If conditions

Checks details about the ticket.

For example: If the ticket priority is high.

Condition
If contact conditions

Checks who raised the ticket.

For example: If the user is a priority customer.

Actions

Actions control what happens next.

For example: Sending updates, assigning a team member, or notifying managers.


๐Ÿ‘ค Feature 6

6. Contacts

Contacts is where every lead created from a conversation lives, along with the full context of that conversation.

Instead of pushing data out to different tools, JoyzAI lets you manage leads right where they are created, inside the chat itself.

For example:

Every contact has some details defined by the user, like:

Name
Phone number
Email address
Assignee
Status
SourceWebsite, WhatsApp, WACA, etc.

So at any point, your team knows: who the lead is, what they asked, the source of the lead, and who is responsible โ€” all without guessing.

Every business tracks different things. That's why JoyzAI lets you create custom contact fields based on your workflow.

For example:

Budget range
Product interest
City or region
Preferred callback time

Once created, these fields can be:


๐ŸŽŸ๏ธ Feature 7

7. Tickets

Tickets help you turn important customer conversations into trackable tasks for your team.

Instead of issues getting lost inside chat threads, Tickets make sure:

Tickets are available below Contacts in the JoyzAI platform.

You can create different types of tickets based on your business needs, such as:

Billing tickets
Bug or technical issue tickets
Support or follow-up tickets

Each ticket type can have its own custom fields, so your team always collects the right information.

To create a ticket manually:

1. Go to Contacts

Navigate to the Contacts section in the platform.

2. Open a contact

Once you open a contact, you'll see three options: Chats, Notes, and Tickets.

3. Click Ticket option

You'll see the ticket dashboard below.

4. Fill in details

Select the Ticket type and enter Topic, Status (open, closed, in progress), Priority, description, and assign to a team member.

5. Click Create

Your Ticket is created and assigned to a team member.

But if you haven't created AI agents in the workflows, and only use Chatbot to provide knowledge, you can create Tickets by going to Chatbot.

To enable this:

You can create up to 5 ticket types. This helps AI better understand context and provide timely, accurate responses.

For each ticket type:

For example:

Issue type
Priority
Short description
Order or reference ID
Customer concern

To make changes to these custom fields or create your own fields, go to Ticket โ†’ Ticket Info. Once you click Ticket Info, go to the ticket type, and you'll notice custom fields. You can also create your own fields based on your business requirements.

To create a new field, go to the top right corner and click "new field". Enter the necessary details and save.

Voila! A field is created successfully.
Remember that a field can only be deactivated or activated, not deleted.

๐Ÿ“ข Feature 8

8. WA Bulk Messaging

Imagine you own a coffee shop and want to share a "Buy 1, Get 1 Free Croissant" offer with all your customers. Sending messages manually takes hours; sending directly from Personal WhatsApp risks having your number blocked; and using the WhatsApp Cloud API directly isn't possible.

The WhatsApp Cloud API is Meta's platform that allows businesses to send messages to hundreds or thousands of customers at scale. It's designed for businesses, not personal use. It lets you send notifications and promotional messages safely and reliably. It supports automation and templates to help businesses manage large-scale messaging.

Businesses cannot use the WhatsApp API directly. To access it, you need to obtain access through a Business Solution Provider (BSP).

Why a BSP is needed:

How to send WA Bulk Messages using JoyzAI?

Dashboard metrics:

Message ProgressHow many messages were sent vs. failed
Delivery ReportHow many reached the recipient and how many were opened
Replies ReportWho clicked links or replied
Failure ReportWhy some messages didn't go through (wrong number, inactive WhatsApp, etc.)
Cost OverviewKnow exactly how much you spent on your campaign
Failure Report: This is usually a Meta's problem, and almost every vendor goes through this.

๐Ÿงช Feature 9

9. Test Chatbot

Before going live, test your chatbot.

Type in questions like a customer would and see how the bot replies.

If the replies look good, great! If not, go back and add information in the knowledge base and improve the bot's personality.


๐Ÿš€ Feature 10

10. Go Live

Building your JoyzAI chatbot is just the first step. Go Live is where you decide where your chatbot should actually start talking to customers.

You have 3 options:

๐ŸŒ 1. On Your Website

If lots of people visit your website and ask questions, this is the best place to start. But before enabling the website chatbot, you need to set it up. Below are the steps to follow:

  • Chatbot logo: This is like putting a little button on your website that says, "Chat with us!" You just give the system a link to that button.
  • Choose size: Set the chat box to small, medium, or large to adjust its size on your page.
  • Device visibility: Choose where you want your chatbot to be visible: phone, desktop, or both.
  • Initial questions: Here, put the top 3 FAQs to assist users in the chatbox.
  • Initial greetings: Decide how the bot should say hello, something simple like "Hi! How can I help you today?"
  • Background colour: Match the chat box to your website or brand by selecting your preferred colour.
  • Preview: See what the chat box will look like before going live.
  • Integration code: Copy a small piece of code and put it into your website's header, and you're good to go.

๐Ÿ’ฌ 2. On Your Native WhatsApp

This is your regular WhatsApp number (the one you already use on your phone). To configure the WhatsApp chatbot, you need to follow the steps below:

  • Add the number: Tell JoyzAI which WhatsApp number to use to answer messages.
  • Enable chatbot responses: Turn on the feature to enable automatic replies.
  • Choose chat type: Decide if it should answer one-on-one messages, group messages, or both.
  • Exclude people: Prevent the bot from replying to specific contacts, such as family or teammates.
  • Pause time: If you want to reply yourself sometimes, set how long the bot should wait (0, 3, or 5 minutes) before replying.
  • Block explicit messages: You can ask the bot to automatically block people who send spam or inappropriate messages.

๐Ÿ“ก 3. On WACA (WhatsApp API)

This is a more professional setup for businesses that want to manage large volumes of WhatsApp messages efficiently.

  • Add your WhatsApp Business number: The number customers will message.
  • Enable chatbot responses: Turn it on to enable automatic replies.
  • Enable notifications: You'll get alerts when new messages come in.
  • Pause time: Set how long the bot waits if you decide to respond yourself.
  • Save settings: That's it!