Telephony

Hyponema includes a vendor-neutral telephony control plane with Telnyx and Twilio support.

Telephony calls use the same voice runtime as browser sessions, but the media transport is carrier-specific.

Supported carriers

Carrier	Status
Telnyx	Control plane and media plane supported.
Twilio	Control plane and media plane supported.
SIP, Vonage, RingCentral, WhatsApp	Post-MVP.

Call flow

1. A carrier webhook reports call state.
2. Hyponema validates the carrier signature.
3. The event is normalized into the vendor-neutral control plane.
4. A carrier media WebSocket connects to Hyponema.
5. Hyponema converts carrier audio into the voice runtime format.
6. The voice session runs through the same persona, memory, tools, and observability layers.

Media endpoints

Carrier media connects to:

• wss://api.hyponema.ai/v1/telephony/telnyx/media/{conversation_id}
• wss://api.hyponema.ai/v1/telephony/twilio/media/{conversation_id}

Operator checklist

• Configure carrier credentials.
• Verify webhook signatures in the carrier dashboard.
• Attach phone numbers to the correct agent.
• Test inbound and outbound calls separately.
• Review the call trace for audio, tool, guardrail, and provider failures.