You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Briefly explain what was added, changed, or removed in the API and why.
20
+
21
+
**Deployment Timing:**
22
+
When are the changes expected to go live?
23
+
24
+
**Breaking Change:**
25
+
Is this a breaking change? If so, what is the impact and how should it be communicated?
26
+
27
+
---
28
+
29
+
## Handoff Checklist
30
+
31
+
-[ ] API changes have been reviewed and approved by the Prime team.
32
+
-[ ] TypeSpec/documentation builds successfully.
33
+
-[ ] Preview looks correct and matches expectations.
34
+
35
+
<details>
36
+
<summary>Additional context (if any of the above items are unchecked)</summary>
37
+
38
+
<!-- Add details here if there are known issues, blockers, or questions related to the docs. -->
39
+
40
+
</details>
41
+
42
+
---
43
+
44
+
## Next Steps
45
+
46
+
-[ ] Prime will monitor this ticket for any follow-up questions or issues.
47
+
-[ ] DevEx can proceed with documentation adjustments, merging, and publishing when ready.
48
+
49
+
<!-- Add any relevant context or expectations around timing, testing, or coordination.
50
+
If documentation should not be merged immediately — for example, if it depends on a specific deployment date or another task being completed first — please include those details here. -->
description: Overview of Toll-Free number verification process.
10
10
---
11
11
12
-
## Toll-Free Number Overview
12
+
import { MdContactPhone } from"react-icons/md";
13
13
14
-
A great alternative to using a Short Code or a 10DLC (local area code) number is a Toll-Free number. Toll-Free US numbers can be used for business messaging to all major US carriers, as well as most major mobile Canadian carriers.
process needs to be completed for all Toll-Free numbers before being permitted
21
-
to send any messages. Pending and unverified numbers are no longer be able to freely send messages.
20
+
Toll-free numbers are a great alternative to messaging with Short Code or 10DLC (local area code) numbers.
21
+
In the US, toll-free numbers can be used for business messaging to all major US carriers, as well as most major mobile Canadian carriers.
22
+
23
+
:::info
22
24
23
-
:::
25
+
All toll-free numbers must be verified prior to sending messages.
24
26
25
-
As a rule of thumb, some [categories of messaging are forbidden](/messaging/getting-started/sms-best-practices-how-to-ensure-message-delivery) on SignalWire. Please take the time to review our list of explicitly prohibited content before submitting your application for Toll-Free, 10DLC, and Short Code.
Submit this form to begin the verification process for a new toll-free number.
37
+
</Card>
38
+
</div>
39
+
40
+
</div>
26
41
27
-
Downstream message filtering is designed to prevent unwanted messaging, fraud, and abuse. Before considering verifying your Toll-Free number, please be sure to follow the [CTIA guidelines and best messaging practices](https://api.ctia.org/wp-content/uploads/2023/05/230523-CTIA-Messaging-Principles-and-Best-Practices-FINAL.pdf).
28
42
29
-
The following standards must be followed for Toll-Free messaging:
43
+
As a rule of thumb, some [categories of messaging are forbidden](/messaging/getting-started/sms-best-practices-how-to-ensure-message-delivery) on SignalWire.
44
+
Please take the time to review our list of explicitly prohibited content before submitting your application for Toll-Free, 10DLC, and Short Code.
30
45
31
-
- Obtain clear opt-in consent from your recipients before sending messages
32
-
- Provide an easy way for your recipients to opt-out of receiving messages
33
-
- Avoid using shortened URLs. It's highly recommended to use a full branded URL as well as URLs that lead back to a legitimate website that contains branding, a privacy policy, terms of service, and contact information. Publicly hosted URL shorteners are forbidden and are guaranteed to cause spam blocks
34
-
- Using multiple Toll-Free numbers to send the same or similar content to bypass throughput limitations is known as **snowshoeing**. This is **highly prohibited** by carriers. If you need to [increase your throughput](https://signalwire.com/products/cloud-messaging/high-throughput-messaging#:~:text=With%20SignalWire%20High-Throughput%20Messaging,with%20Toll-Free%20numbers%20only), it can be approved by our Sales team. If you have a valid use case for using multiple Toll-Free numbers (such as multiple locations all requiring an individual Toll-Free number), this is something we may be able to work out with our carriers.
46
+
Downstream message filtering is designed to prevent unwanted messaging, fraud, and abuse.
47
+
Before considering verifying your Toll-Free number, please be sure to follow the
48
+
[CTIA guidelines and best messaging practices](https://api.ctia.org/wp-content/uploads/2023/05/230523-CTIA-Messaging-Principles-and-Best-Practices-FINAL.pdf).
35
49
36
-
##Get Verified!
50
+
### Requirements
37
51
38
-
### What is Toll-Free Verification?
52
+
The following standards must be followed for Toll-Free messaging:
39
53
40
-
Getting your Toll-Free number verified means that your business and use case has been reviewed and vetted prior to sending messaging via Toll-Free and that your content has received carrier approval.
54
+
-**Obtain clear opt-in consent** from your recipients before sending messages
55
+
-**Enable easy opt-out** for message recipients
56
+
-**Avoid using shortened URLs**
57
+
- It's highly recommended to use a full branded URL as well as URLs that lead back to a legitimate website that contains branding, a privacy policy, terms of service, and contact information.
58
+
Publicly hosted URL shorteners are forbidden and are guaranteed to cause spam blocks.
59
+
- Using multiple Toll-Free numbers to send the same or similar content to bypass throughput limitations is known as **snowshoeing**. This is **highly prohibited** by carriers. If you need to [increase your throughput](https://signalwire.com/products/cloud-messaging/high-throughput-messaging#:~:text=With%20SignalWire%20High-Throughput%20Messaging,with%20Toll-Free%20numbers%20only), it can be approved by our Sales team. If you have a valid use case for using multiple Toll-Free numbers (such as multiple locations all requiring an individual Toll-Free number), this is something we may be able to work out with our carriers.
41
60
42
-
:::info
61
+
## Verification process {#get-verified}
43
62
44
-
Please note that the verification process is free of charge.
63
+
Getting your Toll-Free number verified means that your business and use case has been reviewed and vetted prior to sending messaging via Toll-Free and that your content has received carrier approval.
45
64
46
-
:::
65
+
There is no charge associated with the verification process.
47
66
48
-
Having your Toll-Free numbers verified will greatly reduce the risk of spam filtering on Toll-Free traffic towards all major mobile carriers in the US, as well as most major mobile carriers in Canada, so long as you stick with the content you submitted for verification and continue to follow SignalWire's [messaging best practices](https://signalwire.com/resources/guides/a2p-messaging-use-case-best-practices) and [code of conduct](https://signalwire.com/legal/messaging-code-of-conduct). Deviation from your verification registration can still result in spam filtering. **Verified does not mean whitelisted.**
67
+
Having your Toll-Free numbers verified will greatly reduce the risk of spam filtering on Toll-Free traffic towards all major mobile carriers in the US, as well as most major mobile carriers in Canada.
68
+
Make sure you stick to the content you submitted for verification and continue to follow SignalWire's
69
+
[messaging best practices](https://signalwire.com/resources/guides/a2p-messaging-use-case-best-practices) and
70
+
[code of conduct](https://signalwire.com/legal/messaging-code-of-conduct).
71
+
Deviation from your verification registration can still result in spam filtering. **Verified does not mean whitelisted.**
49
72
50
73
Verification affects messaging to mobile subscribers in the United States as well as Fido, Rogers, Telus, and Videotron in Canada.
51
74
52
75
Note: Other (non-US/Canada) countries do not treat Toll-Free SMS any differently than other international SMS, and you should consult that country's SMS Guidelines page to learn more about compliance considerations for messaging.
53
76
54
77
### Toll-Free Verification Process
55
78
56
-
If you believe you have a valid use case for a Toll-Free number, our Carrier Operations team would be happy to assist you with obtaining a [Toll-Free verification](https://support.signalwire.com/hc/en-us/requests/new?ticket_form_id=13501768371227). Once you fill out this [form](https://support.signalwire.com/hc/en-us/requests/new?ticket_form_id=13501768371227), a ticket will be generated for our Carrier Operations team to process. The turnaround for Toll-Free verification is 3-5 business days.
79
+
If you believe you have a valid use case for a Toll-Free number, our Carrier Operations team would be happy to assist you.
80
+
Once you fill out the [verification form](https://forms.signalwire.me/Toll-Free-Verifications.html),
81
+
a ticket will be generated for our Carrier Operations team to process.
82
+
The turnaround for Toll-Free verification is 3-5 business days.
57
83
58
84
:::caution
59
85
@@ -76,41 +102,64 @@ The form linked above includes the following fields. All of this information is
76
102
77
103
:::info
78
104
79
-
Note: While it is not required to include samples of every different iteration of your messaging content, it is strongly recommended that the message samples you provide represent the majority of the content you plan on sending.
105
+
Note: While it is not required to include samples of every different iteration of your messaging content,
106
+
it is strongly recommended that the message samples you provide represent the majority of the content you plan on sending.
80
107
81
108
:::
82
109
83
110
## FAQs
84
111
85
-
### I have many Toll-Free customers under my account, can I verify in bulk?
112
+
<AccordionGroup>
113
+
114
+
<Accordiontitle="I have many Toll-Free customers under my account, can I verify in bulk?">
115
+
116
+
If you are an ISV, for example, and need to complete verification for multiple customers/multiple numbers, please
117
+
[download this template](https://docs.google.com/spreadsheets/d/1_LXQ1oXjybbB9YbdBQxfHuoBZIdyI2Bg/edit#gid=1315500553)
118
+
and fill out the required information for each number.
119
+
To download, click File > Download > Microsoft Excel (.xlsx).
120
+
Once you're ready to submit, send the form to [email protected] and our Carrier Operations team will be in touch.
121
+
122
+
</Accordion>
123
+
124
+
<Accordiontitle="Is there an API available?">
125
+
126
+
No.
127
+
128
+
</Accordion>
129
+
130
+
<Accordiontitle="Does TCR (The Campaign Registry) process toll-free verifications?">
131
+
132
+
No, TCR is not involved with Toll-Free verifications.
133
+
A specific Toll-Free Aggregator handles Toll-Free messaging for the industry and is unrelated to TCR.
134
+
135
+
</Accordion>
86
136
87
-
If you are an ISV, for example, and need to complete verification for multiple customers/multiple numbers, please [download this template](https://docs.google.com/spreadsheets/d/1_LXQ1oXjybbB9YbdBQxfHuoBZIdyI2Bg/edit#gid=1315500553) and fill out the required information for each number. To download, click File > Download > Microsoft Excel (.xlsx). Once you're ready to submit, send the form to [email protected] and our Carrier Operations team will be in touch with you!
137
+
<Accordiontitle="Why does Canada have stricter requirements?">
88
138
89
-
### Is there an API available?
139
+
Canada is more restrictive because of its anti-spam laws and the policies
140
+
implemented by mobile carriers to meet the law.
90
141
91
-
Currently (as of March 2024), there is no API available for submitting Toll-Free verification requests.
142
+
</Accordion>
92
143
93
-
### Does TCR (The Campaign Registry) process Toll-Free Verifications?
144
+
<Accordiontitle="Is legal language required somewhere on the brand's website about messaging?">
94
145
95
-
No, TCR is not involved with Toll-Free verifications. A specific Toll-Free
96
-
Aggregator handles Toll-Free messaging for the industry and is unrelated to TCR.
146
+
Toll-Free Verification and the downstream provider require legal language to be found somewhere on the brand's website about messaging.
147
+
You will have to provide a link to your company's terms and conditions and your privacy policy.
97
148
98
-
### Why does Canada have stricter requirements?
149
+
</Accordion>
99
150
100
-
Canada is more restrictive because of its anti-spam laws and the policies
101
-
implemented by mobile carriers to meet the law.
151
+
<Accordiontitle="How long does the toll-free verification process take?">
102
152
103
-
### Is legal language required somewhere on the brand's website about messaging?
153
+
It can take up to 2 weeks, from start to finish.
104
154
105
-
Toll-Free Verification and the downstream provider require legal language to be found somewhere on the brand's website about messaging. You will have to provide a link to your
106
-
company's terms and conditions and your privacy policy.
155
+
</Accordion>
107
156
108
-
### How long does it take for the Toll-Free verification process?
157
+
<Accordiontitle="If my Toll-Free number is verified, does that guarantee deliverability?">
109
158
110
-
It can take up to 2 weeks, from start to finish.
159
+
No, your verified Toll-Free number is subject to limited filtering.
160
+
If your content is flagged as spam, that specific content will be blocked,
161
+
but not the Toll-Free number.
111
162
112
-
### If my Toll-Free number is verified, does that guarantee deliverability?
163
+
</Accordion>
113
164
114
-
No, your verified Toll-Free number is subject to limited filtering. If your
115
-
content is flagged as spam, that specific content will be blocked, but not the
0 commit comments