Bland AI

View as Markdown

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

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: .make_call, .get_call, .analyze_call	"bland"
bland_ai.voice	string	Default Voice Default AI voice for calls	"June"

Dependencies

• requests