Call Operations

Make calls, handle transfers, and manage active call sessions from the CLI.

Control your dialer operations directly from the terminal.

List Calls

View recent and active calls:

consuelo calls list

Filter by status:

consuelo calls list --status active
consuelo calls list --status completed

Limit results:

consuelo calls list --limit 20

Get Call Details

Retrieve details for a specific call:

consuelo calls get CA1234567890abcdef

Returns call SID, status, participants, duration, and metadata.

Make a Call

Start an outbound call to a phone number or contact:

Call a Phone Number

consuelo calls start [phone]

Call a Contact

consuelo calls start contact_abc123

The CLI looks up the contact’s phone number automatically.

Specify Caller ID

Set the outbound caller ID:

consuelo calls start [phone] --caller-id [phone]

Use Local Presence

Auto-select a local area code number based on the recipient’s area code:

consuelo calls start [phone] --local-presence

Local presence selects a caller ID with the same area code as the recipient, or the closest available number if no exact match exists.

Local presence requires multiple phone numbers provisioned in your Twilio account. See Use Local Presence for setup.

End a Call

Terminate an active call:

consuelo calls end CA1234567890abcdef

Transfer a Call

Transfer an active call to another number or contact.

Cold Transfer (Blind)

Transfer immediately without consultation:

consuelo calls transfer CA1234567890abcdef --to [phone]

Warm Transfer

Consult with the transfer target before connecting:

consuelo calls transfer CA1234567890abcdef --to [phone] --type warm

Warm transfer flow:

1. The customer is placed on hold
2. The transfer target is called
3. You consult with the target
4. You can complete the transfer or cancel

Transfer Types

Type	Description
blind (default)	Immediate transfer, no consultation
warm	Consult with target before connecting

Transfers require the call to be in a conference. The CLI uses Twilio conferences for all calls, enabling seamless transfer operations.

Call Status Values

Status	Description
queued	Call is queued to start
ringing	Phone is ringing
in-progress	Call is active
completed	Call ended normally
failed	Call failed to connect
busy	Recipient line was busy
no-answer	No answer after timeout
canceled	Call was canceled before answer

Global Flags

These flags work with all call commands:

Flag	Description
--json	Output as JSON
--quiet	Suppress output
--workspace <name>	Use specific workspace

Next Steps

• Use Local Presence — Configure local area code calling
• Queue Management — Dial contacts in parallel
• Analytics & History — Review call history