> ## Documentation Index
> Fetch the complete documentation index at: https://plivo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio

> Use Plivo as a BYOC carrier with Twilio — outbound and inbound setup

<Tabs>
  <Tab title="Secure Outbound BYOC">
    # Set up Voice Termination with Twilio Bring Your Own Carrier (BYOC) Trunking Service

    ## Overview

    Using Zentrunk, Plivo’s SIP trunking platform, you can terminate calls from Twilio using Plivo as the carrier. This guide will help you to set up Plivo as a BYOC trunk on the Twilio platform, and whenever you terminate calls from Twilio using the BYOC trunk, Plivo will act as the carrier for those calls.

    To implement this functionality, you must:

    1. Create a Plivo outbound trunk on the Plivo platform
    2. Create a Twilio BYOC trunk on the Twilio platform

    ## Create a Plivo Outbound Trunk

    You need to set up the trunk authentication on the Plivo Console to use Zentrunk to terminate calls. Authentication of your trunk ensures that Zentrunk only accepts traffic that your infrastructure sends securely. You can configure your trunk to be authenticated by an IP Access Control List, a Credentials List, or both. For more information, please check the step-by-step GIF & instructions below.

    <Frame>
      <img src="https://mintcdn.com/plivo/Ac6PoKJHHxDx1U63/images/twilio_termination.gif?s=527c9df4aadd863929f74b1a2bbcfc24" alt="" width="1024" height="576" data-path="images/twilio_termination.gif" />
    </Frame>

    #### To create an Outbound Trunk:

    1. On the [Outbound Trunks](https://cx.plivo.com/sip-trunking) page in your Plivo Console, click **"Create New Outbound Trunk"**.

    2. In the New Trunk window, enter a name for your trunk (for example, Twilio Termination).

           <Note>
             **Note:** By default, the trunk is enabled.
           </Note>

    3. Under Trunk Authentication, to Create an IP Access Control List:
       1. Click **"+ Add New IP ACL"**.
       2. In the 'Create New IP Access Control List' window, enter the name for your IP Access Control List (for example, Twilio IPs) and then provide the following <a href="https://www.twilio.com/docs/voice/bring-your-own-carrier-byoc#sip-domain-uri" rel="nofollow">IP addresses</a> to be whitelisted in the IP Address List field.

          * 54.244.51.0
          * 54.244.51.1
          * 54.244.51.2
          * 54.244.51.3

              <Note>
                **Note:** In the "IP Access Control List" you can specify the list of IP addresses from which the SIP Invite will be accepted for this trunk.
              </Note>
       3. Click **"Create ACL"** to save and add your IP Access Control List.

    4. Select the IP Group, and click **"Create Trunk"**. Your Outbound trunk will be created.

    5. Once the trunk is created, copy and store the **Termination SIP Domain URI** that ends with *.zt.plivo.com*. This will be useful while creating the BYOC trunk on the Twilio Platform in the next section.

    ## Create a Twilio BYOC Trunk

    You can follow the below GIF and instructions set to create a BYOC trunk on the Twilio platform and set up the Plivo Zentrunk which you created in the previous step as the BYOC trunk.

    <Frame>
      <img src="https://mintcdn.com/plivo/NFI9_HRHTMInDf93/images/byoc_trunk.gif?s=d93af7d67df870035f61139f3e1b39ec" alt="" width="1024" height="562" data-path="images/byoc_trunk.gif" />
    </Frame>

    1. On the <a href="https://www.twilio.com/console/voice/byoc-trunking/trunks" rel="nofollow">BYOC Trunk page</a>, click on the **"+"** button to create a new trunk.
    2. Give a name for the trunk and click the **"Create BYOC Trunk"** button.
    3. In the "Origination Connection Policy (to your Carrier)" section, click on the **"+"** button to create a new Origination Connection Policy
    4. Provide a name for the origination connection policy and click on the **"create"** button.
    5. Click on the **"+"** button to create a new origination target and provide the previously copied Plivo’s Termination SIP Domain URI with "sip:'' as a prefix.
    6. Click on the **"Create"** button to create a new Origination Target.
    7. Click on **"Save"** in the BYOC Trunks page to save the new create BYOC Trunk.
    8. Copy the BYOC Trunk SID.

    ## Make an Outbound call using the BYOC Trunk

    You can terminate calls via your BYOC trunk by using the below cURL code snippet.

    ```shell theme={null}
    curl 'https://api.twilio.com/2010-04-01/Accounts/{Your Account SID}/Calls.json' -X POST --data-urlencode 'To=your_destination_number'
    --data-urlencode 'From=your_source_number' --data-urlencode 'Url={Your Twilio App URL}' --data-urlencode 'Byoc={your_BYOC_Trunk_SID}' -u
    {Your Account SID}:{Your Auth Token}
    ```

    Also, if you are interested in integrating your PBX/SBC with Plivo outbound trunks, you can click [here](https://cx.plivo.com/signup) to sign up for free and create your first SIP trunk today!
  </Tab>

  <Tab title="Secure Inbound BYON">
    # Set up Voice Origination with Twilio Bring Your Own Number (BYON) Service

    ## Overview

    Using the Plivo SIP-trunking platform, you can use your Plivo numbers to route calls to the Twilio voice platform. In this guide, we will walk you through how to set up a Plivo number for voice origination via Twilio’s BYON (Bring Your Own Number) service for routing the calls to a Twilio SIP Domain.

    To achieve this functionality, you must complete the following two configurations on the Twilio and the Plivo platforms:

    1. Create a Twilio SIP domain with an ACL (with Plivo IPs).
    2. Create a Plivo inbound trunk and assign it to a Plivo number.

    ## Create a Twilio SIP Domain with an ACL

    Follow the steps below to create a Twilio SIP domain and authenticate the calls routed through Plivo.

    * Create an Access Control List (ACL) to authenticate Plivo IPs with Twilio
    * Create a SIP domain and choose the ACL with Plivo IPs

    ### Create an ACL to authenticate Plivo IPs with Twilio

    To send traffic to a Twilio SIP domain from Plivo, the traffic must be first authenticated with an IP whitelist or username and password.

    To create an IP whitelist:

    * Navigate to the **IP Access Control** Lists page [here](https://www.twilio.com/console/voice/sip/ip-acls).

          <Frame>
            <img src="https://mintcdn.com/plivo/M2NzHE_bNZbCm0gd/images/new_acl.png?fit=max&auto=format&n=M2NzHE_bNZbCm0gd&q=85&s=5a9022b68b9d854e35ec80f4e59c8119" alt="" width="1397" height="684" data-path="images/new_acl.png" />
          </Frame>

    * In the “New Access Control List” page, Enter a friendly name that will help you remember the IP group and then add in the following Plivo IPs:

      | Regions                         | IP Addresses      |
      | ------------------------------- | ----------------- |
      | North California, USA           | 13.52.9.0/25      |
      | Virginia, USA	18.214.109.128/25 | 18.215.142.0/26   |
      | Frankfurt, Germany              | 3.120.121.128/26  |
      | Sao Paulo, Brazil               | 18.228.70.64/26   |
      | Sydney, Australia               | 13.238.202.192/26 |
      | Singapore                       | 18.136.1.128/26   |

    ### Create a SIP domain and choose the ACL (with Plivo IPs)

    You need to follow the below instructions to complete the configuration on the Twilio side:

    * You can navigate to the Twilio **SIP Domains** page [here](https://www.twilio.com/console/voice/sip/endpoints) and provide a domain name for the new SIP domain.
    * Choose the IP ACL (with Plivo IPs) you created in the previous step.
    * Copy and store the SIP URI. This will be helpful while creating the trunk on the Plivo platform (next step).

          <Frame>
            <img src="https://mintcdn.com/plivo/M2NzHE_bNZbCm0gd/images/new_sip_domain.png?fit=max&auto=format&n=M2NzHE_bNZbCm0gd&q=85&s=c0e7a0f39316797a721b40b15b079108" alt="" width="1397" height="798" data-path="images/new_sip_domain.png" />
          </Frame>

          <Note>
            **Note**: Twilio SIP domain is a custom DNS host name associated with your Twilio account that can accept SIP traffic. This maps a domain name to the IP address (IPv4) of the computer hosting the domain.
          </Note>

    ## Create a Plivo inbound trunk and assign it to a Plivo number.

    <Frame>
      <img src="https://mintcdn.com/plivo/sqGJ0ONkT5kTuesy/images/twilio_origination.gif?s=31bb209d5175a761b20943e06f6b5f7d" alt="" width="1024" height="562" data-path="images/twilio_origination.gif" />
    </Frame>

    **To create an Inbound Trunk:**

    1. On the [Inbound Trunks](https://cx.plivo.com/sip-trunking) page in your Plivo Console, click **Create New Inbound Trunk**.
    2. On the New Trunk window, enter a name for your trunk (for example, Twilio Origination).

    <Note>
      **Note**: The Enabled checkbox is selected by default.
    </Note>

    3. Select the Primary URI and Fallback URI of your PBX.

    <Note>
      **Note**: The Primary URI is the FQDN or IP address to which all calls are forwarded first. If the Primary URI is unresponsive, the calls will be forwarded to the Fallback URI. Please note that the Fallback URI is optional.
    </Note>

    4. To add a new Primary or Fallback URI, click **Add new URI**.
    5. On the **Create URI window**, enter a name for your URI (for example, Twilio\_origin), and then enter the SIP URI of the Twilio SIP domain (the one which you stored while configuring the SIP domain in the previous section).
    6. To enable Authentication, click on the **Authentication** option and provide username & password.
    7. Click **Create URI** to save and add your URI.
    8. Once you have created and selected your Primary and Fallback URI, click **Create Trunk**. Your inbound trunk will be created.

    **To assign an inbound trunk to a Plivo Number:**

    1. Once you click on **Create Trunk**, in the next window you can link your trunk with Phone numbers.
    2. You can either link the trunk with your existing phone numbers in your account or buy a new phone number and link the trunk.
    3. If you wish to use your existing numbers, select the phone numbers under the **Current Phone Numbers** section, and click **Link Selected Numbers**.
    4. If you wish to use a new number, navigate to the **Buy New Number** section and choose the country, prefix, type, capability, and click on **Search**.
    5. Select a Phone number and click **Buy Number**.
    6. Once you click on Buy Number, the number will be added to your account and the same will be linked with your inbound trunk.

    To know more about buying a Plivo Phone number, please navigate to the [Buy a number section](/numbers/phone-numbers#buy-a-phone-number).

    ## Test & Validate

    Now, your setup is complete. You can make calls to the Plivo number and see that the calls are routed to the Twilio SIP domain to execute the webhook or the application set up at Twilio end.
  </Tab>
</Tabs>