.do
ApiCommunication

TwilioCall

A voice call session managed by Twilio's programmable voice API, supporting inbound/outbound calls, IVR, call recording, and advanced call control.

TwilioCall

A voice call session managed by Twilio's programmable voice API, supporting inbound/outbound calls, IVR, call recording, and advanced call control.

Properties

  • id (string): Unique identifier for the call (SID).
  • accountSid (string): Twilio account identifier.
  • from ([[PhoneNumber]]): Caller's phone number.
  • to ([[PhoneNumber]]): Recipient's phone number.
  • fromFormatted (string): Formatted caller phone number.
  • toFormatted (string): Formatted recipient phone number.
  • parentCallSid (string): Parent call SID if this is a child call.
  • phoneNumberSid (string): SID of the Twilio phone number used.
  • status (string): Call status (queued, ringing, in-progress, completed, busy, failed, no-answer, canceled).
  • startTime (number): Call start time (Unix timestamp).
  • endTime (number): Call end time (Unix timestamp).
  • duration (number): Call duration in seconds.
  • price (number): Cost of call in account currency.
  • priceUnit (string): Currency code for price (USD, EUR, etc).
  • direction (string): Call direction (inbound, outbound-api, outbound-dial).
  • answeredBy (string): Who answered (human, machine, fax, unknown).
  • annotation (string): Custom annotation for the call.
  • callerName (string): Caller ID name if available.
  • queueTime (number): Time spent in queue (milliseconds).
  • forwardedFrom ([[PhoneNumber]]): Original caller if call was forwarded.
  • groupSid (string): Group SID if call is part of group.
  • trunkSid (string): SIP trunk SID if using SIP trunking.
  • uri (string): API URI for this call resource.
  • subresourceUris (object): URIs for recordings, notifications, and other subresources.
  • dateCreated (number): Timestamp when call was created (Unix timestamp).
  • dateUpdated (number): Timestamp when call was last updated (Unix timestamp).
  • metadata (object): Set of key-value pairs for storing additional information.

Actions

create

Initiate an outbound call.

Input: [[TwilioCall]]
Output: [[TwilioCall]]

retrieve

Get call details by SID.

Input: string
Output: [[TwilioCall]]

update

Modify an in-progress call.

Input: [[TwilioCall]]
Output: [[TwilioCall]]

delete

Delete call record from account.

Input: string
Output: [[TwilioCall]]

list

List calls with optional filters.

Input: [[CallFilter]]
Output: [[TwilioCall]][]

redirect

Redirect call to new TwiML URL.

Input: [[CallRedirect]]
Output: [[TwilioCall]]

hangup

Terminate an in-progress call.

Input: string
Output: [[TwilioCall]]

hold

Place call on hold.

Input: string
Output: [[TwilioCall]]

unhold

Resume call from hold.

Input: string
Output: [[TwilioCall]]

mute

Mute call audio.

Input: string
Output: [[TwilioCall]]

unmute

Unmute call audio.

Input: string
Output: [[TwilioCall]]

record

Start call recording.

Input: [[RecordingConfig]]
Output: [[Recording]]

stopRecording

Stop active recording.

Input: string
Output: [[TwilioCall]]

Events

  • created: Triggered when a new call is created.
  • queued: Triggered when call enters queue.
  • ringing: Triggered when call is ringing.
  • answered: Triggered when call is answered.
  • in-progress: Triggered when call connects.
  • completed: Triggered when call ends normally.
  • failed: Triggered when call fails.
  • busy: Triggered when recipient is busy.
  • no-answer: Triggered when call is not answered.
  • canceled: Triggered when call is canceled.
  • Recording.started: Triggered when recording begins.
  • Recording.completed: Triggered when recording is ready.