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
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.

Why this page exists
Section titled “Why this page exists”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).
One campaign per job, not per person
Section titled “One campaign per job, not per person”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.
What you configure here
Section titled “What you configure here”+ 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.
Also fill Campaign name, optional Description, and AI Agent, then Create campaign. You can edit everything after creating.

After save, the campaign editor has tabs. Day one usually uses:
Leave for later: custom stages, human agents, campaign call results, notifications, and goal-specific instructions when shown.
Campaign welcome message
Section titled “Campaign welcome message”In the campaign editor, Welcome message sets the first thing the agent says when a lead answers. Pick one:
Announcement only
Section titled “Announcement only”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.
Opening instructions
Section titled “Opening instructions”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.
Instructions for one lead
Section titled “Instructions for one lead”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.
Knowledge, languages and voices
Section titled “Knowledge, languages and voices”In the campaign editor, the advanced section Knowledge, languages and voices has three settings. All are off until you pick something.
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:
| Column | What it tells you |
|---|---|
| Leads called | Leads that heard this voice |
| Reach | Leads who actually answered and spoke |
| Positive rate | Positive answers out of the leads who spoke |
| Hung up within 20 s | Answered calls that ended in the first 20 seconds without a real answer |
| Average call, Minutes | How 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.
Creating a campaign from an AI assistant
Section titled “Creating a campaign from an AI assistant”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.
Human agents: who gets the next lead
Section titled “Human agents: who gets the next lead”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:
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).
Before you start a campaign
Section titled “Before you start a campaign”- 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, resume and stop
Section titled “Pause, resume and stop”- 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.
When a lead calls back
Section titled “When a lead calls back”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.
Change the agent
Section titled “Change the agent”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).
Bulk delete
Section titled “Bulk delete”To delete many campaigns at once, for example every campaign named “DEH”:
-
In the Campaigns list, type DEH in the search box.
-
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.
-
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.
Export the leads
Section titled “Export the leads”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.
-
+ New Campaign
Goal Blank. Name it after the job, not “Campaign 1”. Pick the agent (for example the onboarding agent). Create campaign.
-
Dialing
Call from a trunk that has numbers, or a verified caller ID. Concurrent calls = 1 for the first test.
-
Schedule
Company time zone. Weekdays. Hours that include now.
-
Save as Draft if needed, then open the campaign leads table.
-
Add one lead
Your own mobile. phone is required.
-
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.
-
Only then set Active
Status Active. Stay inside the window. Pause holds every call, callbacks included, until you resume.
Troubleshooting
Section titled “Troubleshooting”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.
