メニュー

Expand
ページを評価:

How to route calls to your SIP network with an outbound call

If you are looking to explore SIP functionality, we recommend following the SIP Quickstart to get you up and running in a few clicks!

Are you interested in learning how to make calls using SIP with Twilio programmability? This guide will show you how to use Programmable Voice to make SIP outbound phone calls from Twilio to your Twilio Registered SIP Endpoints.

It's possible to connect an existing Twilio Voice Application directly to your SIP network. You can do this by requesting Twilio make a SIP call from either an existing incoming call, or from an outbound API request. Not only does this give you access to all the powerful Programmable Voice solutions, but it also allows you to lean on the savings by not routing your call through normal PSTN.

Steps to route calls to your SIP Network

  1. Buy a Twilio Number
  2. Configure SIP Registration
  3. SIPエンドポイントを構成する
  4. Make an outbound SIP call

はじめましょう!

Buy a Twilio Number

Twilioコンソールでは、通話の発信に対応した利用可能な電話番号を検索、購入できます。 この電話番号は、発信通話を開始する際に発信者番号 (From) として使用します。

音声通話の利用可能な電話番号の検索

Configure SIP Registration

Note: If you are not using Twilio Registered Endpoint then this step is not applicable to you.

In order to make and receive phone calls to a SIP phone, like Zoiper, SIP Registration is required. This enables routing the calls to SIP phone/Endpoint. In this tutorial, we are using a Twilio Registered Endpoint to receive the call. This guide will show how to enable registration and setup credentials.

  1. Configure Credential List
    1. Log in to your twilio account go to programmable voice. Select “credential lists
    2. Click the “+” icon to create credential list.
    3. Add a Friendly Name as Endpoint, Username (this can be E164 number, Extention number or name) as UserA and Password as yourpassword and click Create. Note: The credential username and password created here will be used on your SIP Endpoints for authentication.
  2. Configure SIP Domain
    1. Select “Domains
    2. Click the “+” icon to create SIP Domain.
    3. Add a Friendly Name as T1 and a unique SIP URI as Trunk1. Note: SIP URI names needs to be unique, I have used Trunk1 in my example. You might have to find a name that is available
    4. Scroll down to "Voice Authentication" and associate the "Credential Lists" Endpoint that you created
    5. Scroll down to "SIP Registration" and click "Enabled"
    6. In "SIP Registration Authentication" associate the "Credential Lists" that you created. Then click "Save"

Configure SIP Endpoint

Note: If you are not using Twilio Registered Endpoint then this step is not applicable to you.

A SIP Endpoint can be desk phone or soft phone. In this guide, we will use the soft phone and will configure the phone to successfully register to SIP Registrar.

  1. Download and install SIP Endpoint. Zoiper is used for example
  2. Provide login name - UserA@Trunk1.sip.us1.twilio.com (do add us1 region parameter to your sip domain) and password
    • Username and password from Credential List Username
    • Yourdomain from SIP Domains. For example, Trunk1.sip.us1.twilio.com (do add us1 region parameter to your sip domain while configuring zoiper)
  3. Click "Next/continue" to confirm the Domain
  4. Optional settings can be skipped
  5. Done! You see in Zoiper that it is "Registered" and has "Tick" next to your login name.
  6. You can also verify the successfully registered endpoints under your SIP domain > Registered SIP Endpoints in the Twilio console

Reg

Make an outbound SIP call

There are a couple of ways that you can make an outbound SIP call from Twilio. Remember this outbound call that Twilio makes is what will connect with your SIP Network.

Make an outbound SIP call using an inbound call handler

It's possible to have Twilio run code when a call is received. For our example, we will have that code make an outbound SIP call to our network.

We will now write the TwiML for our application. Because this is a static application, we will use a TwiML Bin. Visit the TwiML Bin page and click the + icon to add a new bin.

Set the Friendly Name as SIP Outbound call and copy and paste the TwiML below

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say>Welcome to xyz.com. Your call will be routed to an agent now</Say>
  <Dial>
    <Sip>sip:UserA@Trunk1.sip.us1.twilio.com</Sip>
  </Dial>
</Response>

Make sure to add us1 region parameter as part of your SIP domain

With our TwiML Bin created, now we need to wire it up to our number.

  1. Go to your Twilio Number page
  2. Click the Number you have purchased
  3. Scroll down to "Voice" under "A Call Comes in" select your configured TwiML Bin as SIP Outbound call from the dropdown menu and click "Save"

URL

Take your cellphone and dial the Twilio Number you purchased. You should hear a notification that you are being transferred and then an outbound SIP call will be made. Congratulations!

Make an outbound SIP call using API

Another way to make an outbound call is by using the REST API. Here we will create a Call resource and point it directly to our SIP client.

Twilioアカウントの認証情報を取得する

First, you'll need to get your Twilio account credentials. They consist of your AccountSid and your Auth Token. They can be found on the home page of the console.

Twilioアカウントの認証情報の取得

通話を発信する際に特筆すべき、いくつかの重要なパラメーターがあります。

  • "From" - the username or number you are calling from
  • "To" - login name of your SIP Endpoint (Zoiper). For example, sip:UserA@Trunk1.sip.us1.twilio.com (do add us1 as a region parameter to your SIP Domain)
  • "Twiml" - The TwiML instructions on what should happen when the other party picks up the phone.

Visit the TwiML Bin page and click the + icon to add a new bin.

Set the Friendly Name as Notification and copy and paste the TwiML below

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say>Well done you have successfully made an outbound SIP call from Twilo using an API</Say>
</Response>
        
        
        
        

        Run the code. You should hear a notification that you have successfully made an outbound SIP call. Congratulations!

        関連トピック

        Great work!

        楽しいプログラミングを!

        Madhubhashni Mathiyalagan Maylon Pedroso Jarod Reyes Rob Spectre Ricky Robinett David Prothero Kevin Whinnery Craig Dennis Andrew Baker
        ページを評価:

        ヘルプが必要ですか?

        誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。

              
              
              

              フィードバックくださりありがとうございます!

              We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!

              Refer us and get $10 in 3 simple steps!

              ステップ1

              Get link

              Get a free personal referral link here

              ステップ2:

              Give $10

              Your user signs up and upgrade using link

              ステップ3

              Get $10

              1,250 free SMSes
              OR 1,000 free voice mins
              OR 12,000 chats
              OR more