Skip to main content
Campaigns

Smart Callback and Smart Do-Not-Call

Let an outbound campaign call leads back when they ask for it, and stop calling leads who ask not to be called, with a small setup in your agent.

Written By voiceaiwrapper

Last updated 19 days ago

Two controls make an outbound campaign respond to what people say on the call:

  • Smart callback: when a lead says "call me back tomorrow at 10", the campaign schedules the next call to that lead for that time.
  • Smart do-not-call: when a lead says "stop calling me", the lead is marked Do Not Call and isn't called again.

On Vapi, Retell AI, ElevenLabs and Bolna, you set these up once in your provider's agent by copying a field and a few prompt lines from VoiceAIWrapper. On VAW Native, the agent's post-call analysis handles both, so there's nothing to copy.

Available on: smart callback needs a plan that includes Smart callback. Without it, clicking Configure under Callback Settings shows an upgrade prompt, and callback requests are ignored. Smart do-not-call works on every plan.

Before you start

  • An outbound campaign on any engine except Ultravox. Ultravox campaigns don't have Advanced Controls.
  • Access to the agent in your provider account (Vapi, Retell AI, ElevenLabs or Bolna). The setup changes that agent.
  • For smart callback on those engines, your OpenAI API key connected to VoiceAIWrapper. It turns "tomorrow morning" into an exact time. See Connect Your OpenAI Key.

Find the controls

  1. Open your Pod (an engine or provider connection), select Campaigns, and click the campaign.
  2. Open the Settings tab and select Advanced Controls ("Power-user controls").
  3. You'll see two cards:
    • Callback Settings: "Configure the callback settings for your outbound campaign"
    • Smart Do Not Call: "Configure the Do Not Call(DNC) settings for your outbound campaign"
  4. Click Configure on a card. A dialog opens with the exact text to add to your agent, each part with a copy button.

Nothing in these dialogs is saved in VoiceAIWrapper. The setup lives in your provider's agent, so it works for every campaign that uses that agent. Click Got it to close the dialog.

On Vapi and Retell AI, the same tab also shows Lead Information Extraction Instructions, for capturing a lead's name and email. See Capture Lead Details from Provider Calls.

Set up smart callback

The callback dialog has three steps.

  1. Connect OpenAI API Key. A green tick means it's connected. If not, click Connect OpenAI Key.

  2. Add the callback field to your agent. Copy the field and add it where your provider stores post-call data:

    EngineWhere to add itWhat to add
    VapiThe assistant's Structured OutputsName caller_asked_for_callback_relative_time, type string, plus the purpose and description from the dialog
    Retell AIThe agent's Post Call Analysis sectionName caller_asked_for_callback_relative_time and the description from the dialog
    ElevenLabsThe agent's Analysis tab β†’ Data CollectionIdentifier caller_asked_for_callback_relative_time, data type string, and the description
    BolnaThe agent's Analytics tab, with extraction turned onThe formatted text from the dialog's Format line
  3. Configure your agent prompt. Add the sample prompt lines to the agent's prompt, so it asks when to call back and confirms the time.

Campaign details β†’ Settings tab β†’ Advanced Controls on a Retell AI Pod, with the callback instructions dialog open after clicking Configure under Callback Settings: step 1 Connect OpenAI API Key (with the Connect OpenAI Key button), step 2 Add Callback Post Call Data Retrieval Text to Agent with the property name caller_asked_for_callback_relative_time and its copy buttons, and the start of step 3 Configure Your Agent Prompt.

What happens on a call

When a lead asks to be called back, your agent captures the time in plain words, such as "today evening 6pm". After the call, VoiceAIWrapper uses your OpenAI key to turn that into an exact time in the campaign's time zone, and schedules the lead's next call for then.

If the callback call isn't answered, the lead goes back to the normal retry rules: the minimum wait between redials and the total attempt limit. See Outbound Dialing Rules: Attempts, Redial Wait, Voicemail and Priority.

Converting the time is a small request to OpenAI on your own key, which OpenAI bills to you.

Set up smart do-not-call

The Enable Smart Do Not Call dialog has two steps.

  1. Add the do-not-call field to your agent. It's a true/false field named caller_requested_do_not_call:

    EngineWhere to add it
    VapiStructured Output β†’ Create Structured Output β†’ Create from scratch. Type boolean, with the long description from the dialog.
    Retell AIYour agent β†’ Post Call Analysis β†’ Post Call extraction. A boolean field with the name and description from the dialog.
    ElevenLabsYour agent β†’ Analysis tab β†’ Data Collection β†’ Add Data Point. Identifier as above, data type boolean.
    BolnaAnalysis β†’ Extractions β†’ + New Extraction. Paste the extraction prompt, set the answer type to Pre-defined, and add the answers true and false with the conditions shown.
  2. Configure your agent prompt. Add the sample lines so the agent acknowledges the request politely and ends the call without pushback.

The Enable Smart Do Not Call dialog on a Vapi Pod: step 1 with the numbered instructions, the Name caller_requested_do_not_call, Type of Output boolean, the Description block with its copy button, and step 2 Configure Your Assistant Prompt with the sample prompt addition.

When a lead asks not to be called again, the lead is marked Do Not Call and dropped from the calling queue. On the Leads tab, the lead's do-not-call reason reads "The lead asked not to be called again." If the same call also asked for a callback, the do-not-call request wins and no callback is scheduled. See Do-Not-Call: Sources and Reasons.

On VAW Native

VAW Native agents handle both automatically on campaign calls. Post-call analysis checks every answered campaign call for a callback time and a do-not-call request. You don't need an OpenAI key, a field or prompt changes, and you can ignore the Configure buttons under Advanced Controls. Smart callback still needs a plan that includes Smart callback.

  • Callback: the lead's next call is scheduled for the time the caller asked for. A time that has already passed is ignored.
  • Do-not-call: works on outbound calls, and on inbound campaign calls too. The caller's lead is marked Do Not Call.

This only works when the agent has Analyze calls turned on. See Post-Call Analysis: Summary, Sentiment and Call Success.

Troubleshooting

Check that:

  • Your plan includes Smart callback. Without it, callback requests are ignored.
  • Your OpenAI API key is connected (not needed on VAW Native).
  • The field name in your agent is exactly caller_asked_for_callback_relative_time, and the call's post-call data shows a value for it.
  • The same call didn't also contain a do-not-call request, which cancels the callback.

Your plan doesn't include Smart callback. Upgrade to use it. Smart Do Not Call still works. See A Feature Is Locked or Asks Me to Upgrade.

The field must be a true/false (boolean) field named exactly caller_requested_do_not_call, on the agent this campaign uses. Open the call on the Calls tab and check that the field came back as true. If the agent didn't recognise the request, strengthen the prompt lines. You can always mark the lead yourself with Mark Do Not Call on the Leads tab.