Managing Amazon Chime SDK Voice Connector groups

How an Amazon Chime SDK Voice Connector group works

Voice Connector groups only handle inbound PSTN calls to your SIP based phone system. The groups provide fault-tolerant, cross-region call routing. A Voice Connector group contains two or more Voice Connectors, and can include Voice Connectors created in different AWS Regions. This allows incoming PSTN calls to fail over across AWS Regions if availability events affect service in one region.

For example, say that you create a Voice Connector group and assign two Voice Connectors to it, one in the US East (N. Virginia) Region, and the other in the US West (Oregon) Region. You configure both Voice Connectors with origination settings that point to your SIP host(s).

Now say that a call comes in to the Voice Connector in the US East (N. Virginia) Region. If that Region has a connectivity issue, the call automatically reroutes to the Voice Connector in 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.