Node Identity
| Property | Value |
|---|
| Operations | sendSms, sendWhatsApp, makeCall, getTranscription |
| Auth Type | Account SID + Auth Token (HTTP Basic) |
| Output Ports | success, error |
Common Properties
| Property | Required | Description |
|---|
credential_id | Required | Twilio credential reference containing account_sid and auth_token. |
operation | Required | The operation to perform. |
sendSms Properties
| Property | Required | Description |
|---|
to_number | Required | Recipient phone number in E.164 format (e.g. +14155552671). Supports expressions. |
message | Required | SMS message body. Maximum 1600 characters. Long messages are split into multiple segments. Supports BizFirst expressions. |
from_number | Optional | The Twilio phone number or Messaging Service SID to send from. If omitted, uses the default from the credential configuration. |
media_url | Optional | Public URL of a media file to send as MMS (US/CA only). Supported types: image, audio, video. |
status_callback | Optional | URL to receive delivery status webhooks from Twilio. Typically a BizFirst webhook trigger endpoint. |
sendWhatsApp Properties
Same properties as sendSms but to_number must be prefixed with whatsapp:: e.g. whatsapp:+14155552671. The from_number must also use the whatsapp: prefix.
makeCall Properties
| Property | Required | Description |
|---|
to_number | Required | Phone number to call in E.164 format. |
from_number | Required | Your Twilio phone number to call from. |
twiml_url | Required | URL of the TwiML document that controls the call flow. This can be a static TwiML Bin URL or a dynamic endpoint that returns TwiML based on the call parameters. |
timeout | Optional | Number of seconds to let the call ring before cancelling. Default: 60. |
record | Optional | Whether to record the call. Default: false. When true, a Recording SID is returned for later transcription retrieval. |
machine_detection | Optional | Answering machine detection mode. Enable to detect voicemail and handle appropriately. Default: disabled. |
getTranscription Properties
| Property | Required | Description |
|---|
recording_sid | Required | The Recording SID returned by makeCall when recording was enabled. Format: RE.... |
TwiML Example
When makeCall executes, Twilio fetches the twiml_url and follows its instructions. Example TwiML for a survey call:
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Say voice="Polly.Joanna">
Hello, this is a brief customer satisfaction survey from Acme Corp.
Please press 1 for satisfied, or 2 for not satisfied.
</Say>
<Gather numDigits="1" action="https://workflow.bizfirst.io/webhook/survey-response" method="POST">
<Say>Press your selection now.</Say>
</Gather>
<Say>We did not receive your input. Goodbye.</Say>
</Response>
The TwiML action URL can point to a BizFirst Webhook Trigger, allowing DTMF input from the call to resume or branch a paused workflow — creating a voice-based HIL pattern.
