skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
bolna-ai/skills70 installs

make-call

Initiate, schedule, personalize, retry, and stop outbound Bolna Voice AI calls. Use when the user wants to test an agent, call a recipient, schedule a callback, pass user_data dynamic variables, override a same-provider voice, or cancel a queued or scheduled call.

How do I install this agent skill?

npx skills add https://github.com/bolna-ai/skills --skill make-call
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is safe to use for managing Bolna Voice AI calls. Users should be aware that data imported from CSV files or provided via command-line arguments is passed directly to the AI agent without sanitization, creating a potential surface for indirect prompt injection that could influence the agent's behavior.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Make Bolna Calls

Endpoints

  • Make call: POST https://api.bolna.ai/call
  • Stop one queued or scheduled call: POST https://api.bolna.ai/call/{execution_id}/stop
  • Inspect results: use get-executions with the returned execution_id.

Required fields

  • agent_id: Bolna agent UUID.
  • recipient_phone_number: E.164 recipient phone number, for example +919876543210.

Optional fields

  • from_phone_number: E.164 sender number. Omit when using Bolna default outbound numbers.
  • scheduled_at: ISO 8601 datetime with timezone, for example 2026-05-19T18:30:00+05:30.
  • user_data: dynamic variables referenced in prompts or welcome messages, for example {customer_name}.
  • agent_data.voice_id: override voice within the same configured TTS provider only.
  • bypass_call_guardrails: when true, skip agent calling window checks for this call. Use only for testing, emergencies, or explicitly approved priority calls.
  • retry_config: retry failed calls for no answer, busy, failed, error, or voicemail cases.

Immediate call

curl --request POST \
  --url https://api.bolna.ai/call \
  --header "Authorization: Bearer $BOLNA_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "agent_id": "123e4567-e89b-12d3-a456-426655440000",
    "recipient_phone_number": "+919876543210",
    "user_data": {
      "customer_name": "Amitesh",
      "plan": "Pro"
    }
  }'

Expected response:

{
  "message": "done",
  "status": "queued",
  "execution_id": "123e4567-e89b-12d3-a456-426614174000"
}

Always save execution_id; it is the join key for webhooks and execution lookups.

Scheduled call

{
  "agent_id": "123e4567-e89b-12d3-a456-426655440000",
  "recipient_phone_number": "+919876543210",
  "scheduled_at": "2026-05-19T18:30:00+05:30",
  "bypass_call_guardrails": false
}

Avoid timezone-less datetime strings.

Guardrails

If the agent has calling_guardrails.call_start_hour and call_end_hour, Bolna evaluates those against the recipient's local timezone. Outside the allowed window, the call can be rescheduled instead of placed immediately. Use bypass_call_guardrails: true only when the user explicitly wants to ignore that time window.

Retry config

{
  "retry_config": {
    "enabled": true,
    "max_retries": 2,
    "retry_on_statuses": ["no-answer", "busy", "failed", "error"],
    "retry_on_voicemail": false,
    "retry_intervals_minutes": [30, 60]
  }
}

For high-volume campaigns, remember that retries consume concurrency and can overlap with batches.

Stop a queued or scheduled call

curl --request POST \
  --url "https://api.bolna.ai/call/$EXECUTION_ID/stop" \
  --header "Authorization: Bearer $BOLNA_API_KEY"

This cannot stop a call already in progress.

Script

# One-off call
python3 make-call/scripts/make_call.py \
  --agent-id "$AGENT_ID" \
  --recipient "+919876543210" \
  --user-data '{"customer_name":"Amitesh"}'

# Scheduled call (timezone-aware)
python3 make-call/scripts/schedule_call.py \
  --agent-id "$AGENT_ID" \
  --recipient "+919876543210" \
  --at "2026-05-22T15:30:00+05:30"

# Bulk one-off calls from a CSV (for ad-hoc fan-outs; use `create-batch` for proper campaigns)
python3 make-call/scripts/bulk_make_calls.py \
  --agent-id "$AGENT_ID" \
  --file recipients.csv

See also

  • migrate-call-to-workflow: move an existing /call integration onto a workflow when retries, routing on a variable, or multi-call follow-ups belong in Bolna instead of your code.
  • create-batch — proper CSV-based campaigns with monitoring, retry, and stop endpoints.
  • get-executions — fetch the result of a queued call via the returned execution_id.
  • setup-webhook — receive call updates in real time instead of polling.
  • https://raw.githubusercontent.com/bolna-ai/skills/main/references/call-statuses.md — interpreting status transitions.
  • bolna-graph-agents/scripts/inject_event.py — for graph agents, push real-time events into a live call.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/bolna-ai/skills/make-call">View make-call on skillZs</a>