Actions & Events

Actions & Events

The Twilio Client element exposes the element actions and events below. Add them from your Bubble workflows (Element Actions › Twilio Client, or the Twilio Client event triggers).

Element Actions

Calling

• Start Call — Places an outgoing call. Inputs: Call Number (the destination number or client identity) and Caller Number (optional) (the caller ID to present). Blocked if a call is already active. To use a per-call caller ID, your Twilio voice function must read event.appCallerId (see Getting Started).

• Hangup Call — Disconnects the active call and resets the call states.

• Mute — Toggles mute on the active call. Reflected in the Muted state.

• Send Digits — Sends DTMF tones on the active call (e.g. to navigate IVR menus). Input: Digits. Requires an active call.

Incoming calls

• Accept Incoming Call — Accepts the current incoming call. Any existing active call is disconnected first.

• Reject Incoming Call — Rejects the incoming call; sets the incoming call status to busy.

• Ignore Incoming Call — Silently ignores the incoming call.

Device management

• Register Device — Registers the device so it can receive incoming calls.

• Unregister Device — Unregisters the device; it will no longer receive incoming calls.

• Update token — Fetches a fresh access token from your token URL and updates the device. Use with the Token Expiring event to keep sessions alive.

• Reset Twilio Device — Hangs up any active calls, destroys and reinitializes the device, and clears all states.

• Destroy Device — Destroys the device instance and releases its resources.

Events

Add these as workflow event triggers (Twilio Client › <event>).

Event	Fires when
Incoming Call	An inbound call arrives. Read Incoming Call Phone Number / Incoming Call Sid to populate your UI.
Accepted Incoming Call	The user accepts an incoming call.
Call Status is Open	The active call is connected (answered). Useful to auto-start recording.
Update Call Id	The active call SID becomes available (read the Call Id state).
Token Expiring	Fires ~10 seconds before the access token expires. Trigger your token-refresh event / Update token action here.
Auto Rejected Call	An incoming call was auto-rejected because the user was busy (see the Auto Reject field).
Twilio Error	The Twilio Client raised an error. Read the Error state for details.

Server-side Action: Voice Access Token

Generates a Twilio Voice access token (JWT) from a Bubble API workflow, so the client can register without exposing your credentials. Expose it via a Bubble backend workflow and point the plugin's accessTokenURL at it (or supply the token directly via the Sub Account Token field).

Inputs

Input	Description
Account Sid	Your Twilio Account SID (AC…).
API Key	Twilio API Key SID (SK…).
API Secret	Twilio API Key secret.
Application Sid	Your TwiML Application SID.
Identity	The client identity (usually your Agent Identifier).
Allow Incoming Calls	Whether the token grants incoming calls (default yes).
Time to live (Seconds)	Token lifetime in seconds (default 3600).

Returns: Identity (text) and Token (text — the signed JWT).

Use an API Key SID/Secret (SK…), not your Auth Token, or Twilio will reject the token with error 31202. See Troubleshooting.