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
- Pick Phone line from Rymi during setup on WhatsApp, or open
/numbers/rymiin Studio (also reachable via therequest_phone_lineMCP tool). - Accept the line terms on WhatsApp or in Studio (
/numbers/rymi). - Complete India business verification if your business is in India (in WhatsApp or Studio
/numbers/rymi). - Wait for draft approval, then add credits to your prepaid balance.
- Once payment succeeds and verification is approved, Rymi assigns a local number, links it to your published agent, and confirms on WhatsApp.
Checking status, review state, and consent via API or MCP
- Line status:
GET /v1/telephony/lineor MCPget_phone_linereturns your number, KYC missing items, billing/release dates, and concurrency/minute limits. - Held edits:
GET /v1/agents/:id/pending-publishor MCPget_pending_publishshows whether a published edit is still awaiting review. - Voice consent:
POST /v1/contacts/consentor MCPrecord_contact_consentrecords express call consent by phone number withsourceandconsent_textevidence.
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 MBper 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 between08:00and21:00local 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:
- Permission to call: the recipient either submitted explicit consent on a web intake form or called your line first within the callback window (
7days in India,30days in the United States). - Not opted out: the recipient is not on your DNC list and has not asked the agent to stop calling during a prior call.
- 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
10days unless you add credits. - Day 30: Rymi releases the phone number back to the carrier pool.

