Amazon Chime
Administration Guide

Working with Amazon Chime Voice Connectors

You can integrate an Amazon Chime Voice Connector with an existing phone system. Amazon Chime Voice Connectors are limited to three per account by default.

After you create an Amazon Chime Voice Connector, edit the settings to integrate with your existing phone system. Then, assign phone numbers to the Amazon Chime Voice Connector. You can provision phone numbers for your Amazon Chime Voice Connector from your Amazon Chime Phone number management inventory. For more information, see Provisioning Phone Numbers.

You can also create an Amazon Chime Voice Connector group for your account, and add Amazon Chime Voice Connectors to it. You can include Amazon Chime Voice Connectors created in different AWS Regions in your group to create a fault-tolerant mechanism for fallback if availability events occur. For more information, see Working with Amazon Chime Voice Connector Groups.

Before you Begin

To use an Amazon Chime Voice Connector, you must have an IP Private Branch Exchange (PBX), Session Border Controller (SBC), or other voice infrastructure with internet access that supports Session Initiation Protocol (SIP). Make sure to confirm that you have sufficient bandwidth to support peak call volume. For information about bandwidth requirements, see Bandwidth Requirements.

To ensure security for calls sent from AWS to your on-premises phone system, we recommend configuring a SBC between AWS and your phone system. Whitelist SIP traffic to the SBC from the Amazon Chime Voice Connector signaling and media IP addresses. For more information, see the recommended ports and protocols for Amazon Chime Voice Connector.

Amazon Chime Voice Connectors expect phone numbers to be in E.164 format.

Creating an Amazon Chime Voice Connector

Create an Amazon Chime Voice Connector from the Amazon Chime console.

To create an Amazon Chime Voice Connector

  1. Open the Amazon Chime console at https://chime.aws.amazon.com/.

  2. For Calling, choose Voice connectors.

  3. Choose Create new voice connector.

  4. For Voice connector name, enter a name for the Amazon Chime Voice Connector.

  5. (Optional) For AWS Region, choose an AWS Region for your Amazon Chime Voice Connector. The default Region is US East (N. Virginia) (us-east-1). Regions cannot be changed after your Amazon Chime Voice Connector is created.

  6. For Encryption, select Enabled or Disabled.

  7. Choose Create.

Note

Enabling encryption configures your Amazon Chime Voice Connector to use TLS transport for SIP signaling and Secure RTP (SRTP) for media. Inbound calls use TLS transport, and unencrypted outbound calls are blocked.

Editing Amazon Chime Voice Connector Settings

To finish setting up your Amazon Chime Voice Connector, edit the settings from the Amazon Chime console.

Set up your calling plan and caller ID options under the termination settings. You can also specify the IP addresses allowed to make calls using your Amazon Chime Voice Connector, and require credentials for making outbound calls to your Amazon Chime Voice Connector. If no credentials are specified, no authentication is required.

Under the origination settings, configure inbound routes for your SIP hosts to receive inbound calls. Inbound calls are routed to hosts in your SIP infrastructure by the priority and weight you set for each host. Calls are routed in priority order first, with 1 being the highest priority. If hosts are equal in priority, calls are distributed among them based on their relative weight.

Note

Encryption-enabled Voice Connectors use TLS (TCP) protocol for all calls.

You can choose to send logs from your Amazon Chime Voice Connector to CloudWatch Logs. For more information, see CloudWatch Logs for Amazon Chime.

You can also enable media streaming from your Amazon Chime Voice Connector to Amazon Kinesis. For more information, see Streaming Amazon Chime Voice Connector Media to Kinesis.

To edit Amazon Chime Voice Connector settings

  1. Open the Amazon Chime console at https://chime.aws.amazon.com/.

  2. For Calling, choose Voice connectors.

  3. Choose the name of the Amazon Chime Voice Connector to edit.

  4. Edit your settings as follows:

    1. (Optional) Choose General to update the Voice connector name, and enable or disable encryption.

    2. Choose Termination, and select Enabled.

    3. (Optional) For Allowlist, choose New, enter the CIDR notations and values to allowlist, and choose Add.

    4. For Calling plan, select the country or countries to add to your calling plan.

    5. (Optional) For Credentials, choose New, enter a user name and password, and choose Save. Your credentials are updated immediately.

    6. (Optional) For Caller ID, choose Edit, select a caller ID phone number, and choose Save.

    7. Choose Save again.

    8. Choose Origination, and select Enabled.

    9. For Inbound routes, choose New.

    10. Enter the values for Host, Port, Protocol, Priority, and Weight.

    11. Choose Add.

    12. Choose Save.

    13. (Optional) For Streaming, choose Start to send audio to a Kinesis Video Stream, then choose Save.

    14. Choose Phone numbers.

    15. Select one or more phone numbers to assign to the Amazon Chime Voice Connector.

    16. Choose Assign.

    17. (Optional) For Logging, choose Enabled to send logs to CloudWatch Logs, then choose Save.

For more information about assigning phone numbers to an Amazon Chime Voice Connector, see Assigning and Unassigning Amazon Chime Voice Connector Phone Numbers.

Assigning and Unassigning Amazon Chime Voice Connector Phone Numbers

You can assign up to 25 phone numbers to an Amazon Chime Voice Connector.

To assign phone numbers to an Amazon Chime Voice Connector

  1. Open the Amazon Chime console at https://chime.aws.amazon.com/.

  2. For Calling, choose Voice connectors.

  3. Choose the name of the Amazon Chime Voice Connector.

  4. Choose Phone numbers.

  5. Select one or more phone numbers to assign to the Amazon Chime Voice Connector.

  6. Choose Assign.

You can also choose Reassign to reassign phone numbers with the Voice Connector product type from one Amazon Chime Voice Connector or Amazon Chime Voice Connector group to another.

To unassign phone numbers from an Amazon Chime Voice Connector

  1. Open the Amazon Chime console at https://chime.aws.amazon.com/.

  2. For Calling, choose Voice connectors.

  3. Choose the name of the Amazon Chime Voice Connector.

  4. Choose Phone numbers.

  5. Select one or more phone numbers to unassign from the Amazon Chime Voice Connector.

  6. Select Unassign.

  7. Select the check box, and choose Unassign.

Deleting an Amazon Chime Voice Connector

Before you can delete an Amazon Chime Voice Connector, you must unassign all phone numbers from it. For more information on unassigning phone numbers from an Amazon Chime Voice Connector, see the previous topic.

To delete an Amazon Chime Voice Connector

  1. Open the Amazon Chime console at https://chime.aws.amazon.com/.

  2. For Calling, choose Voice connectors.

  3. Choose Phone numbers, Delete voice connector.

  4. Select the check box, and choose Delete.