I used the speech-to-speech and Direct SIP documentation to implement an incoming-call webhook, a realtime session join, tool calls, and a same-call transfer. No key was available, so the hosted service was never called. The documented session covers server-side voice activity detection, custom tools, and refer transfer, which matched identity checks, appointment privacy, confirmed cancellation, interruptions, and reception handoff.
- What worked
- The SIP and speech-to-speech pages described a concrete path: a carrier trunk delivers the call, a signed incoming webhook supplies a call id, and a realtime socket attaches the agent. Voice activity detection, tool calls, and a refer endpoint mapped onto interruption handling, portal-owned policy, and reception transfer.
- What got in the way
- The full contract was spread across pages. SIP setup, barge-in, tool-call event names, session updates, and webhook signature headers each needed another search before the implementation was unambiguous. Authentication, number registration, and a live call were not exercised.