Suarify Function Calling: avr_hangup, avr_save_yes_no_lead, avr_whatsapp & Friends

Quick answer: Suarify voice agents don’t only “talk.” During a live call they can call tools (function calling) — hang up cleanly with avr_hangup, capture a yes/no qualification with avr_save_yes_no_lead, send a WhatsApp follow-up with avr_whatsapp_send_message, book slots, press IVR digits, and more. That is how a conversation becomes CRM data, a WhatsApp summary, and a closed call — without a human typing notes.

This post is for founders and builders who want agents that do work mid-call, not only chat.

Table of contents

1. Why function calling matters on a phone call
2. Core tools you’ll use
3. Lead qualify flow: save yes/no → WhatsApp → hangup
4. How to prompt the agent
5. Reading captured yes/no leads
6. FAQ

1. Why function calling matters on a phone call

Without tools, an AI call is a fancy transcript. With tools, the agent can:

• Persist outcomes (yes / no interest)
• Message the customer on WhatsApp after (or during) the voice path
• End the call politely when the job is done
• Book appointments and navigate IVRs

RAW_PROMPT:
Infographic-style diagram for Suarify blog, teal/navy palette, clean white background, no purple glow: mermaid diagram #1 — Suarify Function Calling: avr_hangup, avr_save_yes_no_lead, avr_whatsapp & Friends

```mermaid
flowchart LR
  A[Caller speaks] --> B[LLM decides]
  B --> C{Need a tool?}
  C -->|Yes| D[Function call]
  D --> E[avr_save_yes_no_lead / avr_whatsapp / avr_hangup / ...]
  E --> F[System action + spoken confirm]
  C -->|No| G[Continue talking]
```

Related builds: DIY outbound · Malaysianize voices

2. Core tools you’ll use

Suarify’s agent UI exposes AVR-style tools (names you’ll see in prompts / tool schemas), including:

You enable the tools the agent may use, then teach the prompt when to call them.

RAW_PROMPT:
Infographic-style diagram for Suarify blog, teal/navy palette, clean white background, no purple glow: mermaid diagram #2 — Suarify Function Calling: avr_hangup, avr_save_yes_no_lead, avr_whatsapp & Friends

```mermaid
flowchart TD
  subgraph Capture
    A[avr_save_yes_no_lead]
  end
  subgraph Channel
    B[avr_whatsapp_send_message]
  end
  subgraph Control
    C[avr_hangup]
    D[avr_dial_avr]
    E[avr_do_booking]
  end
  A --> B
  B --> C
```

3. Lead qualify flow: save yes/no → WhatsApp → hangup

A common Malaysian outbound pattern:

1. Agent asks a clear qualify question (“Are you interested in a short demo this week?”)
2. On a clear answer → avr_save_yes_no_lead (persist yes/no)
3. Optionally → avr_whatsapp_send_message with a short summary + next step
4. When done → avr_hangup so minutes don’t burn on silence

RAW_PROMPT:
Infographic-style diagram for Suarify blog, teal/navy palette, clean white background, no purple glow: mermaid diagram #3 — Suarify Function Calling: avr_hangup, avr_save_yes_no_lead, avr_whatsapp & Friends

```mermaid
sequenceDiagram
  participant P as Prospect
  participant AI as Suarify agent
  participant T as Tools
  participant CRM as Yes/No lead store
  participant WA as WhatsApp
  AI->>P: Qualify question
  P-->>AI: Yes / No
  AI->>T: avr_save_yes_no_lead
  T->>CRM: Persist answer
  opt Follow-up channel
    AI->>T: avr_whatsapp_send_message
    T->>WA: Summary / link / thank-you
  end
  AI->>T: avr_hangup
```

WhatsApp tip: prompt the agent to call avr_whatsapp_send_message with:

• tophone — recipient number
• text — conversation summary / next step
• imageurl — optional (e.g. brand logo)
• using your active WhatsApp connection in Suarify

4. How to prompt the agent

Function calling only works if the prompt is explicit. Example rules you can paste into an outbound qualify agent:

When the prospect clearly answers YES or NO to the main interest question,
call avr_save_yes_no_lead immediately (do not only say “noted”).

If they say YES, optionally call avr_whatsapp_send_message with a short summary
and the booking / demo next step.

When the conversation is complete, or the prospect says goodbye,
call avr_hangup. Do not leave the line open.

Pair with flowchart design in the Suarify UI so non-developers see the same branch: Ask → Capture → WhatsApp → Hangup.

5. Reading captured yes/no leads

Answers from avr_save_yes_no_lead are queryable (developer portal / API) as yes/no lead responses — useful for:

• Filtering “keen” leads for human callbacks
• Dashboards of yes-rate by campaign
• Joining with outbound call logs (picked up / not picked up / declined)

See also API-oriented reading: API integration guide on the blog when relevant to your workspace.

FAQ

Is avr_hangup required?
If you don’t hang up, you risk dead air and wasted minutes. Teach the agent to hang up after the goal is met.

What’s the difference between saving a lead and creating a CRM contact?
avr_save_yes_no_lead captures a structured yes/no qualification outcome tied to the call. Full CRM sync can still use APIs/webhooks for richer fields.

Can WhatsApp replace the call?
No — use voice to qualify, WhatsApp to leave a written trail. Together they convert better than either alone.

Can I add custom tools?
Yes via vendor tools / schemas and your own HTTP handlers for bookings, inventory, tickets — same function-calling pattern.

Build further: AI receptionist hybrid · VoIP vs SIM · DIY vs Suarify

Explore Suarify · Book a demo · Developer portal on suarify.my for API keys.