> Documentation index for agents: https://docs.rocketride.ai/llms.txt

# tool_bland_ai

A RocketRide tool node that lets an AI agent initiate an outbound Bland AI call, inspect a call, and request analysis of a completed call.

## About Bland AI

Bland AI is the third-party phone-call service this node invokes over its HTTP API. The node uses it for outbound AI calls, call retrieval, and post-call analysis.

## What it does

Use this node when an agent must make and follow up on an AI-powered outbound phone call. It exposes tools only, with no pipeline lanes, and keeps the configured call defaults in one provider driver. Choose it over a generic HTTP tool when the agent needs the node's input checks, call defaults, or optional completion polling.

## As a tool

The server name defaults to `bland`, registering the following functions as `bland.make_call`, `bland.get_call`, and `bland.analyze_call`.

| Function | Description |
|---|---|
| `bland.make_call` | Initiates an outbound AI phone call. |
| `bland.get_call` | Retrieves the details of a call, with optional waiting for completion. |
| `bland.analyze_call` | Requests post-call analysis for a call. |

### `bland.make_call`

`phone_number` and `task` are required. The number is expected in E.164 form, while `task` gives the voice agent its instructions. Optional `first_sentence`, `voice`, and positive-integer `max_duration` override or supplement configured call defaults; optional `webhook` must begin with `https://`. The function returns the provider response, including the call ID used by later tools. Invalid input and API request failures raise errors.

### `bland.get_call`

`call_id` is required. Set optional `wait_for_completion` to true to poll every 10 seconds for up to 300 seconds; otherwise the current call details are returned immediately. The provider response supplies call status and details. A missing call ID, a polling timeout, or an API request failure raises an error.

### `bland.analyze_call`

`call_id` is required. Optional `goal` describes the analysis purpose, and optional `questions` is an array of `[question, expected_type]` pairs. Without `questions`, the client sends its built-in questions about caller mood, key information, and action items. The function returns the provider response; invalid input and request failures raise errors.

## Configuration

Supply the API key, then set defaults that should apply to every `make_call` invocation. Per-call voice and duration can override their defaults; recording and language remain node-level settings.

### Server name

This hidden field controls the tool namespace and defaults to `bland`. Change it only when multiple Bland AI nodes share an agent and their names must differ.

### Default Voice and Language

The node passes **Default Voice** to a call unless that call supplies `voice`; the default is `June`. **Language** defaults to `en` and is sent on every call. Change either only when the voice or language should be consistent for this node's calls; the call schema does not expose a per-call language override.

### Max Call Duration

This is the default positive duration in minutes for `make_call` and defaults to 5. A call's `max_duration` overrides it when supplied. Increase it for interactions that need more time, but keep it bounded for short tasks; non-positive, boolean, or non-integer configuration prevents node startup.

### Record Calls

This boolean defaults to enabled and is sent on every `make_call` request. Set it according to whether calls made through this node should request recording; unlike duration, an individual tool call cannot override it.

## Authentication

Provide a Bland AI API key in **API Key**. The node does not initialize without a non-empty key.

## Upstream docs

- [Bland AI documentation](https://docs.bland.ai)

<!-- ROCKETRIDE:GENERATED:PARAMS START -->
<!-- Generated by nodes:docs-generate. Do not edit by hand. -->

## Schema

| Field | Type | Description | Default |
|---|---|---|---|
| `bland_ai.apikey` | `string` | **API Key**<br/>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)**<br/>Maximum call length in minutes (positive integer) | `5` |
| `bland_ai.record` | `boolean` | **Record Calls** | `true` |
| `bland_ai.serverName` | `string` | **Server name**<br/>Namespace prefix for the tools: <serverName>.make_call, <serverName>.get_call, <serverName>.analyze_call | `"bland"` |
| `bland_ai.voice` | `string` | **Default Voice**<br/>Default AI voice for calls | `"June"` |

## Dependencies

- `requests`

## Source

[<svg viewBox="0 0 16 16" width="15" height="15" fill="currentColor" aria-hidden="true" style="vertical-align:-0.15em;margin-right:0.35em"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg> View source](https://github.com/rocketride-org/rocketride-server/tree/develop/nodes/src/nodes/tool_bland_ai)
<!-- ROCKETRIDE:GENERATED:PARAMS END -->
