docs

Phone Call Notification Node

The Phone Call Notification node makes automated phone calls via Twilio with text-to-speech. Use it to deliver urgent trading alerts, order confirmations, and status updates directly to a phone number.

Phone Call Alert
No call script

Configuration

General

Give this node a custom name to identify it in your workflow

Continue workflow if this node fails

Twilio Credentials

Add your Twilio Account SID, Auth Token, and phone number

Get your credentials from the Twilio Console

Call Script

Configure the recipient and text-to-speech script

Recipient phone number in E.164 format (e.g., +15551234567)

Text read aloud to the recipient. Use {edgeLabel.field} for dynamic values

Advanced Options

Optional configuration overrides

Override the from number configured in your Twilio credential. E.164 format.

Configuration

FieldDescription
Twilio CredentialYour Twilio Account SID and Auth Token, stored as an encrypted credential. Get them from the Twilio Console ↗.
To NumberRecipient phone number in E.164 format (e.g., +15551234567). Supports the f(x) toggle for dynamic values.
Call ScriptThe text-to-speech script read aloud to the recipient. Supports {edgeLabel.field} interpolation for dynamic data. Maximum 4,096 characters (auto-truncated if longer).
From Number OverrideOptional. Overrides the from number set in your Twilio credential. E.164 format. Supports the f(x) toggle for dynamic values.
Phone numbers must be in E.164 format: a + followed by the country code and number with no spaces or dashes. Example: +15551234567, not +1 555 123 4567.

Dynamic Fields

The To Number and From Number Override fields support the f(x) toggle. Click the f(x) button next to a field to switch from a static value to an expression that resolves at runtime using the output of a connected upstream node:

{my_function.phoneNumber}

This lets you build workflows where the recipient is determined dynamically — for example, looking up a phone number from a database or passing it from an earlier Function node.

Twilio Setup

Before you can make phone calls, you need a Twilio account and phone number.

Step 1: Create a Twilio Account

  1. Sign up at twilio.com ↗ (free trial available).
  2. From the Console Dashboard, copy your Account SID and Auth Token.

Step 2: Get a Twilio Phone Number

  1. In the Twilio Console, go to Phone Numbers > Manage > Buy a Number.
  2. Search for a number with Voice capability enabled.
  3. Purchase the number and copy it (e.g., +15551234567).
Make sure the number has Voice capability, not just SMS. You can check this in Phone Numbers > Active Numbers.

Step 3: Save Credentials in NickAI

  1. Go to Credentials in NickAI (or use the credential selector in the Phone Call node).
  2. Click Add Credential and select Twilio SMS (same credential type used for both SMS and phone calls).
  3. Enter your Account SID, Auth Token, and optionally your From Phone Number.
  4. Click Save. All values are encrypted at rest.
The From Phone Number in the credential is optional. You can set it per-node using the From Number Override field instead.

Step 4: Verify Recipients (Trial Accounts Only)

Twilio trial accounts can only call verified phone numbers. Add recipient numbers in Twilio Console > Phone Numbers > Manage > Verified Caller IDs before testing.

Template Interpolation

Use curly braces to inject live data from upstream nodes into the call script and phone number fields. The text is read aloud to the recipient using text-to-speech.

Trading Alert Example

Attention: BTC USD Alert.

The current price is {price_data.data.prices[0].current}.
24 hour change: {price_data.data.prices[0].changePercent24h} percent.
Signal: {llm.output}.

Order Confirmation Example

Order executed successfully.

Action: {exchange.side}.
Symbol: {exchange.symbol}.
Quantity: {exchange.quantity}.
Price: {exchange.price}.
The call script editor provides autocomplete as you type inside {}. It shows all available edge labels and their fields from connected upstream nodes.
Since the script is read aloud, write in natural speech patterns. Use periods for pauses. Spell out abbreviations if needed (e.g., "B T C" instead of "BTC" for clearer pronunciation).

Workflow Example

A common pattern is to monitor prices, check a condition, and make a phone call alert:

BTC Price
BINANCE:BTCUSDT
Analyze Market
Claude Sonnet 4.6
Strong Signal?
confidence > 80
Phone Call Alert
Twilio

In this workflow:

  1. Price Data fetches live BTC/USD market data.
  2. LLM analyzes the price, volume, and indicators to produce a signal.
  3. Conditional checks if confidence exceeds 80%.
  4. Phone Call Notification calls you with the alert -- only when the signal is strong.

Output

After execution, the node produces the following data that downstream nodes can reference:

PathDescription
{call.success}true if the call was initiated, false if it failed.
{call.message}A status string -- "Phone call initiated successfully" on success, or an error description on failure.
{call.callSid}The Twilio call SID (only present on success). Useful for tracking call status.
Replace call with your node's edge label. If the edge connecting this node to the next is labeled alert, use {alert.success}.
The call is initiated when the node executes, meaning Twilio has accepted the request. The actual call may still be ringing or in progress. Use the callSid to check status via the Twilio API if needed.

Common Errors

ErrorCauseFix
Invalid phone number formatNumber has spaces, dashes, or missing +Use E.164 format: +15551234567
Authentication failedWrong Account SID or Auth TokenRe-check credentials in Twilio Console ↗
Permission denied for regionTwilio account can't call the recipient's countryEnable the country in Voice > Settings > Geo permissions
Trial account restrictionCalling an unverified number on a trial accountVerify the number in Phone Numbers > Verified Caller IDs
From number not voice-capableThe Twilio number doesn't support voice callsPurchase a number with Voice capability in Phone Numbers > Buy a Number

Next Steps