How AI Agents Add Internal Notes in ZazzyAgent
An AI Agent can handle a conversation automatically, but sometimes your human team needs additional context.
An internal note lets the AI leave information for your team without sending it to the customer.
This is useful for things such as:
Callback requests
Important customer preferences
Sales information
Support issues
Escalation context
Information that a human agent should know before taking over
What is an internal note?
An internal note is information stored inside the customer conversation for your team.
The customer does not receive the note as a WhatsApp or Instagram message.
For example:
Customer wants a callback tomorrow afternoon.
A support agent can read the note when taking over the conversation.
The AI Agent action
Use:
##add_note## : Customer wants a callback
The text after the colon is the note that should be saved internally.
Example: Callback request
Suppose the customer says:
Can someone call me tomorrow?
Your System Prompt could contain:
When a customer requests a callback,
add an internal note explaining the callback request.
##add_note## : Customer requested a callback.
The note is stored for your team.
Make notes useful
A vague note isn't very helpful.
Weak:
##add_note## : Customer issue
Better:
##add_note## : Customer wants a callback regarding their delayed order.
The note should give the human agent useful context without becoming a transcript of the entire conversation.
Include the important detail
Suppose the customer says:
I need someone to call me after 6 PM because I want to discuss a bulk order.
A useful note could be:
##add_note## : Customer requested a callback after 6 PM regarding a bulk order.
Now the sales agent already knows the reason for the call.
Combine an internal note with human assignment
Internal notes become particularly useful during handoff.
Example:
When the customer requests human support for a delayed order,
add an internal note explaining that the customer is waiting for delivery information.
##add_note## : Customer is requesting help with a delayed order.
Assign the conversation to the Support team.
##assign_human_role## : 3
The human receives both:
Context
and
Assignment
instead of having to start the conversation from scratch.
You can learn more about AI-to-human handoff in How to Hand Off AI Conversations to Human Agents in ZazzyAgent.
Combine a note with a follow-up reminder
For tasks that require action later:
When a customer requests a callback tomorrow,
add an internal note.
##add_note## : Customer requested a callback tomorrow.
Create a staff follow-up reminder.
##follow_up## : 24
The note explains the reason.
The reminder helps the team remember the task.
Add sales context
A sales AI Agent could record:
Customer is interested in the Enterprise plan and wants pricing for 50 users.
The human sales representative can then continue the conversation with useful context.
Add support context
A support AI Agent could write:
Customer reports receiving a damaged product and wants a replacement.
This is much more useful than:
Customer has a problem.
Don't store unnecessary information
Internal notes should capture information that helps your team.
Don't use the action to save every customer message.
Good:
Customer requested refund review.
Less useful:
Customer said hello.
Keep sensitive information in mind
Internal notes are for your staff, but that doesn't mean you should store anything without a reason.
Only record information your team actually needs.
Example: Lead qualification
A lead agent might collect:
Name
Company
Budget
Requirement
After qualification:
##add_note## : Qualified lead. Interested in Enterprise plan; budget approximately ₹50,000.
The sales team can now see the important information immediately.
For structured customer data that should be stored as a reusable field, use a custom field instead. See How AI Agents Save Customer Information in ZazzyAgent.
Internal note vs custom field
Use an internal note when the information is contextual.
Customer wants a callback after 6 PM.
Use a custom field when you need a structured value.
Preferred Callback Time = 18:00
The two can work together.
Internal note vs customer message
An internal note:
Customer wants a callback.
Customer message:
Thanks! Our team will contact you shortly.
Don't accidentally send internal instructions as customer-facing text.
A useful handoff pattern
Customer
↓
AI Agent
↓
Issue requires human
↓
Add internal note
↓
Assign human
↓
Human takes over
This gives the human agent context before they respond.
Best practice
Use internal notes to answer one question:
What does the next team member need to know?
That keeps the notes short, useful and actionable.