Bland AI
A RocketRide tool node that lets an AI agent make and manage AI-powered phone calls via Bland AI.
What it does
Gives an agent the ability to place outbound voice calls and work with the results. The agent can initiate a call with instructions for the Bland AI voice agent, retrieve the call's status, transcript, recording URL, duration, and summary, and run post-call AI analysis against a goal and a set of questions. Useful for automating outbound calls: scheduling, surveys, follow-ups, or any task that requires a voice interaction.
Talks to the Bland AI REST API (https://api.bland.ai/v1) over HTTPS using requests.
Calls are placed with the base model, wait_for_greeting: true, and temperature 0.7.
A Bland AI API key is required: the node refuses to start without one. Recording (default on) and language (default en) are set in the node config and apply to every call; the agent cannot override them per call.
Configuration
| Field | Type | Description |
|---|---|---|
serverName | string | Default "bland". Namespace prefix for the tools: |
apikey | string | Default empty. Bland AI API key (org_xxx). Get one at https://www.bland.ai |
voice | string | Default "June". Default AI voice for calls |
maxDuration | integer | Default 5. Maximum call length in minutes (positive integer) |
record | boolean | Default true. |
language | string | Default "en". |
The node has no lanes: it is invoked purely as an agent tool.
Available tools
Tool names are prefixed with the configured serverName (default bland).
bland.make_call
Initiate an outbound AI phone call. Returns a call_id for use with get_call and
analyze_call.
| Parameter | Required | Description |
|---|---|---|
phone_number | yes | Phone number in E.164 format (e.g. +14155551234) |
task | yes | Instructions for the AI voice agent: what to say, ask, and accomplish |
first_sentence | no | Opening sentence spoken by the agent |
voice | no | Voice ID; overrides the configured default |
max_duration | no | Max call length in minutes (positive integer); overrides the configured default |
webhook | no | URL to receive call results when the call ends, must be HTTPS, otherwise the call is rejected |
bland.get_call
Get full details for a call: status, transcript, recording URL, duration, and summary.
| Parameter | Required | Description |
|---|---|---|
call_id | yes | The call ID returned by make_call |
wait_for_completion | no | Default false. If true, polls every 10 seconds until the call completes, up to 5 minutes, recommended in pipelines to avoid manual polling. Raises a timeout error if the call has not completed in time. |
bland.analyze_call
Run AI analysis on a completed call to extract structured insights from the transcript.
| Parameter | Required | Description |
|---|---|---|
call_id | yes | The call ID to analyze |
goal | no | Overall purpose of the call, used as analysis context (default: "Analyze the phone call") |
questions | no | Array of [question, expected_type] pairs. Defaults to three string questions: the caller's mood, key information discussed, and action items. |
Authentication
Set apikey to a Bland AI API key (org_xxx), available from https://www.bland.ai.
The key is sent in the authorization header on every request. If the key is missing
the node fails at startup with Bland AI API key not configured, and any tool
invocation reports that the driver is not initialized.
Upstream docs
Schema
| Field | Type | Description | Default |
|---|---|---|---|
bland_ai.apikey | string | API Key Bland AI API key (org_xxx). Get one at https://www.bland.ai | "" |
bland_ai.language | string | Language | "en" |
bland_ai.maxDuration | integer | Max Call Duration (minutes) Maximum call length in minutes (positive integer) | 5 |
bland_ai.record | boolean | Record Calls | true |
bland_ai.serverName | string | Server name Namespace prefix for the tools: | "bland" |
bland_ai.voice | string | Default Voice Default AI voice for calls | "June" |
Dependencies
requests