Skip to content
Docs

Create an outbound calling template

A call template lists the details you hold about each lead, such as their name or appointment date, and passes them to the agent on every outbound call made through a calling setup (bundle). That lets the agent greet each person by name and talk about their own appointment, order or quote. Templates belong to your agency, so one template can serve any number of clients.

Each variable in the template becomes a column in the client’s lead list and a placeholder in your agent’s prompt, written with double curly braces, for example {{lead_name}}. You write the prompt in ElevenLabs, Retell AI or Vapi.

How lead details reach the agent
  1. You

    Define the variables

    The template lists the details each lead has.

  2. You

    Upload the lead list

    The CSV has one column for each variable.

  3. Voice AI Portal

    Calls each lead

    It dials the lead's phone number from the list.

  4. Voice AI Portal

    Passes the details to the agent

    Each value fills its placeholder in the prompt.

  • Agency owner or admin access. Call templates are managed by agency owners and admins.
  • Your agent’s prompt open in the provider, so you can match the variable names exactly.
  • The use case in mind, for example appointment reminders or lead qualification.
  1. Open Call templates

    In the agency sidebar, select Campaign playbooks, then the call templates link at the bottom of the page. The Outbound Calling Templates page lists your templates with their use case and number of variables.

  2. Start a new template

    Select New template. The New Outbound Voice AI Template window opens on Template basics.

  3. Name the template

    In Template name, enter a name of 2 to 100 characters, for example Appointment Reminder V1.

  4. Choose the use case

    In Use case, choose one of the presets below, or choose Custom use case and describe it. A preset loads its suggested variables into the next step. A custom use case starts with lead_name and phone. Select Next.

  5. Edit the variables

    On Required variables, change the suggested variables or add your own with Add variable. Each row has a name, such as appointment_date, a type (string, number, date, boolean, phone or email) and a Required tick box. Drag the handle to reorder rows, and use the bin button to remove one. Select Next.

  6. Review and create

    On Review, check the name, use case and every variable. Select Back to change anything, then select Create template.

The template appears on Outbound Calling Templates, ready to use in a client’s outbound bundle. See Configure outbound calling.

Rule Details
Characters Letters, numbers and underscores only, starting with a letter, for example lead_name. Up to 64 characters.
Unique names Each name appears once in the template, whatever the capitals.
How many At least one and up to 50 variables per template.
The phone variable Always there and always required, shown as Required (phone). It is the number the agent calls, so it cannot be removed.
Required A required variable must have a value for every lead. Leads without one are listed as errors when you upload.
Type Each value is checked against its type when you upload, so a number variable needs a number.
Matching the prompt The name must match the placeholder in the agent’s prompt exactly. If the template says lead_name and the prompt says {{name}}, the agent receives nothing for that field.

Choosing a preset loads these variables. You can change any of them. Required variables are in bold.

Use case Suggested variables
Lead Qualification lead_name, company_name, phone, product_interest, budget_range
Appointment Reminders lead_name, phone, appointment_date, service_details
Payment Collections lead_name, phone, amount_due, due_date
Feedback Surveys lead_name, phone, last_purchase_date, customer_id
Sales Follow-Ups lead_name, phone, last_contact_date, quote_amount
Win-Back lead_name, phone, churn_date, last_order_value
Recruitment Screening candidate_name, phone, job_title, experience_years
Order Confirmation lead_name, phone, order_id, delivery_date

On Outbound Calling Templates, use the edit button on a template’s row to open it again, make your changes and select Save template. Use the delete button to remove a template: it removes the template and its variables for good.

A template that a client’s bundle uses stays in place, and the portal names the bundles that use it, for example “This template is used by the bundle “Appointment reminders”. Change that bundle to another template or delete it, then try again.” To retire the template, move those bundles to another template in each client’s Client settings first, then delete it.

Problem What to do
“Outbound templates are only available to agency admins.” Ask an agency owner or admin to create the template.
“Add a template name (at least 2 characters).” Enter a longer name.
“Use letters, numbers, and underscores only” Rename the variable, starting with a letter.
“Name must be unique” Two variables share a name. Rename one.
The agent does not use a lead’s details The variable name does not match the prompt placeholder. Check the spelling and capitals.
Campaign notes do not reach the agent Add {{campaign_notes}} to the agent’s prompt and publish the agent in your provider.
A lead list upload says columns are missing or unexpected The CSV columns must match the template’s variables. Select Download template in the upload window for a file with the right headers.
Some leads are listed as errors after an upload A required value is missing or a value does not fit its type. Fix those rows and upload them again, or untick Required if the agent can manage without the value.
“This template is used by the bundle …” The message names the bundles that use the template. Move each one to another template, or delete it, then delete the template.
You cannot remove phone Every outbound call needs a phone number, so phone always stays.