Skip to main content

Voice Geo Permissions

  • How do I remove an override for a specific subaccount?

    You can maintain custom geo permissions for each of your subaccounts. For example, you can enable calls to specific countries when using a specific subaccount and disable the same countries when using a different subaccount. You can also reset subaccount geo permissions to the default setting. 

    Step 1: Navigate to the Voice Geo Permissions page and select the subaccount from the Account menu drop-down.

    Screenshot.png

    Step 2: After selecting the subaccount, click on Remove override to set default preferences.

    Screenshot.png

    Screen_Shot_2020-06-05_at_3.11.43_AM.png

    For more information, see our detailed reference documentation.

  • How do I know if a call was blocked due to geo permissions?

    You can see whether a call was blocked due to voice geo permissions by checking the hangup cause in your voice logs. You can filter logs using the following hangup causes:

    • Destination Country Barred (Code 2030)
    • Destination Number Barred (Code 2040)

    Screenshot.png

    Calls to blocked countries

    API calls to blocked countries are rejected with HTTP response code 403 and the error message Calls to this destination country are barred.

    Calls initiated with the Dial XML are dropped automatically. The hangup cause listed in the CDR for such calls is set to Destination Country Barred (Code 2030).

    Learn more about Plivo hangup causes in our documentation.

    Calls to blocked numbers

    API calls to blocked numbers are rejected with HTTP response code 403 and the error message Calls to this destination number are barred.

    Calls initiated with the Dial XML are dropped automatically. The hangup cause listed in the CDR for such calls is set to Destination Number Barred (Code 2040). 

    For more information on outbound voice geo permissions, see our reference documentation.

  • How do I use an API to set Plivo’s voice geo permissions?

    Plivo voice geo permissions are supported only via the Plivo console.

  • What countries have the highest risk of call fraud?

    Plivo disables by default countries with a high risk of call fraud. To see countries disabled by default, visit the Voice Geo Preferences page in the Plivo console. Under the Geo Permissions For Outbound Calls section, select Filter Countries > Status > Disabled, then click Apply.

    Screenshot.png

    The following countries have the highest risk of call fraud. All are disabled by default.

    Afghanistan
    Albania
    Austria
    Azerbaijan
    Belarus
    Bulgaria
    Cambodia
    Cameroon
    Croatia
    Cuba
    Democratic Republic of the Congo
    Ecuador
    Georgia
    Greenland
    Guinea
    Haiti
    Honduras
    Ivory Coast
    Libya
    Madagascar
    Maldives
    Morocco
    Niger
    North Korea
    Papua New Guinea
    Republic of the Congo
    Samoa
    Serbia
    Sierra Leone
    Solomon Islands
    Somalia
    South Sudan
    Tanzania
    Zimbabwe

     

  • Are voice geo permissions effective only for calls made via REST APIs?

    Voice geo permissions are effective for calls made using both REST APIs and Dial XML. This post explains how you can see whether a call was blocked due to voice geo permissions.

  • How do I override voice geo permissions for specific subaccounts?

    Default preferences are applied to all calls initiated from the main account and all subaccounts unless they're explicitly overridden for a subaccount. To specify preferences for a subaccount, go to Voice > Geo Permissions. Select the subaccount from the Account drop-down menu, specify your preferences, and click Save Changes.

    6.png

    For more information, see our documentation.

  • How do Plivo’s voice geo permissions work?

    Voice geo permissions let you enable or disable outbound calls to specific countries from the Plivo console. Our documentation provides detailed information on how they work.

    Geo permissions take effect immediately once the settings are saved and are applied to all calls placed via REST APIs and Dial XML.

  • How can I block calls to premium phone numbers?

    You can minimize the risk of toll fraud and international revenue-sharing fraud by closing voice routes to premium phone numbers from your Plivo account. We recommend that you disable outbound calls to premium numbers unless your use case depends on it.

    You must be an admin user to block calls to premium phone numbers in the console. Go to Voice > Geo Permissions > High Risk Permissions. Tick the check box at the top of the third column and click Save Changes to update your preferences.

    Screenshot__2_.png

    Enabling this feature blocks calls to premium numbers across all countries.

  • How can I disable outbound calls to specific countries from my Plivo account?

    On the Plivo console, go to Voice > Geo Permissions > Country Permissions to block outbound calls to specific countries.

    Screenshot__3_.png

    You can override geo permissions for individual subaccounts to restrict access at a granular level.

  • Can I limit my application to not send calls or SMS messages to certain countries or prefixes?

    Yes. As an example, suppose you want to allow calls and SMS messages only to numbers in the North American Numbering Plan (NANP).

    The country code for the 20 countries in the NANP (which includes the US, Canada, and countries in the Caribbean) is +1. You can find lists of area codes online. The Plivo prefix consists of the numbers of the country code plus the area code: 1406 for Montana, for example.

    Allow the prefixes you want to include in your application, and have your code check to make sure that any attempts to message or call any other prefix will not be completed.

    You can achieve the same results for outbound calls or messages for entire countries by going to the Plivo console, to Voice or SMS > Geo Permissions > Country Permissions, and ticking checkboxes to enable or disable calls for specific countries.