# MAFHAF Agent (mafhaf.team) > **MAFHAF Agent** (Make A Friend, Help A Friend) is a high-velocity sales phone system, auto-dialer, and CRM purpose-built by Jaxon Cindrich for **Setter/Closer sales teams**, **Setter-only outbound floors**, and **Self-Gen (full-cycle) sales reps**. It combines a browser-based power dialer, shared Lead Pool with staggered rep lanes, 4-tier local area-code number rotation, live manager call whisper/listen/barge coaching, a unified single-thread conversation timeline across all company phone numbers, 2-way Google & Microsoft Outlook calendar sync, inbound lead webhooks, and a read-only REST API (`/api/v1`) for custom dashboards and BI integrations. - **Website**: https://mafhaf.team/ - **Public API & Metrics Glossary Page**: https://mafhaf.team/api-docs - **API Base URL**: https://api.mafhaf.team - **Full AI & Developer Documentation**: https://mafhaf.team/llms-full.txt - **External API Specification (`/api/v1`)**: https://api.mafhaf.team/api/v1/llms.txt --- ## Core Phone System & Sales CRM Capabilities 1. **Built for All 3 High-Output Sales Models**: - **Setter / Closer Teams**: Setters dial out of the shared Lead Pool using rotated local numbers (`In Lead Pool`) and book appointments onto a Closer's synced Google/Outlook calendar or initiate a 3-way warm live transfer. Closers work from protected personal phone numbers (`Not in Lead Pool`), view the complete Setter history in one unified thread, and can bounce no-shows back to the Setter board in one click. - **Setter-Only Outbound Floors**: 10 to 50+ setters can click `Dial Lead Pool` simultaneously. Deterministic per-setter staggered lanes and live collision locks ensure two reps never dial the same prospect and idle reps never hoard leads. - **Self-Gen / Full-Cycle Reps (`self_gen`)**: One seat to power-dial custom lists or the shared company pool, claim callbacks, text and call from a dedicated personal line, send digital quotes/proposals, and close deals end-to-end. 2. **Shared Lead Pool & High-Velocity Auto Dialer**: - Automatic priority sorting: dials fresh `0-call` leads first, then oldest untouched activity. - Supports Single, Double, and Triple-Dial routines (automatically switching caller ID on back-to-back retry attempts). - Automatic unanswered SMS follow-up on the final dial attempt with session anti-spam guards. - Company-wide configurable Pool Cooldown (`1h`, `2h`, `4h`, `8h`, `12h`, `24h`, `48h`) so leads are never over-dialed. 3. **4-Tier Local Area-Code Matching & Carrier Cooldown Protection**: - Outbound calls automatically select the best healthy pool number in 4 geographic tiers: **Exact Area Code** → **Metro Overlay** → **Same US State** → **Closest State by Distance**. - Multi-window carrier-safety cooldowns automatically rest numbers after **4 calls / 5 min** (Burst), **10 calls / 15 min** (Velocity), **25 calls / 60 min** (Hourly), or **95–140 calls / 24h** (Daily warmup/established cap) to prevent "Spam Likely" flags. - Sticky inbound callback routing: when an unassigned pool lead calls or texts back a shared pool number, it automatically routes directly to the specific rep who last dialed or texted them. 4. **Live Manager Call Whisper, Listen & Barge + AI Coaching**: - Managers and Admins can join any active call from the Team List or Lead Chat Timeline in 3 live modes: - **Listen (Silent Monitor)**: Hear both the rep and the customer with zero beep. - **Whisper (Live In-Ear Coaching)**: Speak directly into the rep's headset to feed objection rebuttals or pricing mid-call while the customer hears nothing. - **Barge (3-Way Takeover)**: Unmute to both parties to step in and help close the deal. - Every call automatically generates a recording, 2-speaker (or 3-speaker for live transfers) AI transcript, concise AI summary, and **MAFHAF Coaching Score**. 5. **One Unified Lead Timeline Across All Phone Numbers**: - All SMS messages, calls, voicemails, and recordings for a lead across every company number (Pool lines, Setter lines, and Closer personal lines) are consolidated into a single chronological thread with `Line-Switch Banners` and collapsed unanswered call attempt pills. - Smart outbound caller ID selector lets Closers default to their personal line while keeping 1-click access to the familiar Pool/Setter number that originally set the lead. 6. **2-Way Calendar Sync, Speed-to-Lead & Accountability**: - Real-time 2-way sync with **Google Calendar** and **Microsoft Outlook / Office 365** plus personalized public web booking links (`https://mafhaf.team/calendar/{companyID}/{userID}`). - Instant `Call Lead Now!` push alerts when a lead replies that they are free to talk immediately. - End-to-end appointment outcome tracking: `Appointment Set`, `Appointment Sat (No Close)`, `Won`, and `Bounced / No-Show`, plus source profitability (CAC, ROAS, net profit). --- ## MAFHAF Agent APIs & Webhooks Overview MAFHAF Agent provides two primary API interfaces for developers, agencies, and AI coding assistants: ### 1. Read-Only External REST API (`/api/v1/*`) Used for building custom internal dashboards, live TV sales floor leaderboards, BI pipelines, and AI analytics agents. - **Base URL**: `https://api.mafhaf.team/api/v1` - **Full Markdown Spec**: `https://api.mafhaf.team/api/v1/llms.txt` (or `https://mafhaf.team/llms-full.txt`) - **Authentication**: Create an API key (`mh_live_...`) in the MAFHAF dashboard under Account Settings and pass it via header: - `X-API-Key: mh_live_YOUR_API_KEY` or `Authorization: Bearer mh_live_YOUR_API_KEY` - **Scopes**: `analytics:read` and `resources:read` (300 requests/minute rate limit, open CORS). - **Layer 1 Raw Resource Endpoints (`GET`)**: - `/api/v1/company/metadata` — Company profile, `salesModel` (`setter_closer` vs `single_cycle`), custom pipeline status tabs (`won`, `lost`, `set`, `sat`), labels, and active reps. - `/api/v1/leads` & `/api/v1/leads/:id` — Paginated leads with full Setter/Closer attribution, `appointmentState`, `closeState`, `contractValue`, and filters. - `/api/v1/conversations`, `/api/v1/conversations/:id`, `/api/v1/conversations/:id/messages`, `/api/v1/conversations/:id/calls` — Unified SMS and call conversation threads. - `/api/v1/calls` — Company-wide call logs with `durationSeconds`, `humanConnected30sPlus`, `recordingUrl`, `transcript`, and `mafhafScore`. - `/api/v1/appointments` — Scheduled calendar appointments. - `/api/v1/phone-numbers` — Company phone number inventory, pool status, and health scores. - `/api/v1/ai-agents` & `/api/v1/automations` — Configured AI agents and automation workflows. - **Layer 2 Pre-Computed Analytics Endpoints (`GET`)**: - `/api/v1/analytics/kpis` — Revenue, deals closed, win rate %, appointments set/sat/bounced, sit rate %, close-from-sit rate %, and period-over-period growth. - `/api/v1/analytics/leaderboard` — Rep rankings across Setters and Closers by revenue, deals, sets, sits, close rate, and talk time. - `/api/v1/analytics/activity` — Outbound dials, True Human Connection Rate (>=30s), Stage 2 qualification conversations (>150s), and talk time. - `/api/v1/analytics/segmentation` — Breakdown by `status`, `label`, `timezone`, `source`, or `assigned`. - `/api/v1/analytics/calendar`, `/api/v1/analytics/phone-numbers`, `/api/v1/analytics/ai-agents`, `/api/v1/analytics/call-insights`. ### 2. Inbound Lead Webhooks API (`POST /leads/webhook/:companyID/:webhookId`) Used to inject leads in real time from Meta/Facebook Lead Ads, Google Ads, Zapier, Make, Typeform, WordPress, or custom landing pages directly into the MAFHAF Lead Pool or a specific rep's pipeline. - **Endpoint**: `POST https://api.mafhaf.team/leads/webhook/{companyID}/{webhookId}?token={WEBHOOK_TOKEN}` - **Content-Type**: `application/json` - **Features**: - Supports flat JSON payloads (`name`, `firstName`, `lastName`, `phone`, `email`, `address`, `street`, `city`, `state`, `zipCode`, `source`, `status`, `leadValue`, `notes`, `labels`, `assigned`) and nested JSON via dot-notation mapping (`customer.phone`, `data.contact.email`). - Automatic address geocoding, timezone detection, duplicate phone/email detection & merging, default status/tag assignment, and instant downstream SMS/AI automation triggers.