Skip to main content
A Campaign Agent is a reusable bundle of webhook configuration - the Answer URL, the Hangup URL, and any static SIP headers - that one or more campaigns share. Create the agent once and you can launch a hundred campaigns against it without re‑typing those URLs.
URL

​
The Agents list

Campaign Agents page subtitled Reusable webhook configurations shared across campaigns, showing two agent cards (API Test Agent 2 and test) each listing the Answer URL with POST method badge, the Hangup URL or Not configured, and Static SIP Headers (None for both)

Campaigns - Campaign Agents

Each Agent card shows: The pencil/trash icons on each card let you edit or delete the Agent. Deleting an Agent returns 409 while any linked campaign is running, queued, or paused. Finish, cancel, and archive those campaigns first.

​
Create a new Agent

Click + New Agent in the top‑right.
New Agent side panel with fields for Name (filled in with Appointment Reminder Agent), Answer URL with POST method dropdown, Hangup URL with POST method dropdown, and a Static SIP Headers section with an Add header link, plus Cancel and orange Create Agent buttons at the bottom

New Agent form

Click Create Agent.
Vobiz takes a frozen Agent snapshot when a campaign launches. Editing the Agent does not change campaigns that are already running or queued; the changes apply on the next launch.

​
Static SIP Headers - when to use them

The headers you add here are attached to every INVITE Vobiz sends on behalf of campaigns that use this agent. Common patterns:
  • X-Campaign-Source - tag for your downstream PBX or CRM to know the source.
  • P-Asserted-Identity - carrier‑specific identity routing (check with your trunk provider first).
  • X-RingTime - pass a max ring time hint to the receiving system.
Static headers apply to every call from every campaign that uses this agent. If you need per‑call values, set them in your Answer URL XML response with <SipHeader> instead.

​
Use the Agent in a campaign

Open Campaigns → + New Campaign - the Agent dropdown lists every agent on your account. Pick the one you just made and the rest of the form takes over from there.

​
What’s next

Launch a campaign

Wire this agent into a real outbound run.

XML reference

The XML your Answer URL should return.

Campaign Agents API

Create and manage Agents programmatically.