# 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:

```text
##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:

```text
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:

```text
##add_note## : Customer issue
```

Better:

```text
##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:

```text
##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:

```text
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](https://blog.zazzyagent.com/ai-agent-human-handoff-zazzyagent).

## Combine a note with a follow-up reminder

For tasks that require action later:

```text
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:

```text
##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](https://blog.zazzyagent.com/ai-agent-save-custom-fields-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

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