Campaigns

Vobiz Campaigns is the bulk outbound dialler — upload a CSV of phone numbers, pick a reusable webhook Agent, set the calling rate, and Vobiz dials every contact at the configured CPS with retries, caller‑ID rotation, and per‑attempt logging.

URL

https://console.vobiz.ai/app/campaigns

The model

A campaign is built from three resources that live side‑by‑side in the Voice Applications sidebar:

Campaign Agents

Reusable answer/hangup webhook configs. Created once, used by many campaigns.

The actual outbound runs — agent + numbers + contacts + pacing.

Campaign Call Logs

Per‑attempt history for every campaign.

┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│  Agent        │──▶│  Campaign      │──▶│  Call Logs     │
│  Answer URL   │    │  CPS + numbers │    │  Per attempt   │
│  Hangup URL   │    │  + CSV         │    │  outcome       │
└───────────────┘    └───────────────┘    └───────────────┘
   reusable             one outbound run     the audit trail

Reuse a single Agent across many daily campaigns instead of re‑typing the same URLs every time you launch a run.

Create a new campaign

Click + New Campaign to open the side panel. The form is long; this page walks every field in order.

New Campaign side panel showing Name field (Q1 Appointment Reminders), Agent dropdown (API Test Agent 2), CPS and Max Concurrent number inputs (3 and 10), Timezone (Asia/Kolkata), Caller ID Strategy dropdown set to Pool — rotate from a list of numbers, Rotation Strategy segmented control with Round Robin selected (other options Least Used and Random), and a Limits section for Max calls (lifetime), Max calls per day, and Cooldown

1. Basic info

Field	Required	Notes
Name	✅	A label like “Q1 Appointment Reminders” — shown everywhere this campaign appears.
Agent	✅	Dropdown of every Campaign Agent on your account. The Agent decides Answer URL, Hangup URL, and static SIP headers.

2. Pacing

Field	Required	Notes
CPS (Calls Per Second)	✅	Peak dial rate. Vobiz queues attempts and releases them at this rate. Stay at or below your account’s CPS capacity.
Max Concurrent	✅	Cap on simultaneously active campaign calls. Use the CPS Calculator to size this against your expected call duration.
Timezone	–	Used by Daily calling window. Defaults to your account timezone (e.g. `Asia/Kolkata`).

A safe starting point is CPS = 3 and Max Concurrent = 10 for ~60‑second calls — that’s roughly 180 calls/minute steady‑state.

3. Caller ID Strategy

Decide which of your phone numbers should appear as the caller ID on each attempt.

Strategy	When to use
Pool — rotate from a list of numbers	Default. Spreads calls across multiple numbers to avoid carriers flagging a single number as a spam source.
Single — use one number	All calls show the same caller ID. Useful for branded outbound from one published business number.
Sticky — same number per contact	The same destination always sees the same caller ID across retries — better answer rates because the recipient learns to recognise it.

4. Rotation Strategy (only shown for Pool)

Strategy	How Vobiz picks the next number
Round Robin	Strict sequence `1 → 2 → 3 → 1 → 2 → 3 …`. Predictable, evenly distributes load.
Least Used	Picks the number with the fewest calls today first. Self‑balancing under uneven contact lists.
Random	Picks any active number at random. Best when carriers fingerprint Round Robin patterns.

5. Limits (optional, applied to every number in the pool)

Field	Notes
Max calls (lifetime)	Stop using a number once it’s placed this many calls total. `Unlimited` by default.
Max calls / day	Daily ceiling per number. Resets at midnight in the campaign’s timezone.
Cooldown (sec)	Minimum gap between two calls from the same number — useful when carriers throttle rapid repeats.

6. Select numbers + Contacts CSV

Scroll down for the second half of the form.

Select Numbers

Tick the caller‑ID numbers Vobiz should rotate through. The badge next to Select Numbers counts your current selection. Use the search to filter long lists.

Contacts CSV (required to start)

Upload a .csv file with at minimum a to column. Click Template to download a starter file with the expected schema:

to,name,custom1,custom2
+918065480214,Asha,reminder=2pm,
+919148227303,Ravi,reminder=4pm,

Custom columns are passed through to your Agent’s Answer URL as part of the campaign context — useful for personalised greetings and dynamic prompts.

Phone numbers must be in E.164 format (+<country><number>). Vobiz rejects rows without a leading +.

7. Daily calling window (optional)

Toggle on to restrict outbound dialling to specific hours in the campaign’s timezone — e.g. 9am–7pm Mon–Sat for India compliance. Attempts queue outside the window and fire at the next allowed slot.

8. Retry Attempts

How many times to retry a contact that didn’t answer (busy, no‑answer, network error). Range 0–5. Default 2. Vobiz uses an exponential‑backoff retry schedule.

9. Webhook URL (optional)

A campaign‑level webhook Vobiz POSTs to on every state change — campaign.started, attempt.placed, attempt.completed, campaign.finished. Use it to live‑update your dashboard or push outcomes into your CRM.

Example webhook URL

https://your-server.com/campaign-webhooks

Launch and monitor

Click Create Campaign at the bottom of the form. Vobiz validates the CSV, queues every row, and starts dialling at the next allowed slot. Watch progress from two places:

The Campaigns list itself — each row shows attempted / total, status, and ETA.
Campaign Call Logs — per‑attempt detail with hangup cause and (if recorded) audio.

Pause, resume, abort

Each campaign card has three controls:

⏸ Pause — stop placing new attempts. Calls already in flight finish normally.
▶ Resume — restart from where the pause left off.
⏹ Abort — cancel remaining attempts permanently. Completed attempts stay in the logs.

Tips

Always pilot. Run a 100‑row CSV first to confirm Agent Answer URLs, caller‑ID rotation, and CRM webhook handling. Then scale.
Stay under your CPS cap. A campaign exceeding the account cap will throttle silently — attempts queue but don’t dial.
Use Sticky caller ID for retries. Recipients answer familiar numbers much more often.
Compliance windows matter. In India, outbound calling outside 9am–9pm risks DLT complaints — set the daily window or set retry attempts conservatively.

Getting Started

Using Vobiz Platform

Compliance (India)

Tools

Campaigns — Launch & Manage Outbound Runs

The model

Campaign Agents

Campaigns

Campaign Call Logs

Create a new campaign

1. Basic info

2. Pacing

3. Caller ID Strategy

4. Rotation Strategy (only shown for Pool)

5. Limits (optional, applied to every number in the pool)

6. Select numbers + Contacts CSV

Select Numbers

Contacts CSV (required to start)

7. Daily calling window (optional)

8. Retry Attempts

9. Webhook URL (optional)

Launch and monitor

Pause, resume, abort

Tips

What’s next

Campaign Call Logs

CPS Calculator

Getting Started

Using Vobiz Platform

Compliance (India)

Tools

Documentation Index

​The model

Campaign Agents

Campaigns

Campaign Call Logs

​Create a new campaign

​1. Basic info

​2. Pacing

​3. Caller ID Strategy

​4. Rotation Strategy (only shown for Pool)

​5. Limits (optional, applied to every number in the pool)

​6. Select numbers + Contacts CSV

​Select Numbers

​Contacts CSV (required to start)

​7. Daily calling window (optional)

​8. Retry Attempts

​9. Webhook URL (optional)

​Launch and monitor

​Pause, resume, abort

​Tips

​What’s next

Campaign Call Logs

CPS Calculator

The model

Create a new campaign

1. Basic info

2. Pacing

3. Caller ID Strategy

4. Rotation Strategy (only shown for Pool)

5. Limits (optional, applied to every number in the pool)

6. Select numbers + Contacts CSV

Select Numbers

Contacts CSV (required to start)

7. Daily calling window (optional)

8. Retry Attempts

9. Webhook URL (optional)

Launch and monitor

Pause, resume, abort

Tips

What’s next