Introduction
The Inbound Routes feature allows service providers to create routing rules based on the dialed (DID) number.
Setup
LATA
The LATA of the LRN of the called number. This must match the Called LRN LATA field in the SIP Messages page.
SPID
The porting-corrected OCN of the called number. This must match the Called LRN SPID field in the SIP Messages page.
Prefix
A route can be matched to a prefix for a dialed number, or the prefix field can be left blank for the route to apply to any calling number. For Inbound Routes, the prefix refers to the dialed number regardless of whether the number has been ported.
Route Destinations
Routes are created by configuring groups of destinations. A destination must be either an IP address or a hostname followed by an optional port and optional tags. A destination may also refer to a specific trunk ID to route through a specific trunk group. Users can configure destinations based on priority (primary, secondary, tertiary) in case of failover.
Within each destination priority level, users can list multiple possible destinations separated by a comma to evenly distribute traffic.
Destinations per Route
Users can configure the Destinations per Route number to control the route failover order. The Destinations per Route number tells ClearIP how many routes from each route destination priority level to return in the Contact header.
If the Destinations per Route is 1, then ClearIP returns one destination from the Primary Route Destinations, one destination from the Secondary Route Destinations, and one destination from the Tertiary Route Destinations. ClearIP returns 3 routes in the Contact header in the order described. The destination is selected randomly from the available route destinations in each destination priority level. For outbound routing, this means that after the first routing failure at the preferred provider, the route should failover to the backup provider.
If the Destinations per Route is 2, then ClearIP returns two destinations from the Primary Route Destinations, two destinations from the Secondary Route Destinations, and two destinations from the Tertiary Route Destinations. ClearIP returns 6 routes in the Contact header in the order described. For outbound routing, this means that after the first routing failure at the preferred provider, the route should failover to another destination at the preferred provider before trying the backup provider.
If the Destinations per Route value is equal to or greater than the number of destinations in any particular destination priority level, then all listed destinations for that destination priority level are returned in the Contact header.
Examples
Route inbound calls to specific switch
If ClearIP is integrated to receive inbound calls from an SBC (or proxy) and the SBC must send the call to one of many switches, then ClearIP can be used to return a SIP 302 to direct the SBC to route certain inbound calls to a specific switch.
In this example, one switch with IP address 1.1.1.1 provides service for 3 phone numbers, and another switch with IP address 2.2.2.2 provides service for 3 other phone numbers. An Inbound Route is created for each individual phone number to define the correct switch to which the SBC should route the call.
We did not restrict these routes to apply to the Inbound Service Provider that typically defines calls received from external carriers. The above example is intended to apply to both 1) calls that originate on a switch within your network and terminate on a different switch in your network without being sent to an external carrier and 2) calls that are received from trunks with your origination carriers.
How ClearIP processes calls in Inbound Routing
Exact order of priority of inbound routing rules
LATA | SPID | Prefix | SBC | Service Provider | Group | User | Calling Country | Calling Number |
---|---|---|---|---|---|---|---|---|
12345 | 1234 | 11234567890 | 13210987654 | |||||
12345 | 1234 | 1123456789 | 13210987654 | |||||
12345 | 1234 | 112345678 | 13210987654 | |||||
12345 | 1234 | 11234567 | 13210987654 | |||||
12345 | 1234 | 1123456 | 13210987654 | |||||
12345 | 1234 | 112345 | 13210987654 | |||||
12345 | 1234 | 11234 | 13210987654 | |||||
12345 | 1234 | 1123 | 13210987654 | |||||
12345 | 1234 | 112 | 13210987654 | |||||
12345 | 1234 | 11 | 13210987654 | |||||
12345 | 1234 | 1 | 13210987654 | |||||
12345 | 1234 | 13210987654 | ||||||
1234 | 11234567890 | 13210987654 | ||||||
1234 | 1123456789 | 13210987654 | ||||||
1234 | 112345678 | 13210987654 | ||||||
1234 | 11234567 | 13210987654 | ||||||
1234 | 1123456 | 13210987654 | ||||||
1234 | 112345 | 13210987654 | ||||||
1234 | 11234 | 13210987654 | ||||||
1234 | 1123 | 13210987654 | ||||||
1234 | 112 | 13210987654 | ||||||
1234 | 11 | 13210987654 | ||||||
1234 | 1 | 13210987654 | ||||||
1234 | 13210987654 | |||||||
12345 | 11234567890 | 13210987654 | ||||||
12345 | 1123456789 | 13210987654 | ||||||
12345 | 112345678 | 13210987654 | ||||||
12345 | 11234567 | 13210987654 | ||||||
12345 | 1123456 | 13210987654 | ||||||
12345 | 112345 | 13210987654 | ||||||
12345 | 11234 | 13210987654 | ||||||
12345 | 1123 | 13210987654 | ||||||
12345 | 112 | 13210987654 | ||||||
12345 | 11 | 13210987654 | ||||||
12345 | 1 | 13210987654 | ||||||
12345 | 13210987654 | |||||||
11234567890 | 13210987654 | |||||||
1123456789 | 13210987654 | |||||||
112345678 | 13210987654 | |||||||
11234567 | 13210987654 | |||||||
1123456 | 13210987654 | |||||||
112345 | 13210987654 | |||||||
11234 | 13210987654 | |||||||
1123 | 13210987654 | |||||||
112 | 13210987654 | |||||||
11 | 13210987654 | |||||||
1 | 13210987654 | |||||||
13210987654 | ||||||||
12345 | 1234 | 11234567890 | United States | |||||
12345 | 1234 | 1123456789 | United States | |||||
12345 | 1234 | 112345678 | United States | |||||
12345 | 1234 | 11234567 | United States | |||||
12345 | 1234 | 1123456 | United States | |||||
12345 | 1234 | 112345 | United States | |||||
12345 | 1234 | 11234 | United States | |||||
12345 | 1234 | 1123 | United States | |||||
12345 | 1234 | 112 | United States | |||||
12345 | 1234 | 11 | United States | |||||
12345 | 1234 | 1 | United States | |||||
12345 | 1234 | United States | ||||||
1234 | 11234567890 | United States | ||||||
1234 | 1123456789 | United States | ||||||
1234 | 112345678 | United States | ||||||
1234 | 11234567 | United States | ||||||
1234 | 1123456 | United States | ||||||
1234 | 112345 | United States | ||||||
1234 | 11234 | United States | ||||||
1234 | 1123 | United States | ||||||
1234 | 112 | United States | ||||||
1234 | 11 | United States | ||||||
1234 | 1 | United States | ||||||
1234 | United States | |||||||
12345 | 11234567890 | United States | ||||||
12345 | 1123456789 | United States | ||||||
12345 | 112345678 | United States | ||||||
12345 | 11234567 | United States | ||||||
12345 | 1123456 | United States | ||||||
12345 | 112345 | United States | ||||||
12345 | 11234 | United States | ||||||
12345 | 1123 | United States | ||||||
12345 | 112 | United States | ||||||
12345 | 11 | United States | ||||||
12345 | 1 | United States | ||||||
12345 | United States | |||||||
11234567890 | United States | |||||||
1123456789 | United States | |||||||
112345678 | United States | |||||||
11234567 | United States | |||||||
1123456 | United States | |||||||
112345 | United States | |||||||
11234 | United States | |||||||
1123 | United States | |||||||
112 | United States | |||||||
11 | United States | |||||||
1 | United States | |||||||
United States | ||||||||
12345 | 1234 | 11234567890 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 1123456789 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 112345678 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 11234567 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 1123456 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 112345 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 11234 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 1123 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 112 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 11 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | 1 | Example Service Provider | Example Group | Example User | |||
12345 | 1234 | Example Service Provider | Example Group | Example User | ||||
1234 | 11234567890 | Example Service Provider | Example Group | Example User | ||||
1234 | 1123456789 | Example Service Provider | Example Group | Example User | ||||
1234 | 112345678 | Example Service Provider | Example Group | Example User | ||||
1234 | 11234567 | Example Service Provider | Example Group | Example User | ||||
1234 | 1123456 | Example Service Provider | Example Group | Example User | ||||
1234 | 112345 | Example Service Provider | Example Group | Example User | ||||
1234 | 11234 | Example Service Provider | Example Group | Example User | ||||
1234 | 1123 | Example Service Provider | Example Group | Example User | ||||
1234 | 112 | Example Service Provider | Example Group | Example User | ||||
1234 | 11 | Example Service Provider | Example Group | Example User | ||||
1234 | 1 | Example Service Provider | Example Group | Example User | ||||
1234 | Example Service Provider | Example Group | Example User | |||||
12345 | 11234567890 | Example Service Provider | Example Group | Example User | ||||
12345 | 1123456789 | Example Service Provider | Example Group | Example User | ||||
12345 | 112345678 | Example Service Provider | Example Group | Example User | ||||
12345 | 11234567 | Example Service Provider | Example Group | Example User | ||||
12345 | 1123456 | Example Service Provider | Example Group | Example User | ||||
12345 | 112345 | Example Service Provider | Example Group | Example User | ||||
12345 | 11234 | Example Service Provider | Example Group | Example User | ||||
12345 | 1123 | Example Service Provider | Example Group | Example User | ||||
12345 | 112 | Example Service Provider | Example Group | Example User | ||||
12345 | 11 | Example Service Provider | Example Group | Example User | ||||
12345 | 1 | Example Service Provider | Example Group | Example User | ||||
12345 | Example Service Provider | Example Group | Example User | |||||
11234567890 | Example Service Provider | Example Group | Example User | |||||
1123456789 | Example Service Provider | Example Group | Example User | |||||
112345678 | Example Service Provider | Example Group | Example User | |||||
11234567 | Example Service Provider | Example Group | Example User | |||||
1123456 | Example Service Provider | Example Group | Example User | |||||
112345 | Example Service Provider | Example Group | Example User | |||||
11234 | Example Service Provider | Example Group | Example User | |||||
1123 | Example Service Provider | Example Group | Example User | |||||
112 | Example Service Provider | Example Group | Example User | |||||
11 | Example Service Provider | Example Group | Example User | |||||
1 | Example Service Provider | Example Group | Example User | |||||
Example Service Provider | Example Group | Example User | ||||||
12345 | 1234 | 11234567890 | Example Service Provider | Example Group | ||||
12345 | 1234 | 1123456789 | Example Service Provider | Example Group | ||||
12345 | 1234 | 112345678 | Example Service Provider | Example Group | ||||
12345 | 1234 | 11234567 | Example Service Provider | Example Group | ||||
12345 | 1234 | 1123456 | Example Service Provider | Example Group | ||||
12345 | 1234 | 112345 | Example Service Provider | Example Group | ||||
12345 | 1234 | 11234 | Example Service Provider | Example Group | ||||
12345 | 1234 | 1123 | Example Service Provider | Example Group | ||||
12345 | 1234 | 112 | Example Service Provider | Example Group | ||||
12345 | 1234 | 11 | Example Service Provider | Example Group | ||||
12345 | 1234 | 1 | Example Service Provider | Example Group | ||||
12345 | 1234 | Example Service Provider | Example Group | |||||
1234 | 11234567890 | Example Service Provider | Example Group | |||||
1234 | 1123456789 | Example Service Provider | Example Group | |||||
1234 | 112345678 | Example Service Provider | Example Group | |||||
1234 | 11234567 | Example Service Provider | Example Group | |||||
1234 | 1123456 | Example Service Provider | Example Group | |||||
1234 | 112345 | Example Service Provider | Example Group | |||||
1234 | 11234 | Example Service Provider | Example Group | |||||
1234 | 1123 | Example Service Provider | Example Group | |||||
1234 | 112 | Example Service Provider | Example Group | |||||
1234 | 11 | Example Service Provider | Example Group | |||||
1234 | 1 | Example Service Provider | Example Group | |||||
1234 | Example Service Provider | Example Group | ||||||
12345 | 11234567890 | Example Service Provider | Example Group | |||||
12345 | 1123456789 | Example Service Provider | Example Group | |||||
12345 | 112345678 | Example Service Provider | Example Group | |||||
12345 | 11234567 | Example Service Provider | Example Group | |||||
12345 | 1123456 | Example Service Provider | Example Group | |||||
12345 | 112345 | Example Service Provider | Example Group | |||||
12345 | 11234 | Example Service Provider | Example Group | |||||
12345 | 1123 | Example Service Provider | Example Group | |||||
12345 | 112 | Example Service Provider | Example Group | |||||
12345 | 11 | Example Service Provider | Example Group | |||||
12345 | 1 | Example Service Provider | Example Group | |||||
12345 | Example Service Provider | Example Group | ||||||
11234567890 | Example Service Provider | Example Group | ||||||
1123456789 | Example Service Provider | Example Group | ||||||
112345678 | Example Service Provider | Example Group | ||||||
11234567 | Example Service Provider | Example Group | ||||||
1123456 | Example Service Provider | Example Group | ||||||
112345 | Example Service Provider | Example Group | ||||||
11234 | Example Service Provider | Example Group | ||||||
1123 | Example Service Provider | Example Group | ||||||
112 | Example Service Provider | Example Group | ||||||
11 | Example Service Provider | Example Group | ||||||
1 | Example Service Provider | Example Group | ||||||
Example Service Provider | Example Group | |||||||
12345 | 1234 | 11234567890 | Example Service Provider | |||||
12345 | 1234 | 1123456789 | Example Service Provider | |||||
12345 | 1234 | 112345678 | Example Service Provider | |||||
12345 | 1234 | 11234567 | Example Service Provider | |||||
12345 | 1234 | 1123456 | Example Service Provider | |||||
12345 | 1234 | 112345 | Example Service Provider | |||||
12345 | 1234 | 11234 | Example Service Provider | |||||
12345 | 1234 | 1123 | Example Service Provider | |||||
12345 | 1234 | 112 | Example Service Provider | |||||
12345 | 1234 | 11 | Example Service Provider | |||||
12345 | 1234 | 1 | Example Service Provider | |||||
12345 | 1234 | Example Service Provider | ||||||
1234 | 11234567890 | Example Service Provider | ||||||
1234 | 1123456789 | Example Service Provider | ||||||
1234 | 112345678 | Example Service Provider | ||||||
1234 | 11234567 | Example Service Provider | ||||||
1234 | 1123456 | Example Service Provider | ||||||
1234 | 112345 | Example Service Provider | ||||||
1234 | 11234 | Example Service Provider | ||||||
1234 | 1123 | Example Service Provider | ||||||
1234 | 112 | Example Service Provider | ||||||
1234 | 11 | Example Service Provider | ||||||
1234 | 1 | Example Service Provider | ||||||
1234 | Example Service Provider | |||||||
12345 | 11234567890 | Example Service Provider | ||||||
12345 | 1123456789 | Example Service Provider | ||||||
12345 | 112345678 | Example Service Provider | ||||||
12345 | 11234567 | Example Service Provider | ||||||
12345 | 1123456 | Example Service Provider | ||||||
12345 | 112345 | Example Service Provider | ||||||
12345 | 11234 | Example Service Provider | ||||||
12345 | 1123 | Example Service Provider | ||||||
12345 | 112 | Example Service Provider | ||||||
12345 | 11 | Example Service Provider | ||||||
12345 | 1 | Example Service Provider | ||||||
12345 | Example Service Provider | |||||||
11234567890 | Example Service Provider | |||||||
1123456789 | Example Service Provider | |||||||
112345678 | Example Service Provider | |||||||
11234567 | Example Service Provider | |||||||
1123456 | Example Service Provider | |||||||
112345 | Example Service Provider | |||||||
11234 | Example Service Provider | |||||||
1123 | Example Service Provider | |||||||
112 | Example Service Provider | |||||||
11 | Example Service Provider | |||||||
1 | Example Service Provider | |||||||
Example Service Provider | ||||||||
12345 | 1234 | 11234567890 | Example SBC | |||||
12345 | 1234 | 1123456789 | Example SBC | |||||
12345 | 1234 | 112345678 | Example SBC | |||||
12345 | 1234 | 11234567 | Example SBC | |||||
12345 | 1234 | 1123456 | Example SBC | |||||
12345 | 1234 | 112345 | Example SBC | |||||
12345 | 1234 | 11234 | Example SBC | |||||
12345 | 1234 | 1123 | Example SBC | |||||
12345 | 1234 | 112 | Example SBC | |||||
12345 | 1234 | 11 | Example SBC | |||||
12345 | 1234 | 1 | Example SBC | |||||
12345 | 1234 | Example SBC | ||||||
1234 | 11234567890 | Example SBC | ||||||
1234 | 1123456789 | Example SBC | ||||||
1234 | 112345678 | Example SBC | ||||||
1234 | 11234567 | Example SBC | ||||||
1234 | 1123456 | Example SBC | ||||||
1234 | 112345 | Example SBC | ||||||
1234 | 11234 | Example SBC | ||||||
1234 | 1123 | Example SBC | ||||||
1234 | 112 | Example SBC | ||||||
1234 | 11 | Example SBC | ||||||
1234 | 1 | Example SBC | ||||||
1234 | Example SBC | |||||||
12345 | 11234567890 | Example SBC | ||||||
12345 | 1123456789 | Example SBC | ||||||
12345 | 112345678 | Example SBC | ||||||
12345 | 11234567 | Example SBC | ||||||
12345 | 1123456 | Example SBC | ||||||
12345 | 112345 | Example SBC | ||||||
12345 | 11234 | Example SBC | ||||||
12345 | 1123 | Example SBC | ||||||
12345 | 112 | Example SBC | ||||||
12345 | 11 | Example SBC | ||||||
12345 | 1 | Example SBC | ||||||
12345 | Example SBC | |||||||
11234567890 | Example SBC | |||||||
1123456789 | Example SBC | |||||||
112345678 | Example SBC | |||||||
11234567 | Example SBC | |||||||
1123456 | Example SBC | |||||||
112345 | Example SBC | |||||||
11234 | Example SBC | |||||||
1123 | Example SBC | |||||||
112 | Example SBC | |||||||
11 | Example SBC | |||||||
1 | Example SBC | |||||||
Example SBC | ||||||||
12345 | 1234 | 11234567890 | ||||||
12345 | 1234 | 1123456789 | ||||||
12345 | 1234 | 112345678 | ||||||
12345 | 1234 | 11234567 | ||||||
12345 | 1234 | 1123456 | ||||||
12345 | 1234 | 112345 | ||||||
12345 | 1234 | 11234 | ||||||
12345 | 1234 | 1123 | ||||||
12345 | 1234 | 112 | ||||||
12345 | 1234 | 11 | ||||||
12345 | 1234 | 1 | ||||||
12345 | 1234 | |||||||
1234 | 11234567890 | |||||||
1234 | 1123456789 | |||||||
1234 | 112345678 | |||||||
1234 | 11234567 | |||||||
1234 | 1123456 | |||||||
1234 | 112345 | |||||||
1234 | 11234 | |||||||
1234 | 1123 | |||||||
1234 | 112 | |||||||
1234 | 11 | |||||||
1234 | 1 | |||||||
1234 | ||||||||
12345 | 11234567890 | |||||||
12345 | 1123456789 | |||||||
12345 | 112345678 | |||||||
12345 | 11234567 | |||||||
12345 | 1123456 | |||||||
12345 | 112345 | |||||||
12345 | 11234 | |||||||
12345 | 1123 | |||||||
12345 | 112 | |||||||
12345 | 11 | |||||||
12345 | 1 | |||||||
12345 | ||||||||
11234567890 | ||||||||
1123456789 | ||||||||
112345678 | ||||||||
11234567 | ||||||||
1123456 | ||||||||
112345 | ||||||||
11234 | ||||||||
1123 | ||||||||
112 | ||||||||
11 | ||||||||
1 | ||||||||