Skip to main content

​
MCube Setup

This guide walks you through connecting your MCube account to Vocobase for outbound 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
  • An approved Vocobase partner account with an API key

​
Step 1: Get your MCube credentials

1

Log in to MCube

Sign in to your MCube dashboard or contact your MCube account manager.
2

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.
3

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).

​
Step 2: Configure MCube in Vocobase

Send your MCube credentials to the Vocobase config API: 
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"
  }'
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.

​
Step 3: Make a test call

Start an outbound call using the mcube provider: 
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"
  }'

{
  "success": true,
  "data": {
    "call_id": "c1234567-abcd-1234-abcd-123456789012",
    "session_id": "s1234567-abcd-1234-abcd-123456789012",
    "status": "pending",
    "provider": "mcube",
    "from_number": "+919876543210",
    "to_number": "+911234567890",
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
If you omit the provider field in the call request, MCube is used by default.

​
Troubleshooting

​
”MCube not configured” error

You will receive a 400 error if you try to make a call with "provider": "mcube" before configuring credentials. Run PUT /config/telephony/mcube with valid credentials.

​
”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

​
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"
  }'

​
Updating credentials

To update your MCube credentials, call PUT /config/telephony/mcube again with the new values. Both fields (jwt_token, exe_number) are required each time.

​
Next steps

Twilio Setup

Configure Twilio as an alternative telephony provider.

Quick Start

Create an agent and make your first call.