Deploy

Campaign operations guide

Prepare, launch, monitor, and evaluate outbound campaigns from the dashboard, including automatic callbacks and evidence based results.

Before you create a campaign

  • A tested voice agent with status Live.
  • A Ready phone number with Outbound or Both direction, assigned to that same agent.
  • A lawful reason to contact every recipient and an approved calling script.
  • An INR wallet balance large enough for the expected attempts and retries.
  • A CSV with international E.164 phone numbers, for example +919876543210.
  • A written campaign goal and an observable success condition.
⚠️
Run a small internal pilot before uploading a production audience. Test voicemail, silence, opt-out requests, interruptions, tool failures, callbacks, and the final call ending.

Prepare the contact CSV

The first row must contain column names. A phone or phone_number column is required. Name, email, and company are optional. Every additional column becomes a custom field that the agent can use during the call.

csv
phone_number,name,email,company,plan,renewal_date
+919876543210,Aarav Sharma,aarav@example.com,Acme India,Enterprise,2026-10-15
+919876543211,Meera Nair,meera@example.com,Northstar Retail,Growth,2026-11-01
RuleRequirement
PhoneRequired. Use + followed by country code and number; do not use local-only numbers.
File sizeMaximum 25 MB.
ContactsMaximum 1,00,000 rows per CSV.
Duplicate recipientsThe upload reports duplicates instead of silently calling them twice.
Custom fieldsUse short, relevant values. Do not upload credentials or unnecessary personal data.

Create and start the campaign

1

Open Campaigns

Go to Dashboard → Campaigns and choose Create campaign.

2

Choose the route

Enter a clear campaign name, select the Live assistant, and choose a Ready outbound caller ID assigned to that assistant.

3

Upload contacts

Drop the CSV into the upload step. Resolve every invalid phone number before continuing.

4

Set schedule and pacing

Choose Send now or Schedule, confirm Asia/Kolkata or the intended timezone, set the local call window, daily limit, concurrent calls, maximum attempts, and retry gap.

5

Set safeguards and outcomes

Keep opt-out protection enabled, configure consent and voicemail behavior, define the campaign goal and success criteria, and enable automatic callbacks when requested follow-ups should be scheduled.

6

Review and launch

Pass every readiness check and launch. Processing continues on the server after the browser is closed.

Pacing and retry controls

SettingWhat it controlsOperational guidance
TimezoneHow scheduled start and calling hours are interpreted.Use the recipient's operating timezone.
Local call windowHours in which new calls may start.Choose a permitted and appropriate window for the audience.
Daily limitMaximum contacts attempted per campaign day.Start with a pilot batch, then increase after reviewing quality.
Concurrent callsMaximum simultaneous campaign calls.Keep within organization, number, and provider capacity.
Max attemptsMaximum tries for one contact.Use the smallest number justified by the workflow.
Retry gapMinimum wait before an eligible retry.Avoid aggressive retry intervals.

Campaign lifecycle and controls

StatusMeaning
DraftCreated but not launched.
ScheduledWaiting for the selected start time or call window.
RunningEligible contacts are being dispatched within pacing limits.
PausedNo new calls start; active calls are allowed to finish.
CompletedNo campaign work remains.
CancelledRemaining queued work was permanently stopped.
FailedThe campaign stopped because of an operational error that needs review.
ActionEffect
View resultsOpens the dedicated campaign outcome workspace.
PauseStops new calls from starting. Active calls continue.
ResumeContinues eligible queued and retry-wait contacts.
CancelPermanently stops remaining campaign work.

Read the campaign results page

MetricHow to interpret it
Contact coverageUploaded contacts and the percentage with a classified outcome.
Pickup rateConnected call attempts divided by all call attempts.
Goal rateContacts marked Qualified or Resolved divided by all campaign contacts.
Campaign costTotal customer call charge in Indian rupees, with cost per achieved goal.
Verified resultsBusiness events such as bookings and payments that have confirmation evidence.
Attributed revenueVerified payment or revenue amounts displayed in INR.
QA scoreWeighted score for connection, classification, goal completion, and follow-up handling.

The conversion funnel shows how contacts move from uploaded to attempted, connected, classified, goal achieved, and verified. The campaign trend shows attempts, connections, and goals by day.

Review each contact

1

Filter the audience

Search by name, phone, email, or company. Filter by outcome or callback status.

2

Check delivery

Review queued, active, completed, retry, failed, suppressed, and cancelled states plus the last error.

3

Validate the outcome

Read the evidence level and quoted transcript evidence. Change the outcome when a human review finds a mistake.

4

Open the call

Choose Review transcript & recording to inspect the complete call, ending reason, usage, and INR charge.

5

Confirm business value

Record a verified appointment, booking, payment, revenue result, or qualified lead. Payment and revenue results require an external transaction reference.

6

Export

Apply any filters and choose Export CSV to download the same operational view for analysis or CRM reconciliation.

Automatic callbacks

When automatic callbacks are enabled and a caller asks to be contacted later, the platform schedules the follow-up in the campaign timezone. The callback continues without requiring the campaign page to stay open.

Callback stateAction
ScheduledThe callback is waiting for its requested time.
CallingThe callback attempt is currently active.
RetryingThe previous callback attempt was eligible for another try.
CompletedThe callback workflow finished.
Needs attentionAutomatic processing could not safely continue; review the contact and last error.
CancelledThe callback will not run.

Evidence, reanalysis, and the QA scorecard

  • System confirmed evidence comes from verified tools, callbacks, or business events.
  • Inferred evidence comes from transcript analysis and should be reviewed for high value decisions.
  • Human reviewed evidence records an operator's corrected outcome.
  • Rerun analysis processes available call evidence again after prompts, extractors, or historical records have been corrected.
  • Scorecard weights must total 100. Use higher goal weight when business completion matters more than raw pickup rate.
💡
A high QA score indicates that the configured observable checks passed. It does not replace transcript review, compliance review, or confirmation from the business system of record.

INR cost and revenue reporting

Campaign cost, cost per goal, call charges, and attributed revenue are shown in Indian rupees (INR). Historical USD call costs are converted with the platform billing exchange rate before they are included in campaign totals.

text
campaign cost (INR) = sum of customer call charges converted to INR
cost per goal (INR) = campaign cost / (qualified + resolved contacts)
attributed revenue (INR) = sum of verified payment and revenue events

Troubleshooting

SymptomWhat to check
Campaign will not launchAgent is Live; caller ID is Ready, outbound capable, and assigned to the same agent; CSV has valid contacts; wallet and call capacity are available.
Campaign is running but no call startsCurrent local time is inside the call window; daily limit is not exhausted; campaign is not paused; eligible contacts remain.
Many contacts are suppressedReview opt-out data, duplicate numbers, CSV phone formatting, and organization suppression records.
Many calls failOpen the contact's last call, inspect the ending reason, confirm carrier route and number readiness, then pause before retrying at scale.
Outcomes remain UnknownConfirm transcripts are available, run Rerun analysis, and review whether the campaign goal and success criteria are explicit.
Callback needs attentionOpen the contact row, inspect the callback error and requested time, correct the blocking issue, then handle the follow-up manually if needed.
Result total looks staleWait for active calls to finish and post-call analysis to complete, then refresh or rerun analysis.

Campaign API automation

Teams that create campaigns from a CRM can use the Campaigns endpoints in the interactive API reference at /docs/api. Use calls:trigger to create, upload, launch, review, and control campaigns; use read to retrieve progress and results.

💡
Use an idempotency key when creating a campaign, keep API keys on the server, and store external booking or payment references so verified results can be reconciled safely.