Skip to main content

Campaign Troubleshooting

Common situations met while building, running and reporting on a campaign, with the likely cause and the recommended resolution. Sections follow the order of the Campaign guides.

Five Checks to Make First​

Most campaign questions are answered by one of these five checks.

  1. What is the campaign's status? Pending, Started, Paused and the other states decide which actions are available and whether anything is being dialed.
  2. What does the Lead Status Breakdown show? It shows at a glance whether leads are waiting, being dialed, connected or not connected.
  3. Is an agent available? The Agent Availability panel in the detail panel shows whether anyone in the group can take a call.
  4. What does Campaign Execution say? The expanded log gives each action, its status and the reason for it.
  5. Does the user's role allow the action? A missing icon or a blocked screen is often a missing Campaign permission.

Getting Started​

SymptomLikely CauseResolution
A channel card on the first step cannot be selected.The channel is greyed out because it is not enabled for the organization.Ask an administrator to enable the channel, or choose one that is available.
The channel or the campaign type cannot be changed on a saved campaign.Both lock when the campaign is saved.Create a new campaign with the channel and type you need.

Campaign Channels​

SymptomLikely CauseResolution
The Details step will not accept a campaign title.A title must be unique across every campaign, whatever its channel.Choose a different title.
A WhatsApp campaign cannot be configured past the template step.No approved Template exists, and a WhatsApp campaign can only send an approved one.Create or approve a suitable template first, then return to the wizard.

Campaign Builder​

SymptomLikely CauseResolution
The wizard will not continue past the Audience step.Dialing Fields has not been set, and it is required.Choose the phone number field to dial, then continue.
The wizard will not continue past the Configuration step of an agent campaign.Agent Group has not been chosen, and it is required.Select the group of agents who will take the calls.
The Caller ID (CLI) dropdown reads No data.No outbound trunk has been configured for the organization.Leave it empty, since Caller ID is optional, or ask an administrator to configure a trunk.
A Power campaign cannot move past the Configuration step.Number of Concurrent Calls or Max Waiting Calls in Queue is empty, and both are required.Enter a value in each field, then continue.

Campaign Filters​

SymptomLikely CauseResolution
The Filter dropdown on the Audience step reads No data.No filter has been saved against the chosen module.Open the module's own list, build the filter, save it with a name, then return to the wizard.
A saved filter is missing from the dropdown.The filter was saved on a different module, and filters are scoped to the module they were built on.Select the module the filter belongs to, or save the filter on the correct module.
The campaign is saved but shows no leads.The filter matches no records, or the import has not finished yet.Wait a moment and refresh. If it is still empty, check the filter's conditions on the module's list.

Dispositions​

SymptomLikely CauseResolution
The Disposition dropdown is empty or shows an unexpected list.Call Type has not been chosen, and the list is scoped to the Call Type.Choose the Call Type first, then open the Disposition dropdown.
Agents do not see a prefilled disposition.Enable Dispositions is off, or the Disposition field was left empty. Every field in this step is optional.This is expected. Agents can still record a disposition after each call.

Scheduling and Retries​

SymptomLikely CauseResolution
The wizard will not move on from the Schedule step.Schedule Start Time has not been entered, and it is required.Set a start time, then continue.
A recurring campaign keeps using the same contacts.Update leads when resuming campaign is off, which is its default.Turn it on so the audience syncs from the CRM each time the campaign resumes.
Retry attempts start again after a campaign is rescheduled.Rescheduling resets retry attempts and starts over.This is expected. Reschedule only the statuses that need another attempt.
A manual retry does not follow the retry settings.Retry settings apply only to automatic retries for failed attempts. Manual retries are ignored.Rely on Retry Interval and Max Retry Attempts for automatic attempts only.

Managing Live Campaigns​

SymptomLikely CauseResolution
Reschedule, Topup, Edit and Delete are greyed out.The campaign is Started. Those four actions work only while it is Pending or Paused.Pause the campaign, make the change, then run it again.
A campaign stays Pending after it is saved.It waits for its Schedule Start Time, or for someone to run it.Wait for the start time, or click the Run icon in the detail panel.
The Reschedule button is disabled.No Lead Status has been ticked.Tick one or more statuses, or Select All.
Pending is not offered in the Reschedule dialog.A Pending lead has not been dialed yet, so it has nothing to reschedule from.Start the campaign so Pending leads are dialed first.
Topup created duplicate contacts, or replaced existing ones.The option chosen under When a matching record is found was Duplicate or an Overwrite option.Use Ignore, the default, unless replacing records is intended.

Campaign Monitoring​

SymptomLikely CauseResolution
The Campaign Execution list says No data.The campaign has not run yet, so there is nothing to log.Start the campaign, then refresh the list.
The log shows many SYSTEM_RETRY entries with NO AGENTS AVAILABLE.No agent in the group is free to take a call, so the engine retries on its own.Check Agent Availability, and make sure agents in the group are logged in and ready.
Leads stay Queued for a long time.The campaign is waiting for an available agent, or for the next dialing turn.Check Agent Availability and the Campaign Execution log. Add agents to the group if calls are waiting.
A lead shows Not Connected.The call was placed but not answered, or the number could not be reached.Open the lead's detail page and check its Calls panel and Call Status.

Reports and Dashboards​

SymptomLikely CauseResolution
The Lead Detail Report shows No data.No Campaign filter has been chosen, or the campaign has not placed any calls.Open Filters, choose the Campaign, and click Generate Report. Start the campaign first if it is still Pending.
The Campaign Summary shows dashes under the status columns.The campaign has no calls under those call statuses yet.Wait until calls have been placed, then refresh the report.
Dashboard widgets show zero for a campaign that has run.The Campaign Date filter, set to This Month by default, excludes the campaign.Open Filters on the dashboard and widen the Campaign Date.

DNC Management​

SymptomLikely CauseResolution
A number on the do not call list was still called.The entry was added after the audience was imported. A new entry only affects later imports and redials.Add opt outs before the audience is pulled, and remove the number from the campaign's leads if needed.
An entry does not block a campaign it should block.The Channel or the Type of the entry does not match the campaign. Each entry blocks one combination.Create an entry with the same Channel and Type as the campaign.
An email domain is still being contacted.Only individual addresses were added, not the domain.Add the bare domain, such as @domain.com, to block every address at it.
A DNC entry is still listed after the delete icon is clicked.The delete icon opens a confirmation first, and the entry stays until Yes is clicked.Click Yes on the Delete this DNC entry? prompt.

Permissions​

SymptomLikely CauseResolution
A user cannot open the Create Campaign wizard.Manage Campaigns is set to No access on the user's role.Raise Manage Campaigns to Own, Group or All on the role.
A user can see a campaign but cannot start it.Execute Campaigns is set to No access.Grant Execute Campaigns to roles that are trusted to start dialing.
A user cannot open the Campaign Leads screen or the Lead Status Breakdown.View Leads is set to No access.Set View Leads to the access level the role needs.
A user cannot open DNC Management.Manage DNC List is switched off. It is a plain switch, separate from the access levels.Switch Manage DNC List on for the role.