Bland.ai

Automate your phone calls with AI

Category: Communication. Adds 6 actions and 2 webhooks to a care flow.

What to configure

Set these once, on the extension in Awell Studio. An action fails at run time if a required setting is missing.

Actions

Bland.ai adds these 6 actions to a care flow. Add one to a step, then fill in its inputs.

Create SMS conversation

Create an SMS conversation seeded with pathway state, without sending a message immediately. The pathway then drives outbound texts.

This action can be previewed in Studio before you publish, and retries automatically on a transient failure.

Returns:

Get call details

Retrieve detailed information, metadata and transcripts for a call.

This action can be previewed in Studio before you publish, and retries automatically on a transient failure.

Returns:

Retrieve the details of a call based on the provider call ID.

Send call

Send an AI phone call with a custom objective and actions.

This action can be previewed in Studio before you publish, and retries automatically on a transient failure.

Returns:

Send call with pathway

Send an AI phone call based on a pathway

This action can be previewed in Studio before you publish, and retries automatically on a transient failure.

Returns:

Initiates an AI phone call using a simple prompt or a conversational pathway agent built on the Bland platform. This action is asynchronous—it triggers a call request in Bland, which queues the call. Note that the action only confirms that Bland has received the request; it does not wait for the call to complete or handle any callbacks from Bland.

Awell lets you specify both the data you want to send to Bland and the structured data you’d like to receive in return. This is achieved by defining the request data for outgoing information and an analysis schema for the structured data you’ll get back.

Send SMS

Send an SMS message immediately. The agent message is optional when a pathway drives the conversation.

This action can be previewed in Studio before you publish, and retries automatically on a transient failure.

Returns:

Stop active call

End an active phone call by call ID.

This action retries automatically on a transient failure.

Returns:

Webhooks

Bland.ai can send these 2 events into Awell, where each one can start a care flow or move a patient along. Point the webhook at the URL Studio shows you when you enable it.

callCompleted

Payload:

completedBlandText

Payload:

Setup and notes

With Bland.ai you can build, test, and deploy AI phone calling agents.

Extension settings

To set up this extension, you will need to provide an API key for Bland.

Request data

Any JSON you put in here will be visible to the AI agent during the call - and can also be referenced with Prompt Variables.

For example, let’s say in the action you want to programmatically set the name of the person you’re calling. You could set request data to:

{
    "name": "John Doe",
}

Also see Bland documentation.

Analysis schema

Define a JSON schema for how you want to get information about the call - information like email addresses, names, appointment times or any other type of custom data.

For example, if you wanted to retrieve this information from the call:

{
    "email_address": "email",
    "first_name": "string",
    "last_name": "string",
    "wants_to_book_appointment": "boolean",
    "appointment_time": "YYYY-MM-DD HH:MM:SS"
}

When retrieving the call details, Bland will return data about the call in the following format:

{
  "analysis": {
    "email_address": "johndoe@gmail.com",
    "first_name": "John",
    "last_name": "Doe",
    "wants_to_book_appointment": true,
    "appointment_time": "2024-01-01 12:00:00"
  }
}

Also see Bland documentation.

Changelog

Unreleased

• Added sendSms action: send an SMS immediately via Bland POST /v1/sms/send. The agent message is optional; when omitted, the pathway configured on the agent number generates the message.
• Added createSmsConversation action: seed an SMS conversation positioned at pathway state via Bland POST /v1/sms/create without sending a message.
• Added optional timeout fields to sendSms (time_out, timeout_message, warning_time, warning_message): per-conversation overrides for Bland's silence-timeout flow.
• Added completedBlandText webhook: triggered when a Bland SMS conversation ends. Maps conversation data (status, reason, transcript, pathway variables) to data points and resolves the patient via the awell_patient_id echoed back in metadata.

Where this page comes from

The settings, actions, inputs, outputs and webhooks above are generated from the extension's own code, at @awell-health/awell-extensions v2.1.159. They match what the platform actually does rather than a description of it.

Field-level detail also appears in Awell Studio when you configure the action. Something wrong or missing? Email support@awellhealth.com.