Skip to content

Telephony Integration

Rymi provides a unified gateway that supports Plivo, Twilio, and Vonage through a simplified routing structure. This allows you to bring your own carrier (BYOC) and connect any number to your Rymi Voice Agents.

BYOC Billing Model

Self-serve PSTN usage is split into two bills:

  • Rymi platform minutes: Charged at the selected Operator, Specialist, or Executive agent-role rate.
  • Carrier pass-through: Your connected Plivo, Twilio, or Vonage account bills PSTN minutes, number rental, taxes, and optional carrier add-ons directly.

Rymi does not sell or purchase phone numbers directly in self-serve. Provision numbers in your connected provider account, then use Rymi to attach registered BYOC numbers to agents. Enterprise plans can bundle telecom under a custom agreement.

For cost planning, add the carrier's per-minute rate to the Rymi agent-role rate for PSTN legs. As a U.S. local outbound example, published April 2026 rates are $0.0115/min on Plivo and $0.014/min on Twilio before taxes and optional add-ons. WebRTC-only calls do not add PSTN carrier minutes.

Unified Route Structure (For BYOC)

Instead of carrier-specific endpoints, use the following patterns:

ProviderInbound Hook URL (Answer URL)WebSocket URL
Plivohttps://gateway.rymi.live/inbound/plivo?agent_id=IDwss://gateway.rymi.live/ws/plivo/ID
Twiliohttps://gateway.rymi.live/inbound/twilio?agent_id=IDwss://gateway.rymi.live/ws/twilio/ID
Vonagehttps://gateway.rymi.live/inbound/vonage?agent_id=IDwss://gateway.rymi.live/ws/vonage/ID

Carrier Setup

Plivo

Set your number's Answer URL to the inbound hook URL above. Or use TwiML XML:

xml
<Response>
  <Connect>
    <Stream url="wss://gateway.rymi.live/ws/plivo/AGENT_ID" />
  </Connect>
</Response>

Twilio

Set your number's A call comes in webhook to the inbound hook URL above. Rymi will automatically return the required TwiML <Connect><Stream> response.

Vonage

Set your application's Answer URL to the inbound hook URL above. Rymi will return the required NCCO (JSON) to open a high-fidelity 16kHz WebSocket.

Audio Specifications

Rymi automatically optimizes the stream for each carrier:

  • Plivo/Twilio: 8kHz μ-law (G.711)
  • Vonage: 16kHz L16 (Linear PCM)
  • WebRTC: 16kHz - 48kHz (Adaptive)