# Indian carriers (/guides/indian-carriers)

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 [#pick-a-carrier]

| | Plivo | Vobiz | Twilio | Your own SIP trunk |
| --- | --- | --- | --- | --- |
| What you enter | Auth ID + auth token | SIP username, password, domain, outbound proxy, auth token | Account SID + auth token | Host, port, transport, auth (digest or IP) |
| Inbound setup | **Connect automatically** | Paste two addresses in the Vobiz console | **Connect automatically** | In your PBX or trunk |
| Simultaneous calls per number (default) | 50 | 2 | 2 | 10 |
| New calls per second (account) | 2 | 2 | 1 | — |
| Call transfer | Yes, with whisper | Yes, with whisper | Yes, with whisper | Yes, 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 [#connect-a-number]

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

<Tabs items={["Plivo","Vobiz","Twilio"]}>
<Tab value="Plivo">
1. In [console.plivo.com](https://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.
</Tab>

<Tab value="Vobiz">
1. From your Vobiz account, copy the SIP username, SIP password, SIP domain (`*.sip.vobiz.ai`) and the auth token.
2. In CallMitra, enter the number in E.164 and those values. The outbound proxy defaults to `13.233.44.61:5060`; change it only if Vobiz gives you another one.
3. Click **Test connection**. It checks that the SIP domain resolves and the proxy accepts a connection.
4. Vobiz is set up by hand: copy the answer and status addresses CallMitra shows under **Receive calls** into your Vobiz number's settings.
</Tab>

<Tab value="Twilio">
1. In [console.twilio.com](https://console.twilio.com), copy the **Account SID** (starts with `AC`) and **Auth token** from Account Info.
2. In CallMitra, enter the number in E.164, the Account SID and the auth token. Enter both: outbound calls need them.
3. Click **Test connection**.
4. Under **Receive calls**, click **Connect automatically**. CallMitra points the number's voice webhook at itself.
</Tab>
</Tabs>

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`](/api-reference/agents/testCallAgent)) to check the number end to end.

### Inbound addresses [#inbound-addresses]

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

| Carrier | Answer URL | Status / 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/incoming` | set 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 [#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`](/webhooks/events) 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`](/api-reference/calls/getCallRecording).

## Inbound calls [#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 [#limits]

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

| Limit | Default |
| --- | --- |
| Simultaneous calls per phone number | 50 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 account | 50 live calls, 2 new calls per second |
| Twilio account | 1 new call per second |
| Vobiz account | 2 new calls per second |
| Simultaneous calls per workspace | 500 |
| Simultaneous calls per campaign | `maxConcurrentCalls`, 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 [#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](/guides/india-calling) for calling windows and do-not-call rules.

## Through the API [#through-the-api]

[`GET /api/v1/phone-numbers/`](/api-reference/phone-numbers/listPhoneNumbers) 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.