Caller ID Number (CID) is a service that displays your phone number to the phone of the individual you are calling on an outbound call. Telnyx upholds a strict policy around the handling of Caller ID Numbers for outbound calls.
All outbound calls with Caller ID Numbers that are not valid will be rejected with a SIP response code of “403 Invalid Caller ID Number”.
Supported Number Formats:
- If the Connection’s Localization Country is set then the following formats will be accepted:
a. National format of the country selected (i.e. Localization Country: USA, Number: 3129457420)
b. +E.164 format (i.e. +13129457420)
2. If the Connection’s Localization Country is not set then the following formats will be accepted:
a. +E.164 format (i.e. U.K. number: +441234567890)
b. E.164 format (i.e. U.K. number: 441234567890)
c. National format will only work if it is a U.S or U.K nationally formatted number
3. If the Connection’s Caller ID Override is set and used for an outbound call
Send any format if you setup override in your Connection's Outbound settings.
How Telnyx handles the Caller ID Number:
- The Localization Country can be set through the Telnyx Mission Control Portal under the Connection's Outbound Settings
- If a Connection does not have a Localization Country and the number appears to be invalid then Telnyx will attempt to validate the number using USA and UK as the Localization Country
- If the previous check failed then Telnyx will attempt to validate the number by adding the + sign to it
Which headers from the SIP INVITE can carry the Caller ID Number?
Below listed is the following SIP headers that are accepted for Caller ID, ordered by priority (1 highest and 4 lowest priority)
1. P-Preferred-Identity User
2. P-Asserted-Identity User
3. Remote-Party-Id User
4. FROM User
In the case that more than one header is provided the highest priority header is followed.
How to anonymize Caller ID Number
The following SIP headers need to be provided to anonymize a call:
P-Asserted-Identity: "Caller ID Name"<sip:Caller ID Number@sip.telnyx.com>
A valid caller ID must be provided in the placeholder but the caller ID will be anonymized downstream as the Privacy: id is present.