Managing Amazon Chime SDK Voice Connector groups

How an Amazon Chime SDK Voice Connector group works

Voice Connector groups contain multiple Voice Connectors, and you can add Voice Connectors that are created in different AWS Regions. This allows incoming calls to fail over across Regions, which creates a fault-tolerant mechanism for fallback in case of availability events.

For example, an Voice Connector group is created with two Voice Connectors assigned to it. One Voice Connector is in the US East (N. Virginia) Region, and the other Voice Connector is in the US West (Oregon) Region.

An incoming call is placed to a phone number associated with the Voice Connector in the US East (N. Virginia) Region. However, there is a connectivity issue in that Region, so the call is then routed through the US West (Oregon) Region.

Get started with an Amazon Chime SDK Voice Connector group

To get started, first create Voice Connectors in different AWS Regions. Then, create a Voice Connector group and assign the Voice Connectors to it. You can also provision phone numbers for your Voice Connector group from your Amazon Chime SDK Phone number management inventory. For more information, see Provisioning phone numbers. For more information about creating Amazon Chime SDK Voice Connectors in different AWS Regions, see Managing Amazon Chime SDK Voice Connectors.

Creating an Amazon Chime SDK Voice Connector group

You can create up to three Amazon Chime SDK Voice Connector groups for your account.

To create a group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose Create group.

4. In the dialog box that appears, under Voice connector group name, enter a name for the group.

5. Choose Create.

Editing an Amazon Chime SDK Voice Connector group

After you create an Amazon Chime SDK Voice Connector group, you can add or remove Amazon Chime SDK Voice Connectors for it. You can also edit the priority for the Voice Connectors in the group.

To add Voice Connectors to a group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose the name of the Voice Connector group that you want to edit.

4. Choose the Voice connectors tab, open the Actions list, then choose Add.

5. In the dialog box that appears, select the checkbox next to the Voice Connector that you want to use.

6. Choose Add.

7. Repeat steps 4 through 6 to add Voice Connectors to the group.

To edit Voice Connector priority in a group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose the name of the Amazon Chime SDK Voice Connector group that you want to edit.

4. Under Actions, choose Edit priority.

5. In the dialog box that appears, enter a different priority ranking for each Voice Connector. 1 is the highest priority. Higher priority Voice Connectors are attempted first.

6. Choose Save.

To remove Voice Connectors from a group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose the name of the Voice Connector group that you want to edit.

4. Open the Actions list and choose Remove.

5. In the dialog box that appears, select the check boxes next to the Voice Connectors that you want to remove.

6. Choose Remove.

Assigning and unassigning phone numbers to a Voice Connector group

You use the Amazon Chime SDK console to assign and unassign phone numbers to a Voice Connector group.

To assign phone numbers to a Voice Connector group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose the name of the Voice Connector group to edit.

4. Choose Phone numbers.

5. Choose Assign from inventory.

6. Select one or more phone numbers to assign to the Voice Connector group.

7. Choose Assign from inventory.

You can also choose Reassign to reassign phone numbers with the Voice Connector product type. This lets you reassign these numbers from one Voice Connector or Voice Connector group to another.

To unassign phone numbers from a Voice Connector group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose the name of the Voice Connector group to edit.

4. Choose Phone numbers.

5. Select the phone numbers that you want from the Voice Connector group, and choose Unassign.

6. Choose Unassign.

Deleting an Amazon Chime SDK Voice Connector group

Before you can delete an Amazon Chime SDK Voice Connector group, you must unassign all Amazon Chime SDK Voice Connectors and phone numbers from it. For more information, see the previous section.

To delete a Voice Connector group

1. Open the Amazon Chime SDK console at https://console.aws.amazon.com/chime-sdk/home.

2. In the navigation pane, under SIP Trunking, choose Voice connectors.

3. Choose the name of the Voice Connector group to delete.

4. Choose Delete group.

5. Select the check box, and choose Delete.