Skip to main content

General

  • How can I reject an incoming call?

    You can hang up an incoming call using the <Hangup> XML element. The application attached to the Plivo number must return a <Hangup> element, along with an applicable reason attribute to end the call.

    <Response>

        <Hangup reason="rejected" />

    </Response>

  • Can I disconnect a specific outbound call and keep others active?

    Yes, you can disconnect a specific call and keep all other outbound calls active by using the Call object with a DELETE verb and specifying a call_uuid. If you don't specify a call_uuid, all live calls for the account will be disconnected.

  • How can I retrieve the status of a call?

    Plivo posts call details to the web server configured in any of these URLs.

    • answer_url: details are posted when the call is answered. 
    • hangup_url: details are posted when the call is ended. 
    • action: details are posted if an action (attribute) is defined in the Dial XML element. 
    • callback_url: details are posted if the callback_url is defined in the XML element when the call is answered. 

    Call status is among the details posted. For more information, refer to our documentation on Voice XML requests, Using Callback URL, and Call Status.

  • What do the different call statuses mean?

    See our Voice XML Reference documentation for a list of call status values and explanations of each.

  • Can I change the call flow of an ongoing call?

    You can change a call flow during a live call by using Plivo’s Call object. You can transfer an in-progress or active call to a different URL and fetch and execute XML from a new URL.

  • How can I make bulk calls using a single API request?

    See our Bulk Call use-case guide for complete details.

  • How can I make calls using the outbound call API?

    See the Make Outbound Calls guide in our documentation for details about how to make outbound calls using the Voice API in Node.js, Ruby, Python, PHP, .NET, Java, Go, or PHLO, Plivo's visual workflow design studio.

  • How can I calculate the cost of a call?

    To calculate the cost of a call, you have to factor in a few elements: 

    • The usage (the length and direction of the call)
    • The phone number
    • The prefix
    • The duration of a call

    Example: Outbound call with regular number

    Here’s an example illustrating how to calculate charges for an outbound call to a UK number.

    • The prefix is "4420."
    • The call duration is 70 seconds.
    • The outbound pricing for UK numbers with prefix “4420” is $0.0031 per minute.
    • The cost for the call would be: $0.0031+ $0.0031= $0.0062.
    • The cost of a phone number in the UK is $0.80 per month.
    • Total cost = $0.8062

    Note: The phone number is charged on a monthly basis. The above charges are just an example.

    You need not purchase a phone number from Plivo to make an outbound call.

    Detailed pricing information is available on the Plivo pricing page.

    Example: Toll-free number

    Plivo supports outbound calls using a toll-free number only in the USA and Canada. Here’s an example of making an outbound call using a toll-free number in the US.

    • The prefix is “1907.”
    • The call duration is 70 seconds.
    • The outbound pricing for US numbers with prefix “1907” is $0.1790 per minute.
    • The cost for the call would be: $0.1790 + $0.1790 = $0.358.
    • The cost of a phone number in US is $1.00 per month.
    • Total cost = $1.358

    Note: The phone number is charged on a monthly basis. The above charges are just an example.

    You need not purchase a phone number from Plivo to make an outbound call if you have an existing toll-free number.

    Detailed pricing information is available at the Plivo pricing page.

    Example: Inbound call with a regular number

    Let us consider an example of an inbound call in the United Kingdom.

    • The call duration is 70 seconds.
    • The inbound pricing for a UK regular number is $0.0050 per minute.
    • The cost for an inbound call is $0.0050 + $0.0050 = $0.01.
    • The cost of a regular phone number in the UK is $0.80 per month.
    • Total cost = $0.81.

    Note: The phone number is charged on a monthly basis. The above charges are just an example.

    You must purchase a phone number from Plivo to receive inbound calls.

    Detailed pricing information for inbound calls is available on the Plivo pricing page.

    Additional features at no extra cost

    At Plivo we provide loads of add-on features at no additional cost:

    1. Call recording and storage
    2. Multilingual text to speech
    3. Automatic machine detection
    4. Dynamic caller ID

    However, there is an additional cost for call transcription: 

    • Auto transcription is $0.05 per minute
    • Hybrid transcription is $0.35 per minute
  • How will I be charged for calls?

    Two main factors determine what you will be charged for making and receiving calls: usage and phone number rental fees. 

    Usage refers to the inbound and outbound minutes that you incur. 

    Both inbound and outbound calls are charged in 60-second increments, with a minimum billing length of 60 seconds. All calls are billed to the next closest minute. For example, a 10-second call is billed at one minute, while a 70-second call is billed at two minutes.

    Phone numbers are charged on a monthly basis per number. A phone number is required to receive calls, not to make them. If you want to forward incoming calls to your call center, you can buy a Plivo number and set up a call forwarding application. We maintain a inventory of phone numbers in every region we serve.

    The cost per phone number varies depending on the prefix and type of phone number (long code, toll-free, short code). A prefix is the set of digits that represents a country, state, and area code. Each country has a unique international code. That's followed by a set of numbers that represents a region. A typical dialing number may be a combination of:

    1. County code
    2. Area code
    3. Destination number

    Refer to our Voice API pricing page for country-specific rates for calls and phone numbers. Note that all rates are based on the longest matching destination prefix.

  • What countries are voice calls supported in?

    Plivo supports outbound voice calls to more than 220 countries and inbound voice calls on Plivo phone numbers in 46 countries. If you'd like to reach a country or a carrier network that's not on our list, please contact us.

     

  • How can I screen inbound calls and block unwanted callers?

    You can screen inbound calls by adding phone numbers to a blacklist using Plivo’s PHLO visual workflow builder, or using XML. This allows you to set up automated workflows that reject calls from blacklisted numbers and handle calls based on your preferences.

    For detailed instructions on setting up XML/PHLO, please refer to our guide on screening incoming calls.

  • Can I call multiple numbers with a single API call?

    Yes, Plivo supports multiple outbound calls through a single API request. Read about how to do it in our guide to making bulk calls.

    Be aware that your account is configured for a default rate of calls per second. If you need a higher rate, contact our sales team

  • How can I get the status of an active call?

    Plivo provides dedicated APIs to retrieve the status of an active call. 

    Get a list of all active calls with the “get details of all ongoing calls” API. Or, use the “get details of a specific ongoing call” API to retrieve the details of a specific active calluuid.

    You can also use our latest live call v2 API to retrieve details of all active calls.

  • How can I make an outbound call to a list of phone numbers?

    You can trigger an API for each destination number at one time, or (the easy way) trigger an API for all the numbers at once by adding them with a less-than-symbol delimiter ("<") between them, as documented in our guide to making bulk calls.

    Plivo lets you dial a list of numbers sequentially or simultaneously.

  • How can I make a phone call using Plivo?

    You can make outbound phone calls with Plivo to landlines, mobile phones, and SIP endpoints (softphones) in any of the 190+ countries we support in three ways:

    1. Make an HTTP POST request to our Voice API Call object or use a PHLO.
    2. Use an endpoint via a softphone, hardphone, or an SDK.
    3. Integrate your application with Plivo using one of our client SDKs.

    Visit our quickstart guide for details on how to make an outbound call using XML or PHLO, our visual workflow builder studio.

  • Do I need to add a country code while dialing out?

    Yes, Plivo requires all destination phone numbers to be dialed in the E.164 international telephone number format: [country code][area code][phone number]. Any deviation from this format will cause errors in your application.

    For example, the phone number 777-8888 in the 415 area code in the USA would need to be dialed as 14157778888.

  • Are there limits on the number of calls per second I can make?

    Yes, we have account-level limitations on the number of calls allowed per second. They're specified in our Account Limits documentation. Limitations are applied to your main account and not at the subaccount level.

    To request an increase in the number of calls you can make or receive per second for your account, contact our sales team.

  • Where can I find the SIP URI of an application I just created?

    In the Plivo console, go to Voice > Applications to see all the applications you've created. You can click on an application name to view and edit application details, including the SIP URI and other related URLs.