> For the complete documentation index, see [llms.txt](https://docs.yaeris.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yaeris.com/software/yaeris-radar/ai-call-outreach.md).

# Radar AI Call Outreach Campaigns

Connect Bland.ai or Retell AI, build a phone contact list, and launch AI voice-call campaigns that dial contacts automatically.

Connect your own AI voice-call provider, build a phone contact list, and launch campaigns where an AI agent calls each contact automatically.

{% hint style="info" %}
You'll need to connect a provider before you can create a campaign — the **New campaign** button only appears once at least one connection is active.
{% endhint %}

### Connecting a provider

1. Go to **Outreach → AI Call Outreach → + Connect provider**.
2. Choose a provider:
   * **Bland.ai** — write a free-text call script per campaign; calls go out from Bland's own shared number pool, no phone number setup needed.
   * **Retell AI** — runs against an agent (voice + LLM + prompt) you've already built in your own Retell dashboard; there's no script to write per campaign.
3. Optionally give the connection a **Label**.
4. Paste your provider **API key**.
5. If you chose Retell, also enter your **Agent ID** (`agent_xxxxxxxxxxxx`) and a **From number** already set up in your Retell account, in E.164 format (e.g. `+15551234567`).
6. If you chose Bland, you can optionally add a **Webhook signing secret** from your Bland Account Settings — without it, calls still place, but Radar won't receive live status, recordings, or transcripts back.
7. Click **Connect** — Radar test-calls the provider's API before saving. Your key is stored encrypted.

{% hint style="warning" %}
**Retell needs one extra manual step.** Retell has no per-call webhook — it only sends status updates to a URL you configure yourself in your Retell dashboard. After connecting, copy the webhook URL Radar shows you and paste it into your Retell account's webhook settings, or you won't receive status/transcript updates.
{% endhint %}

### Building your phone contact list

1. Go to **Contacts**.
2. Import contacts one of three ways:
   * **From a crawl** — pick a completed crawl job and import every phone number it found (in E.164 format).
   * **Add one** — manually enter a **Phone number** (E.164 format, e.g. `+15551234567`), plus optional Business name, First name, and Last name.
   * **Paste CSV** — paste rows in the format `phone_number,first_name,last_name,business_name`.
3. Manage the list — mark a contact **Do not call** / **Allow calls** again, or **Remove** it entirely.

### Launching a campaign

1. Go to **New campaign**.
2. Choose **Call with** — which connected provider/account to call from.
3. If you're calling through Bland, write a **Call script** — merge tags `{{first_name}}`, `{{last_name}}`, and `{{business_name}}` personalize it per contact. If you're calling through Retell, there's nothing to write here — it runs the agent already configured in your Retell dashboard.
4. Name the campaign.
5. Tick who to call from your contact list (up to 500 at a time — contacts marked "Do not call" are excluded automatically).
6. Click **Start calling**.
7. Track live results on the campaign page: status per contact (Queued, Ringing, In progress, Completed, No answer, Voicemail, Failed), call duration, a **Listen** link for the recording where available, and — if your connection has webhooks/transcripts enabled — the full call transcript.

{% hint style="info" %}
The calls themselves, and their per-minute cost, run through your own connected Bland.ai or Retell AI account — Radar's own credit balance only needs to be positive to start a campaign; it doesn't charge per call.
{% endhint %}