phabricator/externals/twilio-php/docs/usage/rest/sip.rst

Sip In

Getting started with Sip

If you’re unfamiliar with SIP, please see the SIP API Documentation on our website.

Creating a Sip Domain

The Domains resource allows you to create a new domain. To create a new domain, you’ll need to choose a unique domain that lives under sip.twilio.com. For example, doug.sip.twilio.com.

require('/path/to/twilio-php/Services/Twilio.php');

$client = new Services_Twilio('AC123', '123');
$domain = $client->account->sip->domains->create(
  "Doug's Domain", // The FriendlyName for your new domain
  "doug.sip.twilio.com", // The sip domain for your new domain
  array(
    'VoiceUrl' => 'http://example.com/voice',
));

echo $domain->sid;

Creating a new IpAccessControlList

To control access to your new domain, you’ll need to explicitly grant access to individual ip addresses. To do this, you’ll first need to create an IpAccessControlList to hold the ip addresses you wish to allow.

require('/path/to/twilio-php/Services/Twilio.php');

$client = new Services_Twilio('AC123', '123');
$ip_access_control_list = $client->account->sip->ip_access_control_lists->create(
  "Doug's IpAccessControlList", // The FriendlyName for your new ip access control list
);

echo $ip_access_control_list->sid;

Adding an IpAddress to an IpAccessControlList

Now it’s time to add an IpAddress to your new IpAccessControlList.

require('/path/to/twilio-php/Services/Twilio.php');

$client = new Services_Twilio('AC123', '123');
$ip_address = $client->account->sip->ip_access_control_lists->get('AC123')->ip_addresses->create(
  "Doug's IpAddress", // The FriendlyName for this IpAddress
  '127.0.0.1', // The ip address for this IpAddress
);

echo $ip_address->sid;

Adding an IpAccessControlList to a Domain

Once you’ve created a Domain and an IpAccessControlList you need to associate them. To do this, create an IpAccessControlListMapping.

require('/path/to/twilio-php/Services/Twilio.php');

$client = new Services_Twilio('AC123', '123');
$ip_access_control_list_mapping = $client->account->sip->domains->get('SD123')->ip_access_control_list_mappings->create(
  'AL123', // The sid of your IpAccessControlList
);

echo $ip_access_control_list_mapping->sid;