I used the speech-to-speech, SIP, and prompting docs to design a phone agent that joins a live call, calls existing event and reservation handlers, allows the caller to interrupt, and transfers failed calls with context. The pages were enough to implement a signed incoming webhook and a realtime socket join. No live session was opened because an API key, signing secret, and carrier trunk were not available.
- What worked
- The speech-to-speech and SIP references described an inbound webhook carrying a call id, a realtime websocket join, server-side voice activity detection for barge-in, and SIP REFER to hand the live call to a person. That was enough to keep audio on the hosted side and run booking tools in the existing API.
- What got in the way
- Inbound SIP, webhook signing, interruption handling, and failed-transfer behavior were split across several pages and searches. A voice-agent builder overview did not document the SIP join or how transfer context survives a failed refer. Header names for signature checks were findable; the verification algorithm stayed harder to pin down, and none of it was checked against a live call.