Skip to Content
CallMitraDocs

Indian carriers

Connect phone numbers from Plivo, Vobiz, Twilio or your own SIP trunk, and see how inbound and outbound calls use them.

CallMitra does not sell phone numbers. You bring numbers from a carrier account you own, connect them once in the console, and every agent, campaign and API call can use them.

Pick a carrier

PlivoVobizTwilioYour own SIP trunk
What you enterAuth ID + auth tokenSIP username, password, domain, outbound proxy, auth tokenAccount SID + auth tokenHost, port, transport, auth (digest or IP)
Inbound setupConnect automaticallyPaste two addresses in the Vobiz consoleConnect automaticallyIn your PBX or trunk
Simultaneous calls per number (default)502210
New calls per second (account)221—
Call transferYes, with whisperYes, with whisperYes, with whisperYes, no whisper

Your own SIP trunk (Tata, Airtel, Jio, Exotel, Telnyx, DIDWW, FreePBX, 3CX and others) is available only when your CallMitra server has the SIP gateway turned on. Otherwise the console answers SIP trunk calling is not enabled on this server yet.

Connect a number

In the console, open Calls → Phone numbers → Add number, choose the carrier, and fill in:

  1. In console.plivo.com, copy the Auth ID (starts with MA or SA) and Auth token from the account overview.
  2. In CallMitra, enter the number in E.164 (+91…), the Auth ID and the auth token.
  3. Click Test connection.
  4. Under Receive calls, click Connect automatically. CallMitra creates a Plivo application named call-mitra-inbound and attaches your number to it.

Trial Plivo accounts can only call and receive calls from numbers you have verified in Plivo.

Carrier secrets are stored encrypted and never returned. The API shows only whether each one is set. Then call yourself from the agent page (Call my phone, or POST /api/v1/agents/{agent_id}/test-call) to check the number end to end.

Inbound addresses

If you set up a carrier by hand, these are the addresses on your CallMitra API host:

CarrierAnswer URLStatus / hangup URL
Plivo/sip-assistant/voice/plivo/incoming/api/webhooks/call-events?vp_provider=plivo
Vobiz/sip-assistant/voice/vobiz/incoming/api/webhooks/call-events?vp_provider=vobiz
Twilio/sip-assistant/voice/incomingset by CallMitra

CallMitra checks the carrier's signature on these requests and answers 403 when it does not match, so the auth token you entered must be the one for the account that owns the number.

Outbound calls

Which number calls out. CallMitra uses the first of:

  1. the phone number you pass on the request (for example phoneNumberId);
  2. the campaign's phone number;
  3. the number assigned to the agent.

When a campaign or agent has a pool of numbers, each call goes out on the least busy one.

Ringing and results. An unanswered call rings for about 40 seconds. Every call ends as completed, busy, no_answer or failed, and the call.completed webhook carries the result. Voicemail is detected after the call, from the conversation, and shows up in the call analysis.

Recording. When the agent's call recording setting is on, CallMitra records the call itself (stereo MP3). Fetch it with GET /api/v1/calls/{call_id}/recording.

Inbound calls

When someone calls one of your numbers, CallMitra picks the agent in this order:

  1. the caller rules of the number's inbound campaign;
  2. the agent the caller last spoke to, within 30 days, when the line is set to call back to the last agent;
  3. the number's default inbound campaign;
  4. the agent the number is assigned to.

If none applies, the caller hears that the number is not taking calls right now. An inbound line can also have operating hours (with an after-hours message) and a limit on simultaneous inbound calls (10 by default).

Limits

Calls are refused with a 409 when a limit is reached and resume as soon as a call ends:

LimitDefault
Simultaneous calls per phone number50 for Plivo, 2 for the others, at most 200. The console fills in 50 when you add a number; change it under the number's settings.
Plivo account50 live calls, 2 new calls per second
Twilio account1 new call per second
Vobiz account2 new calls per second
Simultaneous calls per workspace500
Simultaneous calls per campaignmaxConcurrentCalls, 1–500

Set the per-number limit to what your carrier plan allows. A number above its carrier's real channel count produces failed calls rather than a CallMitra refusal.

Caller ID series

Numbers in the 140 series are for promotional calls and the 1600 series for service and transactional calls. CallMitra warns when a campaign starts on a number outside these series but does not block it; the right series for your traffic is between you and your carrier. See Calling in India for calling windows and do-not-call rules.

Through the API

GET /api/v1/phone-numbers/ lists your connected numbers and their IDs, which you pass as phoneNumberId on campaigns and calls. Adding, editing and connecting numbers is done in the console for now.

On this page