Skip to main content

Twilio

Type ID: twilio  ·  Kind: Action  ·  Ports: 1 in, 1 out

Places an outbound voice call, speaks a list of prompts, then listens for a keypad digit as acknowledgement. Pauses the workflow until Twilio reports the outcome.

Credentials​

twilio (Account SID, Auth Token)

Resources & operations​

  • Call (call)
    • Make Call (makeCall) - Place an outbound voice call

Properties​

PropertyKeyTypeRequiredDefaultPossible valuesApplies when
ResourceresourceoptionsYescallCall (call)-
OperationoperationoptionsYesmakeCallMake Call (makeCall)resource = call
FromfromNumberstringYes''Twilio caller phone numberresource = call, operation = makeCall
TotoNumberstringYes''Recipient phone number to callresource = call, operation = makeCall
Say ListsayListarrayYes[]Prompts spoken in order once the call is answered, before listening for a keypad responseresource = call, operation = makeCall
No Response Say ListnoResponseSayListarrayNo[]Prompts spoken if the call is not answered or no digit is enteredresource = call, operation = makeCall
Positive Response Say ListpositiveResponseSayListarrayNo[]Prompts spoken when the pressed digit matches Positive Responseresource = call, operation = makeCall
Negative Response Say ListnegativeResponseSayListarrayNo[]Prompts spoken when a digit is pressed but does not match Positive Responseresource = call, operation = makeCall
Positive Response DigitpositiveResponsenumberYes1The digit that counts as acknowledgement (e.g. 1 for "Press 1 to ACK")resource = call, operation = makeCall
Speech RatespeechRatestringNo100%SSML prosody rate for spoken prompts (e.g. 85% for slower). A slower rate lengthens the call, which increases your Twilio bill.resource = call, operation = makeCall
Record CallrecordbooleanNofalseWhether Twilio should record the call. Recording increases your Twilio bill.resource = call, operation = makeCall

Notes​

  • The node pauses after placing the call and resumes when Twilio calls back (digit pressed or call completed).
  • Output: { ..., callSid, digits, ackResult, callStatus }, where ackResult is positive, negative, or no_response.
  • Say List needs at least one prompt.
  • Requires the PLATFORM_BACKEND_URL environment variable for Twilio's callback.