Skip to content

Commit e042961

Browse files
committed
docs(e911): sembr
1 parent 76738b6 commit e042961

1 file changed

Lines changed: 68 additions & 41 deletions

File tree

  • fern/products/platform/pages/platform/phone-numbers

fern/products/platform/pages/platform/phone-numbers/e911.mdx

Lines changed: 68 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -8,31 +8,42 @@ max-toc-depth: 3
88

99
**E911, or Enhanced 911,** is a support system for wireless and VoIP phone users who dial 911,
1010
the standard number for requesting help in an emergency across supported countries.
11-
Because a VoIP number isn't tied to a physical line, you register a street address for the number ahead of time.
12-
When someone dials 911 from that number, the call is routed to the dispatch center serving the registered
13-
address, and that address is displayed to the dispatcher.
14-
15-
E911 on SignalWire is self-service: create an emergency address, assign it to a phone number,
16-
and the number is provisioned for emergency calling. You can manage everything from the
17-
[Dashboard](#set-up-e911-in-the-dashboard) or the [REST API](#set-up-e911-with-the-rest-api).
11+
Because a VoIP number isn't tied to a physical line,
12+
you register a street address for the number ahead of time.
13+
When someone dials 911 from that number,
14+
the call is routed to the dispatch center serving the registered address,
15+
and that address is displayed to the dispatcher.
16+
17+
E911 on SignalWire is self-service:
18+
create an emergency address, assign it to a phone number,
19+
and the number is provisioned for emergency calling.
20+
You can manage everything from the [Dashboard](#set-up-e911-in-the-dashboard)
21+
or the [REST API](#set-up-e911-with-the-rest-api).
1822

1923
<Warning title="911 calls from unregistered numbers">
20-
Calling 911 from a number with no E911 address still connects, but the call routes to the
21-
national emergency call center, where operators must determine your location before help can be
22-
dispatched — delaying response. Each of these calls also incurs a $100 fee. Register an address
23-
before an emergency, and always dial 933, not 911, to
24-
[test your configuration](#test-your-e911-configuration).
24+
25+
Calling 911 from a number with no E911 address still connects,
26+
but the call routes to the national emergency call center,
27+
where operators must determine your location before help can be dispatched
28+
— delaying response.
29+
Each of these calls also incurs a $100 fee.
30+
Register an address before an emergency,
31+
and always dial 933, not 911, to [test your configuration](#test-your-e911-configuration).
32+
2533
</Warning>
2634

2735
## How it works
2836

29-
Emergency addresses live in your Space as a reusable collection, so one address can serve many phone numbers.
30-
When you create an address with emergency service enabled, it is validated against the carrier's emergency
31-
database, and small errors are corrected automatically.
37+
Emergency addresses live in your Space as a reusable collection,
38+
so one address can serve many phone numbers.
39+
When you create an address with emergency service enabled,
40+
it is validated against the carrier's emergency database,
41+
and small errors are corrected automatically.
3242

3343
Assigning a validated address to a phone number starts provisioning at the carrier.
34-
Provisioning is asynchronous: the number's E911 status starts as `pending` and becomes `active`
35-
once the carrier confirms. The address's label is presented to the dispatcher as the caller name,
44+
Provisioning is asynchronous:
45+
the number's E911 status starts as `pending` and becomes `active` once the carrier confirms.
46+
The address's label is presented to the dispatcher as the caller name,
3647
so use a label that identifies the caller or location clearly.
3748

3849
## Set up E911 with the REST API
@@ -41,60 +52,76 @@ First, create an address with `emergency_enabled` set to `true`:
4152

4253
<EndpointRequestSnippet endpoint="POST /api/relay/rest/addresses" />
4354

44-
If the carrier can't validate the address, the request fails with a `422` response listing the
45-
problems and, when available, suggested corrections in a `candidates` array.
55+
If the carrier can't validate the address,
56+
the request fails with a `422` response listing the problems
57+
and, when available, suggested corrections in a `candidates` array.
4658

4759
Next, assign the address to a phone number:
4860

4961
<EndpointRequestSnippet endpoint="POST /api/relay/rest/phone_numbers/{id}/e911_address" />
5062

51-
The phone number's `e911_status` field tracks provisioning; the number is ready for emergency
52-
calling once it reads `active`. To disable E911 on the number, send a `DELETE` request to the
53-
same endpoint.
63+
The phone number's `e911_status` field tracks provisioning;
64+
the number is ready for emergency calling once it reads `active`.
65+
To disable E911 on the number,
66+
send a `DELETE` request to the same endpoint.
5467

55-
For all operations and full request and response details, see the
56-
[E911 Addresses](/docs/apis/rest/e-911-addresses/list-addresses) reference.
68+
For all operations and full request and response details,
69+
see the [E911 Addresses](/docs/apis/rest/e-911-addresses/list-addresses) reference.
5770

5871
<Info title="Compatibility API">
59-
If you manage numbers with the Compatibility API, you can attach an existing emergency address by
60-
setting `EmergencyAddressSid` when
61-
[updating an incoming phone number](/docs/compatibility-api/rest/incoming-phone-numbers/update-incoming-phone-number).
72+
73+
If you manage numbers with the Compatibility API,
74+
you can attach an existing emergency address by setting `EmergencyAddressSid`
75+
when [updating an incoming phone number](/docs/compatibility-api/rest/incoming-phone-numbers/update-incoming-phone-number).
76+
6277
</Info>
6378

6479
## Set up E911 in the Dashboard
6580

66-
Open the **Phone Numbers** section of your Dashboard and select the **E911** tab to create and
67-
manage emergency addresses. To assign an address, open a phone number's detail page and set its
68-
emergency address there. The same validation and provisioning process applies, and the number's
69-
E911 status is shown alongside the assignment.
81+
Open the **Phone Numbers** section of your Dashboard
82+
and select the **E911** tab to create and manage emergency addresses.
83+
To assign an address,
84+
open a phone number's detail page and set its emergency address there.
85+
The same validation and provisioning process applies,
86+
and the number's E911 status is shown alongside the assignment.
7087

7188
## Test your E911 configuration
7289

7390
There is a proper way to test E911 for your SignalWire number.
74-
It's best to arrange a test call to 911 services and verify the E911 information pops up on their screen correctly.
75-
You can call your local 911 center non-emergency number, and notify them you're testing a VoIP system for the correct display of location information.
76-
You should be able to get the non-emergency phone number from local law enforcement or an internet search. All 911 centers have a non-emergency number for testing purposes.
91+
It's best to arrange a test call to 911 services
92+
and verify the E911 information pops up on their screen correctly.
93+
You can call your local 911 center non-emergency number,
94+
and notify them you're testing a VoIP system for the correct display of location information.
95+
You should be able to get the non-emergency phone number from local law enforcement or an internet search.
96+
All 911 centers have a non-emergency number for testing purposes.
7797

7898
<Info>
7999

80100
["How do I place a "test" call to make sure 911 works for me?"](https://www.911.gov/frequently_asked_questions.html)
81101

82-
"Test calls confirm that your local 911 service can receive your 911 call and has the correct location information.
102+
"Test calls confirm that your local 911 service can receive your 911 call
103+
and has the correct location information.
83104
Test calls can be scheduled by contacting your local 911 call center via its non-emergency phone number.
84-
To contact the local 911 center responsible for answering calls from your location, go
85-
[here](https://www.nasna911.org/contact-911) and click on the state in which you are located.
86-
The person responsible for operating the state’s 911 system will be identified, and they should know who you should talk to at your local 911 call center, to schedule a day and time for test calls."
105+
To contact the local 911 center responsible for answering calls from your location,
106+
go [here](https://www.nasna911.org/contact-911) and click on the state in which you are located.
107+
The person responsible for operating the state’s 911 system will be identified,
108+
and they should know who you should talk to at your local 911 call center,
109+
to schedule a day and time for test calls."
87110

88111
</Info>
89112

90-
Once you've assigned an emergency address to your number, follow these steps to verify it:
113+
Once you've assigned an emergency address to your number,
114+
follow these steps to verify it:
91115

92116
1. Wait for the number's E911 status to become `active`.
93117
2. Do a test call to 933 first, and listen to your E911 info playback.
94118
_If you hear the automated information, you're ready to do a real test.
95119
If you hear an error tone, wait a little longer, then try again._
96120
3. Call your local police department's non-emergency number.
97121
Let them know you're making a VoIP test call to verify location information.
98-
4. Once you've notified your local emergency center of an incoming test call, make the real call to 911 and verify your address displays correctly with the answering personnel.
122+
4. Once you've notified your local emergency center of an incoming test call,
123+
make the real call to 911
124+
and verify your address displays correctly with the answering personnel.
99125

100-
Provided all the information displays correctly, your verification process for E911 services is complete.
126+
Provided all the information displays correctly,
127+
your verification process for E911 services is complete.

0 commit comments

Comments
 (0)