The Route DID by ANI (Automatic Number Identification) feature allows inbound calls to be routed by the combination of the caller’s phone number (ANI), the callee’s phone number (DNIS), and the domain of the call. One application for this feature is to automatically route repeat calling customers to the same call center agent they had previously for the sake of continuity. To begin this process, you will first need to create a user that will use the Route by ANI logic. Once completed, you will then want to set up DID(s) for ANI-based Routing. After these steps are complete, you can freely add, edit, and delete routes, detailed further in this guide.Please note this article references the SkySwitch Call Center solution available within the PBX Portal, and this feature is further detailed on this page. If you are looking for information about our Contact Center, a completely different service, please instead visit this page for more information.It is important to note that any DID that is enabled for ANI-based routing must be assigned to a dedicated user with a call forwarding answering rule to 'route_by_ani'.Create Route by ANI UserIn order for this feature to work, you MUST create a User that will invoke the Route by ANI Logic. The DID being configured will be routed to this newly created user.Note: The Route by ANI User must have the following characteristics:No device assignedVoicemail is disabledThe Route by ANI User should be dedicated to this feature, and not be used for any other purpose.To begin creating the user from your Reseller Dashmanager menu, select the PBX tab and enter the PBX Portal.Next, select the 'Users' tab at the top of the page and then select the 'Add Users' button found on the far-right hand side of the page.Once selected, complete the form within the menu and select 'Add User' at the bottom of the page.Once the user is created, select the 'Edit' icon to the right of the user and then select 'Answering Rules'.From the Answering Rules tab, click the 'Add Rule' button to the far-right side of the menu and then create a rule that forwards to 'route_by_ani', as seen below (click image to enlarge). Once complete, click the save button at the bottom.Important Note: All DIDs that will have ANI-based routing should be assigned to dedicated users with a Call Forwarding Answering Rule to 'route_by_ani'.Setup DID for ANI-based RoutingTo begin setting up DID(s) for ANI-based Routing from your Reseller Dashmanager menu, navigate to Telco → Phone Numbers.Once you arrive at the Manage Inventory page, search for the DID(s) you wish to set up for ANI-based routing, and then select the 'Signpost' icon to the far right of the number to edit the route.From the Configure Routing menu PBX tab, assign the dedicated user to invoke ANI-based routing and then select 'Apply Routing'.Using the Route By ANI PortalTo access the Route by ANI portal from your Dashmanager menu, navigate to Telco → Route by ANIOnce selected, you will arrive at the Route By ANI portal which allows you to add, remove, or edit routes, in addition to other management functions.Adding RoutesTo add a new route, click the '+ Add Route' button located on the far-right side of the menu.Once selected, you will be asked to provide routing details, as seen below.Note: Attempting to save a route with invalid entries (Commonly not enough digits or includes special characters) will result in an error message. Please review the table below to better understand why this error may be appearing.Important Note: If this is the first time you are setting up the RBA feature for the selected domain, please be sure to open a Support ticket to create a failover route for the domain.The failover route is used when an ANI calls an RBA-configured DID and does not match any existing routes. Failover can be set up so that you can re-route those calls and only one failover route can be set per domain. We are currently working to expose the failover interface for a more convenient experience, but this will need to be requested as a ticket until this is complete.For more information regarding these fields, please refer to the table below. Field NameDescription/Requirement(s)ANIThis field must include an 11-digit number and cannot include special characters (+, @, *, etc.). If the field includes a number less than 11 digits or if it includes special characters, a red box will display around this field and routing cannot be created until it is resolved. This field cannot be left blank.DNISSimilar to the ANI field description above, this field must either include an 11-digit number without special characters or it can be left blank. Note: If the purpose of routing is for all calls from the ANI to be forwarded to a specific destination, please leave this field blank. DomainSelect a domain from the drop-down list.ApplicationThere are three options within this field (User, Device, and Literal); however, most are achievable by selecting either 'User' or 'Device'. User (e.g. 2222): Route to a specific user. Please do not select the RBA user assigned to the DID, as mentioned in the Setup DID for ANI-based Routing section earlier in this guide. Device (e.g. 2222a): Route to a specific device. Literal (e.g. 17477778888): Route to a specific phone number (internal or external). DestinationIf the application is 'User', select a user from the drop-down list. If the application is either 'Device' or 'Literal', enter the appropriate string.Note: If you are unsure how to achieve the desired routing with the options available, please contact support for further assistance. Once the information is entered, click 'Save' at the bottom right of the menu and the newly created route will appear in the route listing.Editing RoutesTo begin editing an existing route from the Route By ANI portal, click on the 'Pencil' edit icon found to the far right of the route you wish to change Once selected, you will be able to edit any details that were entered when the route was first created.Once all changes have been entered, please be sure to click the 'Save' button at the bottom right corner of the menu. Deleting a RouteTo delete an existing route, simply click the 'Trash Can' icon located to the far right of the route you wish to delete. Once you opt to delete a route, you will see a final deletion confirmation prompt, including routing details, as seen below.If you wish to confirm the deletion, click the 'Delete' button. To back out from deleting the route, select 'Cancel' instead. Filtering the TableIf you would like to limit the contents of the table to a specific DNIS and/or specific Domain, this can be achieved by using the filtering options found at the top of the Route By ANI portal. Note: Filtering options will not become available until routes have been configured. Once a route is added, it will be selectable from the filtering drop-down menus. The DNIS and Domain filter drop-down menus will display all DNIS/Domain options currently being used by the routes included in the list on this page. Additionally, there is an ANI search box that can be used to locate a specific number within the list.Note: To search an ANI for all domains, please be sure the DNIS and Domain filtering options are cleared and set to '(empty)'.Downloading/Uploading Routes via CSVTo download a CSV file containing the Route By ANI contents displayed within the Route By ANI portal, select the 'Download CSV' button found on the left-hand side of the page.Note: The CSV file download will contain all entries displayed on the page and will exclude any entries removed by prior filtering. If you would like to download all routes, please be sure to clear all filtering options before selecting 'Download CSV'.To upload a CSV file containing routes, select the 'Upload CSV' button found on the left-hand side of the page.Note: After selecting the upload button, you will be given the option to either download a Sample Template CSV file to populate before submitting or select an existing file to upload.After you have selected a file to upload, you will be able to review the contents. Once the contents are confirmed, select the 'Apply All Actions' button at the top left side of this menu.Note: If you have any difficulty uploading/importing routes, please contact our Support team for further assistance.