Skip to content

A phone line from Rymi ​

Not open yet

Rymi-managed lines are not available to customers yet. Today every phone call runs on your own carrier account: see Telephony, pick a carrier. This page describes how managed lines will work when they open.

A phone line from Rymi gives your workspace a live local number managed by Rymi instead of connecting your own carrier account. You set up and manage the line through Rymi on WhatsApp, and Studio shows your connected number as Phone line from Rymi without exposing carrier credentials.

For the underlying /telephony/status endpoint response, see Telephony Status.

Where it is available ​

Rymi-managed lines support local numbers in:

  • India (IN, +91): requires business verification before Rymi assigns a number.
  • United States (US, +1): no document submission required.

New lines start with a limit of 2 concurrent calls and 300 minutes per day.

Setup flow ​

  1. Pick Phone line from Rymi during setup on WhatsApp, or open /numbers/rymi in Studio (also reachable via the request_phone_line MCP tool).
  2. Accept the line terms on WhatsApp or in Studio (/numbers/rymi).
  3. Complete India business verification if your business is in India (in WhatsApp or Studio /numbers/rymi).
  4. Wait for draft approval, then add credits to your prepaid balance.
  5. Once payment succeeds and verification is approved, Rymi assigns a local number, links it to your published agent, and confirms on WhatsApp.
  • Line status: GET /v1/telephony/line or MCP get_phone_line returns your number, KYC missing items, billing/release dates, and concurrency/minute limits.
  • Held edits: GET /v1/agents/:id/pending-publish or MCP get_pending_publish shows whether a published edit is still awaiting review.
  • Voice consent: POST /v1/contacts/consent or MCP record_contact_consent records express call consent by phone number with source and consent_text evidence.

India verification documents ​

Indian local numbers require Know Your Customer (KYC) approval before purchase. You provide your legal business details and upload proof files directly in the WhatsApp setup chat:

  • Required details: legal name, street address (addressLine1), city, state, postal code, and business registration number.
  • Accepted file formats: JPEG, PNG, or PDF up to 10 MB per file.

Rymi deletes uploaded files from storage 30 days after verification becomes accepted or 30 days after a line is released. When you send delete my data on WhatsApp, Rymi deletes those files and clears stored KYC details right away, then alerts the team to release any active line.

Service calls only ​

Rymi-managed lines support service calls only. Promotional sales blasts and cold marketing calls are not allowed.

  • Calling hours: India lines follow your compliance preset (Asia/Kolkata); United States lines call between 08:00 and 21:00 local recipient time.
  • Restricted topics: Agents on a Rymi line cannot ask callers for one-time passwords, bank or card details, loans, crypto transfers, debt collection payments, or election votes. Three flagged calls within 24 hours suspend the line automatically.

Who a Rymi line can call ​

Inbound calls to your Rymi number work right away once the line is active.

Outbound calls require express permission and pass every guard below before dialing:

  1. Permission to call: the recipient either submitted explicit consent on a web intake form or called your line first within the callback window (7 days in India, 30 days in the United States).
  2. Not opted out: the recipient is not on your DNC list and has not asked the agent to stop calling during a prior call.
  3. Outbound line active: outbound calling is not paused on the line.

If your number receives fewer than 15% answers or more than 40% of answered calls end within 10 seconds across 20 or more recent outbound calls, Rymi automatically pauses outbound dialing while keeping inbound calls live.

Opener disclosure and edit review ​

Every Rymi-managed agent must identify itself as an AI assistant in its opening line before going live.

When your agent is already live on a Rymi line and you publish new edits in Studio, Rymi holds the updated version for review (202 Accepted). Your previously published agent keeps handling calls with no downtime until the Rymi team approves the update.

Billing in credits ​

Rymi deducts line usage from your prepaid credit balance:

  • Monthly rental: billed once per calendar month from credits.
  • Call minutes: each completed call on the line is rounded up to whole minutes and charged to credits.

Usage ledger events under the telephony lane (managed_line surface) record these deductions; Studio usage breakdowns do not yet display them item by item.

Suspension and release ​

Rymi can pause either outbound calling or the whole line if repeated topic flags, low answer rates, or manual review indicate misuse.

If monthly rental cannot be covered by your credit balance:

  • Day 0: Rymi marks the line unpaid and keeps inbound service active while outbound calls stop.
  • Day 20: Rymi sends one WhatsApp warning letting you know the number will be released in 10 days unless you add credits.
  • Day 30: Rymi releases the phone number back to the carrier pool.