> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intellixent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Troubleshoot campaign startup errors, call failures, retry logic problems, and goal tracking issues.

<Warning>
  After starting a campaign, allow 10–15 minutes before expecting calls to begin. The system needs time to initialize and queue leads.
</Warning>

## Campaign Won't Start

<AccordionGroup>
  <Accordion title="&#x22;Your agent does not have a phone number setup&#x22;">
    Your assistant needs a phone number assigned before it can make outbound calls.

    1. Go to your **Assistant Settings** → **General** → **Phone Number Configuration**
    2. Assign a platform number, configure a SIP trunk, or set a Caller ID
    3. Save the assistant settings
    4. Return to your campaign and try starting it again
  </Accordion>

  <Accordion title="&#x22;Insufficient balance to start the campaign&#x22;">
    Your account balance is too low to cover the estimated cost of the campaign.

    1. Check your current balance in the **Billing** section
    2. Add funds to your account
    3. Return to the campaign and click **Start**
  </Accordion>

  <Accordion title="&#x22;No leads to call&#x22;">
    The campaign has no eligible leads left to dial.

    1. Add leads manually or import them from a CSV file
    2. Verify that your leads have valid, properly formatted phone numbers
    3. Check that leads aren't all already marked as completed
    4. Review the **"Mark complete when no leads"** setting to confirm it matches your intent
  </Accordion>
</AccordionGroup>

## No Calls Being Made

<AccordionGroup>
  <Accordion title="Campaign shows as running but no calls are happening">
    The campaign may be outside its allowed calling window.

    * Confirm the current time falls within your configured **allowed calling hours**
    * Check that today is an **allowed calling day**
    * Verify the **assistant's timezone** is set correctly and matches the schedule you intended

    If all of these are correct, adjust the allowed hours or wait until the next allowed time window.
  </Accordion>

  <Accordion title="All leads have already been called">
    If all primary leads have been attempted the maximum number of times (and secondary contacts have been tried), the campaign will sit idle.

    * Add more leads to the campaign
    * Review your **retry settings** — you may have set maximum retries too low
    * Check **goal-based retry** settings if you're using goal completion to control retry behavior
  </Accordion>
</AccordionGroup>

## Call Failures and Low Answer Rates

<AccordionGroup>
  <Accordion title="High rate of failed calls">
    Common causes include invalid numbers, network issues, or carrier restrictions.

    1. **Clean your lead data** — remove numbers that are malformed or known invalid
    2. **Check number format** — all numbers must be in E.164 format (e.g., `+1234567890`)
    3. **Test individual leads** — use the manual test call feature to call a specific number and check whether it connects
    4. Contact support if failures persist after cleaning your data
  </Accordion>

  <Accordion title="Most calls go to voicemail or are unanswered">
    This is usually a timing or lead quality issue, not a platform problem.

    1. **Adjust calling hours** — test different time windows; late morning and early afternoon often have higher answer rates
    2. **Increase the retry interval** — space out attempts so you're not calling the same person multiple times in a short window
    3. **Verify lead quality** — confirm numbers are current and that contacts are likely to answer
    4. **Review Caller ID setup** — ensure your outbound number displays a professional caller ID rather than an unknown or flagged number
  </Accordion>
</AccordionGroup>

## Retry Logic Problems

<AccordionGroup>
  <Accordion title="Contacts are being called too many times">
    1. Reduce **Max Retries** to 2–3 attempts
    2. Increase the **retry interval** to space calls 2–4 hours apart
    3. Disable **voicemail retry** if reaching voicemail should count as a completed attempt
    4. Review **goal variables** to ensure leads are being marked complete when appropriate
  </Accordion>

  <Accordion title="Not reaching enough contacts">
    1. Increase **Max Retries** up to 5 attempts
    2. Enable **voicemail retry** to keep attempting until a human is reached
    3. Adjust the retry interval to try different times of day
    4. For high-value prospects, enable **goal-based retry** so the campaign keeps trying until the goal is met
  </Accordion>
</AccordionGroup>

## Goal Completion Issues

<AccordionGroup>
  <Accordion title="Goal variable not being detected">
    The **Retry until goal completed** feature relies on post-call variable extraction. If it isn't working:

    1. Confirm **post-call variables** are configured in your assistant settings
    2. Ensure the variable tracking your goal is a **boolean type**
    3. Check that the **variable name** in your campaign settings matches the name in your assistant exactly (case-sensitive)
    4. Run manual test calls and verify the assistant is correctly extracting the variable

    Test variable extraction with manual calls before running a full campaign.
  </Accordion>

  <Accordion title="Leads are being marked as complete incorrectly">
    1. Review **call transcripts** for the leads in question to see how the AI interpreted the conversation
    2. Test your **variable definitions** with sample calls using different conversation outcomes
    3. Refine your **system prompt** to give the AI clearer criteria for what counts as goal completion
    4. Update the **variable description** in your assistant settings to be more specific
  </Accordion>
</AccordionGroup>

## Performance Optimization

<AccordionGroup>
  <Accordion title="Campaign is progressing too slowly">
    Slow progress usually comes from conservative settings or a high failure rate.

    * **Create multiple smaller campaigns** to process leads in parallel
    * **Optimize your calling window** — focus on peak answer hours
    * **Clean your lead list** — removing bad numbers reduces wasted time
    * **Extend allowed calling hours** if your compliance situation permits
  </Accordion>

  <Accordion title="Duplicate contacts are being called multiple times">
    1. **Deduplicate your lead list** before importing — check for number format variations (e.g., `+15551234567` vs. `15551234567`)
    2. Use a deduplication tool to identify records that represent the same person
    3. Standardize all numbers to E.164 format before importing
  </Accordion>
</AccordionGroup>

## Error Messages

| Error                             | What to do                                                                          |
| --------------------------------- | ----------------------------------------------------------------------------------- |
| "Campaign is already in progress" | The campaign is running. Pause it first before making changes.                      |
| "Campaign is not running"         | The campaign is paused or stopped. Click **Start** to resume calling.               |
| "Assistant timezone not set"      | Set a timezone in your assistant settings before creating or starting the campaign. |

## Before Contacting Support

Gather the following to help the support team resolve your issue quickly:

* Campaign ID and name
* The exact error message you received
* Steps you took before the issue occurred
* What you expected to happen vs. what actually happened
* Your assistant configuration and the phone number assigned to it