Routers Tab: Gradual Traffic Assignment

Introduction

The Routers tab is accessible via your OCP → Integrations → Numbers.

This tab allows you to create routers that will assign your traffic gradually from one application to another. This can be particularly useful for testing, transitioning between applications, or handling exceptional cases where staggered deployment is necessary.

Routers for gradual traffic assignment can be created for miniApps, flows, application tags, SND, and PRD applications. Below, you will find detailed instructions on how to set up and effectively manage routers for gradual traffic assignments.

Navigation and layout

Before exploring the features of the Routers tab, here are some basic navigation tips to help you make the most of its functionalities.

Search filters

The search filters enable you to quickly locate specific routers without the need for endless scrolling.

• Search here: Locate a specific router swiftly by entering the corresponding phone number.

• Groups: Narrow down your search by selecting a group from the drop-down menu.

• Router status: Filter routers based on their current status. You can choose from the following options: Running, Inactive, Confirmation Pending.

• Progress: Identify routers based on their progress status. The available options include: Not started, In Progress, Completed.

Create Router

To create a new router, follow the steps below:

1. Click the Create Route button.

2. In the dialog window that opens, fill in the fields as described below:

• Number: Select a phone number from the drop-down list. You can only select one phone number at a time. The following fields below will be filled in automatically based on the selected number.

  • Number Group: The group the number is initially attached to.

  • Source Application: The application to which the number is initially attached.

  • Version Tag: The tag of the source application if applicable.

  • Application Group: The group the application is assigned to.

• Target application:

  • Application Name: Select a new application from the drop-down list to which the phone number will be attached.

  • Tag Version: Optionally select a tag of the new application to attach the phone number to. It allows to distribute calls between several versions of the same application.

  • Group: The group of the target application that will be set automatically based on your previous selection.

• Percentage: The percentage value of the step that increments the amount of traffic transferred from the source application to the target application. Allowed values are 1-100.

3. Click Create to finalize the process. The router for traffic transferring is now created and it will appear in the routers list.

Transfer traffic

Now that your router is set up, you can begin gradually shifting traffic from one application to another. To transfer traffic, follow these steps:

1. Navigate to the router you intend to use for traffic transfer.

2. The Traffic Usage progress bar indicates the number of steps required to fully transfer traffic from the source application to the target application. This number is determined by your router's step settings. For example, in the image above, four steps are required. You can modify the step settings at any time if needed.

3. Click on Go to Next Step. This action will start transferring a part of the traffic to the target application. Initially, 30% of the traffic will be transferred, as indicated by a solid blue section on the progress bar.

3. When you are ready to transfer more traffic, continue by clicking Go to Next Step. Repeat this step until the Traffic Usage progress bar reaches 100%, fully transferring all traffic to the target application.

4. Once the Traffic Usage bar indicates 100% completion, the router’s status will change to CONFIRMATION PENDING. To finalize the traffic transfer, click the Finish Routing button.

5. A dialog box will appear. In the dialog box, click Confirm to complete the process.

Upon confirmation, the router will be deleted, and all traffic will be routed to the target application.

Edit steps

The step setting dictates what portion of traffic will be transferred from the source application to the target application at each step. You may occasionally need to adjust this step setting to better suit your needs. Follow these steps to modify the traffic transfer step:

1. Navigate to the specific router you intend to edit and click Options menu → Edit steps.

2. In the dialog window that appears, modify the traffic usage step to your desired percentage value.

3. Click Update to finalize. The traffic usage step is now updated, and future traffic transfers will follow this new increment setting.

Router status

The status of a router provides important information about its current operational state. Here are the possible statuses for a router:

• Running: Indicates that the router is either prepared to transfer traffic or is currently in the process of transferring traffic between applications.

• Inactive: Indicates that the router has been temporarily disabled and the traffic transfer has been paused. Once re-enabled, the router will switch back to the Running status and continue its traffic transfer operations.

• Confirmation Pending: Signifies that the router has successfully processed the traffic transfer and is awaiting your confirmation to complete the process. Once confirmation is provided, the router will be deleted, and 100% of the traffic will be directed to the target application.

Disable a router

To disable a router, proceed as follows:

1. Navigate to the router you wish to disable and click Options menu → Disable.

2. A confirmation message will appear in the top right corner of your screen, and the router status will update to INACTIVE.

The selected router is now disabled. If you need to reactivate it in the future, you can do so by following the instructions below.

Enable a router

To enable a router, proceed as follows:

1. Navigate to the router you wish to enable and click Options menu → Enable.

2. A confirmation message will appear in the top right corner of your screen, and the router status will update to RUNNING.

The router is now enabled and is ready to resume its traffic transferring functions.

Delete a router

To delete a router, follow the steps below:

1. Navigate to the router you wish to delete and click Options menu → Delete.

2. In the dialog box that opens, type CONFIRM DELETE to confirm the deletion.

Once the router is deleted, all traffic will automatically revert to the previous application. Please ensure that you review and confirm your settings before proceeding with this action.

3. Click the Delete button to finalize the deletion. The router will be deleted.