BuildPhone NumbersSIP IntegrationProviders

Plivo SIP Integration

How to integrate Plivo SIP with Vapi

Please note that Indian numbers cannot be obtained from Plivo for use with Vapi. This is due to TRAI regulations, which mandate SIP termination to occur via an Indian server—a requirement we currently do not fulfill.

This guide walks you through setting up both outbound and inbound SIP trunking between Plivo and Vapi.

Outbound Calls (Plivo to Vapi)

Plivo Configuration

  1. Login to Plivo Console

    Access the Plivo console at https://console.plivo.com/accounts/login/

  2. Create IP Access Control List

    Navigate to: Zentrunk(SIP) → Outbound Trunks → IP Access Control List → Create New IP Group

    • Name: Choose a descriptive name
    • IP Address List: Whitelist Vapi’s fixed IPs:
      • 44.229.228.186/32
      • 44.238.177.138/32
    • Click “Create ACL”

    Plivo IP Access Control List

  3. Create Outbound Trunk

    Navigate to: Zentrunk(SIP) → Outbound Trunks → Trunks → Create New Outbound Trunk

    • Trunk Name: Choose a descriptive name
    • IP Access Control List: Select the IP ACL created in the previous step
    • Click “Create Trunk”

    Create New Outbound Trunk

  4. Note Your Termination SIP Domain

    After creating the trunk, note the Termination SIP Domain (format: 12700668357XXXXXX.zt.plivo.com)

    Termination SIP Domain

  5. Purchase a Phone Number

    Navigate to: Numbers → Buy a new number

    Buy Phone Number

Vapi Configuration

  1. Get Your Vapi API Key

    Sign in to the Vapi dashboard at https://dashboard.vapi.ai/ and retrieve your API key

    VAPI Dashboard

  2. Create a SIP Trunk Credential

    Use the following API call, replacing the gateway IP with your Plivo Termination SIP Domain:

    $curl -X POST https://api.vapi.ai/credential \
    >-H "Content-Type: application/json" \
    >-H "Authorization: Bearer your-vapi-private-api-key" \
    >-d '{
    >  "provider": "byo-sip-trunk",
    >  "name": "PLIVO Trunk",
    >  "gateways": [
    >    {
    >      "ip": "1270066835XXXXXXXXX.zt.plivo.com"
    >    }
    >  ]
    >}'

    SIP Trunk Credential Response

    Note the id (credentialId) from the response for the next step.

  3. Register Your Phone Number

    Associate your Plivo number with the SIP trunk:

    $curl -X POST https://api.vapi.ai/phone-number \
    >-H "Content-Type: application/json" \
    >-H "Authorization: Bearer your-vapi-private-api-key" \
    >-d '{
    >  "provider": "byo-phone-number",
    >  "name": "PLIVO SIP Number",
    >  "number": "1833684XXXX",
    >  "numberE164CheckEnabled": false,
    >  "credentialId": "a2c815b8-03f4-40f5-813c-xxxxxxxxxxxx"
    >}'

    Phone Number Response

    Note the phone number ID from the response for making calls.

  4. Create a Vapi Assistant

    Follow the steps at https://docs.vapi.ai/quickstart/dashboard#create-an-assistant

    Create VAPI Assistant

    Note your Assistant ID for making calls.

  5. Make Outbound Calls

    Using the API:

    $curl --location 'https://api.vapi.ai/call/phone' \
    >--header 'Authorization: Bearer your-vapi-private-api-key' \
    >--header 'Content-Type: application/json' \
    >--data '{
    >  "assistantId": "29d47d31-ba3c-451c-86ce-xxxxxxxxx",
    >  "customer": {
    >    "number": "9199437XXXXX",
    >    "numberE164CheckEnabled": false
    >  },
    >  "phoneNumberId": "eba2fb13-259f-4123-abfa-xxxxxxxxxxx"
    >}'

    Outbound Call Response

    Using the Vapi Dashboard:

    Select your Assistant and enter the destination number you want to call.

    VAPI Dashboard Call

Inbound Calls (Vapi to Plivo)

Plivo Configuration

  1. Login to Plivo Console

    Access the Plivo console at https://console.plivo.com/accounts/login/

  2. Create Origination URI

    Navigate to: Zentrunk(SIP) → Inbound Trunks → Origination URI → Create New IP URI

    • Name: Choose a descriptive name
    • URI: Enter Vapi’s SIP URI: sip.vapi.ai;transport=udp
    • Click “Create URI”

    Create New IP URI

  3. Create Inbound Trunk

    Navigate to: Zentrunk(SIP) → Inbound Trunks → Trunks → Create New Inbound Trunk

    • Trunk Name: Choose a descriptive name
    • Primary URI: Select the URI created in the previous step
    • Click “Create Trunk”

    Create New Inbound Trunk

  4. Attach Phone Number to Inbound Trunk

    Navigate to: Phone Numbers → Select your purchased number

    • In the Application dropdown, select “Zentrunk”
    • In the Zentrunk dropdown, select your inbound trunk
    • Save the changes

    Attach Number to Inbound Trunk

Vapi Configuration

  1. Get Your Vapi API Key

    Sign in to the Vapi dashboard at https://dashboard.vapi.ai/ and retrieve your API key

  2. Create an Inbound SIP Trunk Credential

    $curl -X POST https://api.vapi.ai/credential \
    >-H "Content-Type: application/json" \
    >-H "Authorization: Bearer your-vapi-private-api-key" \
    >-d '{
    >  "provider": "byo-sip-trunk",
    >  "name": "PLIVO Inbound Trunk",
    >  "type": "inbound"
    >}'

    Note the id (credentialId) from the response for the next step.

  3. Register Your Phone Number

    $curl -X POST https://api.vapi.ai/phone-number \
    >-H "Content-Type: application/json" \
    >-H "Authorization: Bearer your-vapi-private-api-key" \
    >-d '{
    >  "provider": "byo-phone-number",
    >  "name": "PLIVO SIP Inbound Number",
    >  "number": "1833684XXXX",
    >  "numberE164CheckEnabled": false,
    >  "credentialId": "a2c815b8-03f4-40f5-813c-xxxxxxxxxxxx"
    >}'

  4. Create and Configure a Vapi Assistant

    Now when someone calls your Plivo number, the call will be routed to your Vapi assistant.