Emergency Calling for SIP Interfaces API
Twilio’s Emergency Calling for SIP API enables emergency call routing to Public Safety Answering Points (PSAPs) in the US, Canada, and the UK.
Emergency calling is enabled on a per phone number basis. This page outlines the process you should follow to enable or disable emergency calling using Programmable Voice SIP Interfaces. Please ensure that you also read our emergency calling documentation.
Phone numbers are managed through the core Twilio REST API. Check out the IncomingPhoneNumber resource documentation for more information.
From September 8, 2021, all Twilio numbers from the US, Canada and the UK will have emergency calling always enabled, thus Emergency Status will be Active. Attempting to set the Emergency Status to Active or Inactive will not break the API nor have any effect on the enablement or disablement of emergency calling.
If Emergency Status is Active, the Twilio Number will be ready to place an emergency call, independently of the registration of an emergency address. If Emergency Status is Inactive, the Twilio Number can’t be used to make emergency calls.
In the US and Canada, when a 911 call is placed from a phone number without a registered emergency address, Twilio will charge a $75 fee per 911 call for the call to be delivered to a national emergency location center. To avoid this charge, associate a validated emergency address with your phone numbers.
Use the new parameter Emergency Address Status to check the status of the registration of the emergency address.
Twilio電話番号で緊急通話をオンにする
- Create and validate a new Emergency Address.
- Associate an Emergency Address with a Twilio number.
- Enable Emergency Calling on a Twilio number.
- Check Emergency Calling Status on a Twilio number.
- Enable Emergency Calling on a SIP Domain.
To be deprecated on September 8, 2021.
Twilio電話番号で緊急通話をオフにする
- Disable Emergency Calling on a Twilio number.
- Check Emergency Calling Status on a Twilio number.
- Disassociate an Emergency Address from a Twilio number.
- Delete an Emergency Address.
- Disable Emergency Calling on a SIP Domain.
To be deprecated on September 8, 2021.
Register an Emergency Address on a Twilio Number (from September 8)
- Create and validate a new Emergency Address.
- Associate an Emergency Address with a Twilio number.
- Check Emergency Calling Address Status on a Twilio number.
- Enable Emergency Calling on a SIP Domain.
Delete Emergency Address on a Twilio Number (from September 8)
- Set Emergency Address to Null.
- Check Emergency Address Status on a Twilio number to ensure it's Unregistered.
- Disable Emergency Calling on a SIP Domain.
Twilio電話番号における緊急連絡先の変更
- Disable Emergency Calling on your Twilio Number.
- Check Emergency Calling Status on a Twilio number to ensure it's Inactive.
- Associate new Emergency Address with Twilio Number.
- Enable Emergency Calling on the Twilio Number.
- Check Emergency Calling Status on a Twilio number to ensure it's Active.
From September 8, 2021:
- Check Emergency Calling Status on a Twilio number to ensure it’s Active.
- Set Emergency Address to Null.
- Check Emergency Address Status on a Twilio number to ensure it’s Unregistered.
- Associate new Emergency Address with Twilio Number.
- Check Emergency Address Status on a Twilio number to ensure it’s Registered.
新しい緊急連絡先を作成および有効にする
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses
Create a new Address and validate it for Emergency Calling by setting the EmergencyEnabled parameter to true.
レスポンス例
新しい住所は検証プロセスの一環として推奨されることがあります:
<?xml version='1.0' encoding='UTF-8'?>
<TwilioResponse>
<RestException>
<Code>21629</Code>
<Message>Failed to validate address. Check the suggested address. | FriendlyName: Twilio, CustomerName: Twilio, Street: 645 HARRISON ST, Locality: SAN FRANCISCO, Region: CA, PostalCode: 94105, IsoCountry: US</Message>
<MoreInfo>https://www.twilio.com/docs/errors/21629</MoreInfo>
<Status>400</Status>
</RestException>
</TwilioResponse>
}
Twilio電話番号に緊急連絡先を関連づける
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}
You can disassociate an Emergency Address by updating the the emergency_address_sid to null (or undefined, None or nil depending on your programming language).
For curl leave the right side of the = blank:
curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/IncomingPhoneNumbers/PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json \
--data-urlencode "EmergencyAddressSid=" \
-u ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_tokenEnable and disable Emergency Calling
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}
Please note that this step must not be combined with the previous one, they must be two separate API calls. You must associate/disassociate and then enable/disable.
Note the EmergencyStatus parameter will change to Pending Activation. This process might take up to 5 minutes.
Note the EmergencyStatus parameter will change to Pending Deactivation. This process may take up to 5 minutes.
Twilio電話番号の緊急通話ステータスを確認する
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}
緊急連絡先を削除する
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses/{AddressSid}
Enable and Disable Emergency Calling on SIP Domain
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{SipDomainSid}
ヘルプが必要ですか？
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.