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.

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 Telephony, choose Voice Connector.

  3. Choose Create new voice connector.

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

  5. For Encryption, select Enabled or Disabled.

  6. 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.

To edit Amazon Chime Voice Connector settings

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

  2. For Telephony, choose Voice Connector.

  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 settings, 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 settings, 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. Choose Phone numbers.

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

    15. Choose Assign.

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 Telephony, choose Voice Connector.

  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.

To unassign phone numbers from an Amazon Chime Voice Connector

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

  2. For Telephony, choose Voice Connector.

  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 Telephony, choose Voice Connector.

  3. Choose Phone numbers, Delete voice connector.

  4. Select the check box, and choose Delete.