Triggers

Twilio Voice Trigger

Trigger workflow when phone calls are received via Twilio Voice

Trigger workflow when phone calls are received via Twilio Voice

This is a webhook-based trigger. Configure the external service to send events to the workflow webhook URL.

Use as a Tool

See workflow actions, operations, and tool inputs for Twilio Voice.

Setup Instructions

  1. Enter a TwiML Response above - this tells Twilio what to do when a call comes in (e.g., play a message, record, gather input). Note: Use square brackets [Tag] instead of angle brackets for TwiML tags

  2. Example TwiML for recording with transcription: [Response][Say]Please leave a message.[/Say][Record transcribe="true" maxLength="120"/][/Response]

  3. Go to your Twilio Console Phone Numbers page at https://console.twilio.com/us1/develop/phone-numbers/manage/incoming

  4. Select the phone number you want to use for incoming calls.

  5. Scroll down to the "Voice Configuration" section.

  6. In the "A CALL COMES IN" field, select "Webhook" and paste the Webhook URL (from above).

  7. Ensure the HTTP method is set to POST.

  8. Click "Save configuration".

  9. How it works: When a call comes in, Twilio receives your TwiML response immediately and executes those instructions. Your workflow runs in the background with access to caller information, call status, and any recorded/transcribed data.

Configuration

Twilio Account SID*
ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Your Twilio Account SID from the Twilio Console
Auth Token*
••••••••
Your Twilio Auth Token for webhook signature verification
TwiML Response
[Response][Say]Please hold.[/Say][/Response]
TwiML instructions to return immediately to Twilio. Use square brackets instead of angle brackets (e.g., [Response] instead of <Response>). This controls what happens when the call comes in (e.g., play a message, record, gather input). Your workflow will execute in the background.

Output Schema

Event Payload
callSidstringUnique identifier for this call
accountSidstringTwilio Account SID
fromstringCaller's phone number (E.164 format)
tostringRecipient phone number (your Twilio number)
callStatusstringStatus of the call (queued, ringing, in-progress, completed, etc.)
directionstringCall direction: inbound or outbound
apiVersionstringTwilio API version
callerNamestringCaller ID name if available
forwardedFromstringPhone number that forwarded this call
digitsstringDTMF digits entered by caller (from <Gather>)
speechResultstringSpeech recognition result (if using <Gather> with speech)
recordingUrlstringURL of call recording if available
recordingSidstringRecording SID if available
calledstringPhone number that was called (same as "to")
callerstringPhone number of the caller (same as "from")
toCitystringCity of the called number
toStatestringState/province of the called number
toZipstringZip/postal code of the called number
toCountrystringCountry of the called number
fromCitystringCity of the caller
fromStatestringState/province of the caller
fromZipstringZip/postal code of the caller
fromCountrystringCountry of the caller
calledCitystringCity of the called number (same as toCity)
calledStatestringState of the called number (same as toState)
calledZipstringZip code of the called number (same as toZip)
calledCountrystringCountry of the called number (same as toCountry)
callerCitystringCity of the caller (same as fromCity)
callerStatestringState of the caller (same as fromState)
callerZipstringZip code of the caller (same as fromZip)
callerCountrystringCountry of the caller (same as fromCountry)
callTokenstringTwilio call token for authentication
rawstringComplete raw webhook payload from Twilio as JSON string
Telegram TriggerWebflow Trigger

On this page

Setup Instructions
Configuration
Output Schema