# Smart Handoff

## Overview

Even the most brilliant AI agents sometimes encounter scenarios that require a human touch—like a high-value lead asking to pay in cryptocurrency or a complex support query.

Instead of letting the AI guess or lose the lead, WhatSnap's **Smart Notification System** acts as a bridge. It allows your AI agent to "raise its hand" and alert your entire human team directly inside a **WhatsApp Group**.

{% hint style="success" %}
**The Value**: Think of this as "Mission Control" for your sales team. Your VAs, sales experts, and support staff can all reside in one WhatsApp group, ready to jump in the moment the AI signals for help.
{% endhint %}

***

## Key Benefits

| Benefit                   | Description                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| **Zero Latency Alerts**   | Notifications go straight to your phone via WhatsApp—no need to constantly check dashboards |
| **Collaborative Selling** | Alerts go to a group, allowing the right person (Sales vs. Support) to claim the task       |
| **Safety Net**            | Ensures complex or high-value inquiries are never mishandled by automation                  |
| **System Health**         | Get notified immediately if a WhatsApp connection drops                                     |

***

## Setup Guide

### Step 1: Prepare Your Team Group

Before configuring WhatSnap, create a destination for the alerts.

1. Open **WhatsApp** on your mobile device
2. Create a **New Group** (e.g., "WhatSnap Alerts" or "Sales Power Squad")
3. Add your relevant team members (VAs, Closers, Managers)
4. Go to **Group Info** → **Invite via Link** → **Copy Link**

### Step 2: Configure Notification Settings

1. Log in to your WhatSnap dashboard
2. Navigate to the **Settings** tab on the far right
3. Locate the **Notifications** section

### Step 3: Link the Group

1. Under **Notification Delivery Method**, select **WhatsApp Group**
2. In the **WhatsApp Group Invite Link** field, paste the link you copied

{% hint style="info" %}
A green banner will appear confirming you are currently connected to that specific group.
{% endhint %}

### Step 4: Enable Alert Toggles

Enable these critical alert types:

#### Account Disconnection Alerts

* **What it does**: Notifies you immediately if the QR code connection to the phone breaks
* **Action**: Toggle this **ON**

#### Agent Handoff Alerts

* **What it does**: The core feature. Notifies the team when the AI gets stuck, doesn't know an answer, or detects a lead needs human intervention
* **Action**: Toggle this **ON**

### Step 5: Save and Test

1. Click the purple **Save Notification Settings** button
2. Click the **Test Notifications** button
3. Check your WhatsApp Group—you should receive a test message confirming the connection

***

## How It Works in Practice

Once set up, the workflow is seamless:

```
1. THE CONVERSATION
   └── AI engages with a lead 24/7

2. THE TRIGGER
   └── Lead asks a question outside AI's knowledge
       (or AI determines it needs help)

3. THE ALERT
   └── AI stops responding to avoid hallucinations
   └── Sends message to your WhatsApp Group
       "🚨 Handoff Required: Lead [Name] is asking about [Topic]. Please intervene."

4. THE RESOLUTION
   └── Human team member sees notification
   └── Opens GoHighLevel or WhatSnap conversation view
   └── Takes over the chat manually
```

***

## Best Practices

### Dedicated Groups

Create a specific WhatsApp group *just* for these alerts so they don't get lost in general company chatter.

### Shift Management

If you have a large team, designate who is "on call" to watch the WhatsApp group for alerts during specific hours.

### Continuous Improvement

If you see the AI handing off too frequently on simple questions, use that data to go back and update your **Knowledge Base** or **FAQs** in the agent settings.

***

## Reducing Unnecessary Handoffs

Frequent handoffs on the same topic indicate a training gap:

1. Review handoff alerts in your group
2. Identify patterns (same questions triggering handoffs)
3. Add those Q\&As to your Knowledge Base
4. The AI learns and handles those queries automatically next time


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://whatsnap.gitbook.io/whatsnap-docs/ai-agents/smart-handoff.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.