Skip to content
EN
Open app

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/outbound-calls/campaigns.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

Campaigns

17 min read
Copy as Markdown
View as MarkdownOpen the raw .md file.md

Sidebar - Campaigns is the list dialer. You pick a goal, an agent, a number to call from, a schedule, then the leads. The agent’s voice and Outgoing settings apply to every row.

Page line: Outbound calling campaigns — your AI agents dial leads on the schedule you set and capture structured results on every call.

A campaign starts as Draft. Nothing dials until status is Active and you are inside the calling days and hours.

Campaigns empty list No campaigns yet
ob-campaignsExpand

The API is one number at a time from your system. A campaign is a list you can pause, retry, and watch. Use it for reminders, qualification, invites, collections - not for a single missed-call callback (that is the API).

A campaign is a reusable setup: agent, goal, script, Call from, schedule, retries. The people it calls are its leads. When a new person needs the same kind of call, add them as a lead to the campaign you already have. Don’t create another campaign.

What differs per person goes on the lead row, not into a new campaign:

  • Offer, price, quantity, order number: extra Lead information columns, or the lead’s AI context.
  • A later call time: the lead’s scheduled time.

Create a new campaign only when something campaign-wide changes:

  • A different goal or script (sales offer vs. delivery check vs. thank-you call).
  • A different agent or brand.
  • A different Call from number.
  • A different schedule or retry policy.
  • A list you want reported on its own, for example “Autumn offer to past customers”.

Name campaigns after the job (“Order follow-ups”), never after a person or a date. If you name a campaign after one customer, you’ll end up creating another one tomorrow.

+ New Campaign opens Create a new campaign (Name the campaign and pick an agent.). What is this campaign for? sets the goal at create and stays.

I will write the script and fields myself
TURN ONBlankNEEDSStart empty and configure everything yourself. First campaign should be this.
Book a slot on the call
TURN ONBook appointmentsNEEDSThe agent proposes available slots and books appointments on the call. Needs calendar + Schedule Appointment on that agent when those are required.
Who is interested
TURN ONQualify leadsNEEDSFind out who is interested in your product or offer.
RSVP to an event
TURN ONInvite to an eventNEEDSInvite contacts and collect clear RSVPs.
Agree amount and date
TURN ONCollect paymentsNEEDSAgree on payment amount and date for outstanding balances.

Also fill Campaign name, optional Description, and AI Agent, then Create campaign. You can edit everything after creating.

Create a new campaign purpose tiles with Blank selected
campaigns-formExpand

After save, the campaign editor has tabs. Day one usually uses:

Campaign
Name, agent. The agent may lock after leads exist.
Dialing
Call from - trunk number / pool / verified caller ID. Concurrent calls. Allowed test numbers bypass anti-harassment for those DIDs.
Stages
When nobody answers: how many times to call back (0–10, default 3) and the wait between calls (1 hour to 4 weeks, default 4 hours). When a lead runs out of calls: an optional SMS or email, also after a hang-up without a result. When someone answers: the stages the AI picks from; a Try again stage has its own count and wait. A callback the person asked for always happens. How the limits add up: Call limits.
Schedule
Time zone, calling days, calling hours. Retries go out only inside these hours.
Lead information
What columns a lead row has. phone is required. Extra columns become prompt variables.

Leave for later: custom stages, human agents, campaign call results, notifications, and goal-specific instructions when shown.

In the campaign editor, Welcome message sets the first thing the agent says when a lead answers. Pick one:

The agent's welcome
The default. Uses the welcome message set on the agent. This is what you get when nothing is set on the campaign.
Same line every call
A fixed message, spoken word for word on every call.
Written for each call
The AI writes the opening line for each lead from the campaign goal and that lead’s details. This is an explicit opt-in: each call is then billed at least 10 seconds, even if nobody answers.

Under Same line every call, turn on Hang up after the message (announcement only) for one-way notices, such as a policy renewal reminder. The call ends as soon as the line has played. The agent does not wait for an answer, does not talk and says no goodbye. The call is recorded with the end reason announcement_completed.

It applies only to this campaign’s calls. Inbound calls to the same agent work as before. Leave interrupting the welcome off on the agent: if the lead cuts the message short, the call does not hang up and goes on as a normal call.

Under Written for each call, the Opening instructions field (up to 8,000 characters) tells the AI how to open the call: for example, greet with {{greeting}}, say who is calling and from which company, mention the lead’s car model.

Variables are filled in for each lead:

  • {{greeting}} - “good morning” or “good evening”, by your company’s time zone, in the agent’s language.
  • {{name}} - the lead’s name.
  • The lead’s own columns, for example {{model}}.

Use the Insert variable button to add one. Example:

Start with {{greeting}}, say you are calling from Example Motors about the {{model}} and ask if this is a good time.

Leave the field empty and the AI decides the opening itself. The instructions apply only to Written for each call; Same line every call ignores them.

To check the result, start a test call to yourself from the campaign (Try it on me) and listen to the opening.

One lead can have its own opening instructions. In Add lead or when you edit a lead, open Advanced and fill Greeting instructions. They replace the campaign’s opening instructions for that lead only; leave them empty and the lead gets the campaign’s. The field shows only when the campaign uses Written for each call.

When you add leads from a spreadsheet, a column named Greeting instructions, Welcome instructions or Οδηγίες χαιρετισμού fills it. A column named just Welcome is still the fixed welcome message.

In the campaign editor, the advanced section Knowledge, languages and voices has three settings. All are off until you pick something.

Knowledge files
The knowledge files this campaign’s calls answer from, instead of the agent’s. Use it when one agent runs campaigns for different products, so a call never answers from the other product’s files. Empty: the agent’s own files.
Lead languages
Which of the agent’s other languages a lead may start the call in. Each language speaks with the voice set for it on the agent. Then give each lead a Language: the call starts in that language and voice, and the agent can still switch if the person answers in another one. One campaign covers a list in two languages.

A lead’s Language is under Advanced in Add lead and when you edit a lead, and shows only when the campaign offers lead languages. In a spreadsheet, a Language or Γλώσσα column fills it: the code (en-US), the language (en) or its name (English, Αγγλικά). A value the campaign doesn’t offer is marked in red before you add the leads.

A lead without a language, or with one that is turned off on the agent, starts in the agent’s main language. The languages and their voices are set on the agent (Voice & Language); the campaign only picks among them.

Voices: one for the campaign, or several to compare

Section titled “Voices: one for the campaign, or several to compare”

The third setting, Voices, changes who speaks on this campaign’s calls.

  • One voice: every call of the campaign uses it instead of the agent’s voice. The agent keeps its own voice for everything else.
  • 2 to 5 voices: each lead gets one of them at random on its first call and keeps it on every call-back, so a person never hears two voices. The campaign results then compare the voices.
  • Empty: the agent’s voice.

Pick the voices with Add voice; the list opens on the agent’s provider and language. A lead that starts in another of the agent’s languages (above) speaks with that language’s voice and is left out of the comparison.

On the campaign’s Overview, Voices compared shows one row per voice, over the leads that heard it:

ColumnWhat it tells you
Leads calledLeads that heard this voice
ReachLeads who actually answered and spoke
Positive ratePositive answers out of the leads who spoke
Hung up within 20 sAnswered calls that ended in the first 20 seconds without a real answer
Average call, MinutesHow long the conversations ran

Until every voice has at least 30 called leads, the page says it’s too early to pick a winner. After that the voice with the best positive rate is marked Leading. Use for every lead keeps only that voice: the leads not called yet and the call-backs all hear it from then on. A removed voice stays in the table with its numbers.

The same numbers are in get_campaign_results (byVoice) for the AI assistant and the API, and create_campaign / update_campaign take voices.

create_campaign works in two steps. The first call creates nothing: it returns every value the campaign would get, defaults included, and the assistant shows them to you to keep or change. Only the second call, with confirm: true, creates the campaign. The defaults are the New Campaign screen’s: Monday to Friday 09:00-18:00 in the company time zone, and AI overflow off when you assign people. The API (POST /agentic/campaign/create) still creates at once.

When people from your team are assigned to a campaign, Dispatch strategy decides which of them gets an answered lead when more than one is free:

Random
Any free person.
Fewest answered
The person who took the fewest leads since they joined the campaign.
Round robin
A fixed turn: the person whose last lead was given longest ago. Everyone gets the same number of leads, however long their calls were.
Longest waiting
The person who has been free the longest since their last call ended (or since they joined). Use it when call lengths differ a lot: whoever just came out of a long call gets a breather.

Example: A, B and C took leads 1 to 3 in turn. A has just finished a 20-minute call, B has been free for 18 minutes, C for 10. Lead 4 goes to A with Round robin and to B with Longest waiting.

In the API and the AI assistant the values are random, least_answered, round_robin and longest_waiting (userSettings.dispatchStrategy).

  • The goal is fixed. You choose it when you create the campaign. To work toward another goal, create another campaign.
  • Book appointments needs Google Calendar connected and appointment booking turned on in the agent, with a calendar.
  • Call from must be a number you own: one on the campaign’s trunks, or a phone number you verified.
  • AI-written opening: when it is on, every call is billed at least 10 seconds, unanswered calls too. Leave it off unless you need it. See Campaign welcome message.
  • Calls at once: your plan sets the limit, shared with every other live call of your company. Concurrent calls on the campaign can only lower it.
  • Adding leads to an active campaign: they are called on the campaign’s next run, within its hours.
  • A number that is not callable is refused. When you add leads, any value that is not a real phone number - an order range like “11228-11229”, text, or a number the wrong length for the country - is shown in a warning (“not added, the phone number is not a callable number”) and left out of the added count. It is not added and never called. Fix the number and add it again. A bad number already on the list is parked as a failure instead of being dialed.
  • People who opted out are never called again by any campaign of your company. Don’t add them back.
  • Wait between calls: at least 1 hour, so nobody is called again within minutes. See Call limits.
  • Pause Campaign: nothing from the campaign is called while it is paused: no new leads, no retries and no callbacks, even ones booked for a set time. Nothing is lost and nothing counts as a call. A held callback shows as scheduled.
  • Resume Campaign: a callback whose time passed during the pause is called within about 5 minutes, as soon as the campaign’s hours and the 09:00–21:00 calling hours allow. A callback set for later keeps its time.
  • Complete campaign: ends the campaign. Its calls are held the same way and go out only if you activate it again.
  • Delete campaign: deletes the campaign and all its leads, and cancels their scheduled calls, callbacks included. The confirmation shows how many leads go with it. This can’t be undone. People who opted out stay opted out.

A lead who calls your number back is matched to their campaign lead by phone number, so the agent has the campaign context on that call. After the call, the post-call analysis can close the lead:

  • The AI picked a success stage on that call: the lead becomes successful and is not called again.
  • The AI picked a failed stage: the lead is cancelled and is not called again.
  • Any other result (a Try again or other stage, or no stage): the lead stays as it was, with its next call unchanged.

The call-back does not count against the lead’s calls. A lead that is already closed, is being called right now, or belongs to a completed campaign is left as it is. The change shows in the lead’s activity with the call it came from.

Open the campaign, Campaign tab, AI Agent, and pick another agent, then Update campaign. The change applies from the next call: leads, stages and schedule stay the same, and calls in progress finish with the previous agent. On an active campaign you are asked to confirm first. If the campaign’s agent was deleted, the field is empty and you must pick one before saving. The agent’s own voice, script and tools are changed in its settings (Open agent settings).

To delete many campaigns at once, for example every campaign named “DEH”:

  1. In the Campaigns list, type DEH in the search box.

  2. Tick the campaigns to delete, or tick the box in the table header to select every campaign the list shows. Click Load More first if some are not shown yet.

  3. Click Delete selected (N) in the bar above the list. The confirmation shows how many campaigns and how many leads will be deleted. Confirm.

Each campaign is deleted the same way as Delete campaign: its leads are deleted and their scheduled calls are cancelled. This can’t be undone. A message tells you how many campaigns and leads were deleted; any campaign that couldn’t be deleted stays selected.

You need permission to edit campaigns. Without it, the list shows no checkboxes.

From Claude or ChatGPT, ask for example “Delete all my DEH campaigns.” The assistant first lists the matching campaigns with how many leads each has, and deletes nothing. Only after you confirm does it delete them, the same way as above, and tell you how many campaigns and leads were deleted.

In the campaign’s leads table, select one or more leads to bring up the selection bar, then Export. Voice Logica builds an Excel file of the campaign’s leads and emails it to you. The sheet is in your company’s language, and every time reads dd/MM/yyyy HH:mm in the campaign’s time zone.

Each row has:

  • Phone Number and Email.
  • Status - the same wording as the leads table. A lead waiting for another call reads Retry scheduled; one with no calls left reads All attempts used.
  • Status Updated At.
  • View URL.
  • Name - read from the lead’s name columns.
  • Calls made / allowed - calls made so far out of the most the campaign can place (the first call plus the call-backs), for example 2 / 4.
  • Stage - the name of the stage the lead is on.
  • Next action - when the next call is due, or — when the campaign won’t dial this lead again.
  • Last call and Last call outcome (Answered, No answer, Busy, Voicemail, Failed, Cancelled, In progress). A scheduled, not-yet-placed call doesn’t count as the last call.
  • One column per Lead Data field, and one per Analysis Result from the answered calls.

First setup - one Blank campaign, one lead, Try it on me

Section titled “First setup - one Blank campaign, one lead, Try it on me”

Do this after Get outbound working.

  1. + New Campaign

    Goal Blank. Name it after the job, not “Campaign 1”. Pick the agent (for example the onboarding agent). Create campaign.

  2. Dialing

    Call from a trunk that has numbers, or a verified caller ID. Concurrent calls = 1 for the first test.

  3. Schedule

    Company time zone. Weekdays. Hours that include now.

  4. Save as Draft if needed, then open the campaign leads table.

  5. Add one lead

    Your own mobile. phone is required.

  6. Try it on me

    Enter that same mobile. This uses the campaign’s agent and goal - it does not wait for Active. Answer. Open Calls.

  7. Only then set Active

    Status Active. Stay inside the window. Pause holds every call, callbacks included, until you resume.

Why is my campaign Active but not making any calls?

Check in this order: the campaign’s calling days, hours and time zone include the current time; Call from has a number; the trunk is not disabled; the plan still has Allow Outbound Calls and credits. If human agents are assigned to the campaign, one of them must be online or overflow to AI must be on.

Why does Try it on me work but my campaign list is not called?

Try it on me ignores the Draft status and the schedule; the list does not. Set the campaign to Active and wait until the current time is inside its calling window.

I picked the wrong goal for my campaign. Can I change it?

No. The campaign’s purpose is set when you create it. Start a new campaign with the right goal instead of trying to turn, for example, an appointment campaign into a blank list.