SIP integration using an Amazon Chime Voice Connector - Amazon Chime

SIP integration using an Amazon Chime Voice Connector

Integrate your SIP-compatible voice infrastructure with an Amazon Chime Voice Connector to make SIP voice calls. 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). For more information, see Before you begin in the Amazon Chime Administrator Guide.

To integrate your voice infrastructure with an Amazon Chime Voice Connector

  1. Create an Amazon Chime Voice Connector under your AWS account. For more information, see Creating an Amazon Chime Voice Connector in the Amazon Chime Administrator Guide.

  2. Edit your Amazon Chime Voice Connector settings to allow calling from your voice infrastructure to AWS. For more information, see Editing Amazon Chime Voice Connector settings in the Amazon Chime Administrator Guide.

    1. For Termination settings, select Enabled.

    2. For Allowlist, choose New.

    3. Enter the CIDR notations of the IP addresses for your internal SIP infrastructure. This allows your infrastructure to access the Amazon Chime Voice Connector. For example, to allow traffic from IP address 10.24.34.0, allowlist the CIDR notation 10.24.34.0/32.

    4. Choose Add.

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

    6. Edit any other settings as needed, and choose Save.

  3. In the Amazon Chime console, under Voice connectors, view the Outbound host name for your Amazon Chime Voice Connector. For example, abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws.

  4. To join a meeting using the Amazon Chime SDK, use a SIP URI to make a SIP request to the Outbound host name of your Amazon Chime Voice Connector. Use phone number +17035550122 in the SIP URI. Set the transport parameter to use the TLS protocol. Finally, use the unique join token generated by calling the CreateAttendee API action. For more information, see the following example.

Example: SIP request

The following example shows the contents of a SIP URI used to make a SIP request to an Amazon Chime Voice Connector.

sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token

The following example shows a sample SIP INVITE message to join an Amazon Chime SDK meeting.

INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: <sip:+12065550100@IPaddress:54321;transport=TLS;ob> Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE
Note

Amazon Chime recognizes phone numbers only in E.164 format. Make sure that an E.164 phone number is in your From header.