Struct TwilioCall 

pub struct TwilioCall {
    pub from_twilio: Sender<String>,
    pub to_twilio: Receiver<String>,
    /* private fields */
}

A live phone call attached to a session — the telephone counterpart of Talk::talk.

attach wires the session’s pump to a pair of text-frame channels speaking the Media Streams protocol. The caller owns the WebSocket: forward every text message Twilio delivers into from_twilio, and forward every message from to_twilio back over the socket.

// `ignore`: `ws` is the application's Twilio WebSocket (see examples/telephony).
let session = Live::builder()
    .instruction("You are the front desk. Answer the call.")
    .greeting("Greet the caller.")
    .connect_from_env().await?;
let mut call = TwilioCall::attach(&session);
loop {
    tokio::select! {
        Some(msg) = ws.recv() => call.from_twilio.send(msg.into_text()?).await?,
        Some(out) = call.to_twilio.recv() => ws.send(Message::Text(out)).await?,
        else => break,
    }
}

Fields

from_twilio: Sender<String>

Feed Twilio’s inbound WebSocket text frames here.

to_twilio: Receiver<String>

Text frames to send back to Twilio over the WebSocket.

Implementations

impl TwilioCall

pub fn attach(handle: &LiveHandle) -> TwilioCall

Attach a Twilio Media Stream to a connected session, with the default CallOptions.

Audio starts flowing once Twilio’s start frame arrives (outbound frames need its stream SID; audio generated before it is dropped — there is no call to play it into yet). Stream metadata and DTMF digits are written into session state under the telephony: keys.

pub fn attach_with(handle: &LiveHandle, options: CallOptions) -> TwilioCall

Attach a Twilio Media Stream to a connected session.

Beyond attach:

• the caller’s audio passes through a KeypadGuard, so keypad tones never reach the model and a masked keypad silences the caller;
• the agent’s audio goes out in 20 ms frames, as the network expects, with the last partial frame padded once the model pauses;
• on barge-in, KEY_UNPLAYED_MS records how much queued agent audio the caller never heard;
• with CallOptions::recorder, the call is recorded in stereo as heard.

pub async fn join(self)

Wait until the call ends (stream stopped, session closed, or the WebSocket side dropped the channels).

pub fn abort(&self)

Tear the bridge down immediately.