Voice Agent Plans

Overview

A voice agent plan (a tier) is a priced product: you choose the plan and a voice, and the platform chooses the speech recognition, the language model and the voice model. The whole AI layer of the call bills at one flat rate a minute.

The alternative is a custom stack: you set stt_model, voice_model and tts_model yourself, and each one bills at its own published rate, by the second, with no minimum.

1 credit = ₹1 ≈ US$0.0104 (US$1 = ₹96). Always read the live list from GET /api/v1/bots/config-schema (the voice_tiers array) rather than hard-coding it.

How a plan call is billed

• One flat rate a minute for the call's duration, charged once when the call ends.
• 30-second minimum per call. A 10-second call bills 30 seconds; a 2-minute call on Standard bills ₹8.
• A call that never connects costs nothing. A zero-length call does not reach the minimum.
• No per-component charges. A plan call is not also billed per speech-recognition second, per token or per character.
• Phone carriage is separate. A rented number, or Meta's fee on a business-initiated WhatsApp call, is billed the same way as on a custom stack.
• The call ends when your credits run out. The running cost is checked against your balance during the call, and the call is stopped once your balance can no longer cover the minutes already spoken.

Put an agent on a plan

Set voice_tier (and optionally voice and voice_tier_speech_input) with a config patch. Requires bots:write.

curl -X PATCH https://api.callmissed.com/api/v1/bots/b1f2c3d4-5678-90ab-cdef-1234567890ab/config \
  -H "Authorization: Bearer cm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "values": { "voice_tier": "t3", "voice_tier_speech_input": "english", "language": "en" } }'

On a plan, the agent's own stt_model, voice_model, tts_model and tts_provider are ignored, not merged — a half-overridden plan would no longer match its price. voice and language stay yours. POST /api/v1/bots/validate-config reports a finding when a config sets both.

To move an agent back to a custom stack, remove the key:

curl -X PATCH https://api.callmissed.com/api/v1/bots/b1f2c3d4-5678-90ab-cdef-1234567890ab/config \
  -H "Authorization: Bearer cm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "unset": ["voice_tier", "voice_tier_speech_input"] }'

Languages

Standard and Expressive listen in 22 Indian languages plus English, including code-mixed speech such as Hinglish.

Best latency hears ten languages: English, Spanish, French, German, Hindi, Russian, Portuguese, Japanese, Italian and Dutch. For any other language, use Standard or Expressive.

Multilingual (auto-detect)

Set "language": "multi" to make an agent multilingual on any plan. The call opens in English. After each thing the caller says, the agent detects the language and replies in the language the caller last spoke, switching mid-call if the caller switches. It can switch to any language in the plan's languages list. If the caller speaks a language the plan cannot speak, the agent keeps replying in the current language.

curl -X PATCH https://api.callmissed.com/api/v1/bots/b1f2c3d4-5678-90ab-cdef-1234567890ab/config \
  -H "Authorization: Bearer cm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "values": { "voice_tier": "t1", "language": "multi" } }'

On Best latency, multilingual needs the multilingual listening option. The english option hears English only, so the agent stays in English.

Custom (non-plan) agents accept "language": "multi" too. POST /api/v1/bots/validate-config warns about any chosen speech-recognition or voice model that cannot follow the caller's language. GET /api/v1/bots/config-schema lists the models that can, under multilingual.stt and multilingual.tts.

Read the plans

GET /api/v1/bots/config-schema returns the plans beside the per-model keys. Requires bots:read.

{
  "voice_tiers": [
    {
      "id": "t1",
      "label": "Standard",
      "blurb": "Natural Indian-language voices at the lowest price.",
      "price_credits_per_minute": 4.0,
      "speech_inputs": [{ "id": "multilingual", "label": "Multilingual" }],
      "voices": ["…"],
      "languages": ["en-IN", "hi-IN", "…"],
      "multilingual": true,
      "billing": "flat",
      "minimum_seconds": 30.0
    }
  ]
}

Where to see what a call cost

GET /v1/voice/sessions/{id}/cost returns the cost of a finished session, and your usage history lists plan calls as one line per call.