MCube Setup

This guide walks you through connecting your MCube account to Vocobase for outbound and inbound calling. MCube is a popular telephony provider in India with support for local and toll-free numbers.

Prerequisites

An MCube account with API access enabled
Your MCube JWT authentication token
Your MCube executive number
Every inbound DID in E.164 format
An approved Vocobase account with an API key

Get your MCube credentials

Get your JWT token

MCube uses JWT tokens for API authentication. You can find your token in the MCube dashboard under API Settings, or request it from MCube support.

Keep your JWT token secret. It provides full access to your MCube calling capabilities.

Get your executive number

The executive number is the agent/extension number assigned to your MCube account. It acts as the caller ID for outbound calls.Format: 4-15 digits, with an optional + prefix (e.g., +919876543210).

Configure MCube in Vocobase

MCube is a first-class BYOP provider on the telephony connections model. Create a named connection (recommended — every connection gets a stable connection_id you can pass to POST /calls/start):

curl -X POST https://api.vocobase.com/api/v2/telephony/connections \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "mcube",
    "name": "Production MCube",
    "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "exe_number": "9876543232"
  }'

The exenumber is stored as the connection’s default phone number (national format is fine — no + required) and is used as the line your outbound calls are placed from.

The executive number identifies the MCube account; it is not the inbound DID list. Each dialed DID must be added separately before inbound calls can route to an agent.

Alternatively, the provider config shortcut below remains supported and creates or updates your default MCube connection:

curl -X PUT https://api.vocobase.com/api/v2/config/telephony/mcube \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "exe_number": "+919876543210"
  }'

const response = await fetch(
  "https://api.vocobase.com/api/v2/config/telephony/mcube",
  {
    method: "PUT",
    headers: {
      "Authorization": "Bearer rg_live_abc123def456ghi789jkl012",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      jwt_token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
      exe_number: "+919876543210"
    })
  }
);
const result = await response.json();
console.log(result);

import requests

response = requests.put(
    "https://api.vocobase.com/api/v2/config/telephony/mcube",
    headers={
        "Authorization": "Bearer rg_live_abc123def456ghi789jkl012",
        "Content-Type": "application/json"
    },
    json={
        "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "exe_number": "+919876543210"
    }
)
print(response.json())

A successful response confirms your credentials were saved:

{
  "success": true,
  "data": {
    "exe_number": "+919876543210",
    "message": "MCube credentials updated successfully."
  }
}

Your JWT token is encrypted at rest and never returned in API responses.

To rotate credentials later, send the same request again with the new values. Every field is required on each call — the endpoint replaces the stored credential set rather than patching it.

Add and assign inbound DIDs

MCube does not expose a DID inventory endpoint that Vocobase pulls. Add the DIDs manually to the selected connection with POST /api/v2/phone-numbers/sync. Use E.164 format even if MCube sends the webhook DID without +91; Vocobase handles national-format suffix matching during inbound routing.

curl -X POST https://api.vocobase.com/api/v2/phone-numbers/sync \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "MCUBE",
    "connection_id": "9b7f1c44-c87f-4f0c-9124-3c802a9c1a20",
    "numbers": ["+918071844607", "+918071844608"]
  }'

The request is idempotent. DIDs already present on this connection and duplicate values in the same request are skipped:

{
  "success": true,
  "data": {
    "added": 1,
    "skipped": 1,
    "updated": 0,
    "removed": 0
  }
}

List the connection’s numbers to obtain each DID row ID:

curl -X GET "https://api.vocobase.com/api/v2/phone-numbers?provider=MCUBE&connection_id=9b7f1c44-c87f-4f0c-9124-3c802a9c1a20" \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012"

Assign the DID to an agent and enable inbound routing:

curl -X PUT https://api.vocobase.com/api/v2/phone-numbers/f1a2c3d4-1111-2222-3333-444455556666 \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "inbound_enabled": true,
    "friendly_name": "MCube Support DID"
  }'

A DID may exist on more than one connection for outbound use, but only one active row for that DID can have inbound_enabled: true. This keeps inbound routing deterministic.

To remove a manually added DID, use its row ID. The default exeNumber cannot be deleted through this endpoint.

curl -X DELETE https://api.vocobase.com/api/v2/phone-numbers/f1a2c3d4-1111-2222-3333-444455556666 \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012"

Make a test call

Start an outbound call with "provider": "mcube".

curl -X POST https://api.vocobase.com/api/v2/calls/start \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "to_number": "+919876543210",
    "provider": "mcube"
  }'

If you omit the provider field in the call request, MCube is used by default.

If your account has more than one active MCube connection, also pass connection_id — omitting it returns CONNECTION_AMBIGUOUS. See Bring Your Own Phone for the full request and response shape.

Troubleshooting

”Invalid MCube credentials” error

Verify your JWT token has not expired — MCube tokens may have an expiration date
Confirm the executive number is correctly formatted (4-15 digits, optional + prefix)
Contact MCube support to verify your API access is active

Calls not connecting

Ensure the destination number is reachable from your MCube account
Check that your MCube account has sufficient balance
Verify that API-initiated calls are enabled on your MCube plan

Inbound call returns `unknown_number`

Confirm the dialed DID was added to the same MCube connection_id selected by the webhook’s exeNumber
Store the DID in E.164 format, for example +918071844607
Confirm the DID row has an owned agent_id and inbound_enabled: true
Use GET /api/v2/phone-numbers?provider=MCUBE&connection_id=... to inspect the current mapping

JWT token expired

MCube JWT tokens may have an expiration date. If calls start failing after a period of time, generate a new JWT token from MCube and update your configuration:

curl -X PUT https://api.vocobase.com/api/v2/config/telephony/mcube \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "jwt_token": "new_jwt_token_here",
    "exe_number": "+919876543210"
  }'

Getting Started

Building Agents

Making Calls

Receiving Calls

After the Call

Telephony Providers

Advanced

API Reference

Endpoints

MCube Setup

MCube Setup

Prerequisites

Get your MCube credentials

Configure MCube in Vocobase

Add and assign inbound DIDs

Make a test call

Troubleshooting

”Invalid MCube credentials” error

Calls not connecting

Inbound call returns `unknown_number`

JWT token expired

Next steps

Twilio Setup

Quick Start

​MCube Setup

​Prerequisites

​Get your MCube credentials

​Configure MCube in Vocobase

​Add and assign inbound DIDs

​Make a test call

​Troubleshooting

​”Invalid MCube credentials” error

​Calls not connecting

​Inbound call returns unknown_number

​JWT token expired

​Next steps

Twilio Setup

Quick Start

MCube Setup

Prerequisites

Get your MCube credentials

Configure MCube in Vocobase

Add and assign inbound DIDs

Make a test call

Troubleshooting

”Invalid MCube credentials” error

Calls not connecting

Inbound call returns `unknown_number`

JWT token expired

Next steps