Skip to content

Latest commit

 

History

History
133 lines (106 loc) · 4.26 KB

PSTNRESOURCES.MD

File metadata and controls

133 lines (106 loc) · 4.26 KB

Usage

Amazon Chime SDK PSTN Resources Example

This example includes

Amazon Chime SDK PSTN resources

Phone Number Creation

const phoneNumber = new chime.ChimePhoneNumber(this, 'phoneNumber', {
  phoneState: 'IL',
  phoneNumberType: chime.PhoneNumberType.LOCAL,
  phoneProductType: chime.PhoneProductType.SMA,
});

The phone number created will be a LOCAL number for use with SMA from a pool of available numbers in Illinois. Other search option are available that will return a single phone number based on the criteria provided.

SIP Media Application Creation

const sipMediaApp = new chime.ChimeSipMediaApp(this, 'sipMediaApp', {
  region: this.region,
  endpoint: smaHandler.functionArn,
});

The SIP media application created will use the smaHandler referenced by the endpoint in the same region the AWS CDK is being deployed in. The SIP media application must be created in the same region as the associated Lambda endpoint and must be in us-east-1 or us-west-2.

SIP Media Application Rule Creation

const sipRule = new chime.ChimeSipRule(this, 'sipRule', {
  triggerType: chime.TriggerType.TO_PHONE_NUMBER,
  triggerValue: phoneNumber.phoneNumber,
  targetApplications: [
    {
      region: this.region,
      priority: 1,
      sipMediaApplicationId: sipMediaApp.sipMediaAppId,
    },
  ],
});

The SIP rule will associate the previously created phone number with the previously created SIP media application. The SIP rule can be associated with either an E.164 number or Amazon Chime SDK Voice Connector URI. If the TriggerType is TO_PHONE_NUMBER, the TriggerValue must be an E.164 number. If the TriggerType is REQUEST_URI_HOSTNAME, the TriggerValue must be an Amazon Chime SDK Voice Connector URI. A priority must be assigned with a value between 1 and 25 inclusive. A targetApplication is required. This will associate the trigger to the SIP media application and associated Lambda.

Amazon Chime SDK Voice Connector Resources Example

This example includes

Voice Connector Phone Number Creation

const voiceConnectorPhone = new chime.ChimePhoneNumber(
  this,
  'voiceConnectorPhoneNumber',
  {
    phoneState: 'IL',
    phoneCountry: chime.PhoneCountry.US,
    phoneProductType: chime.PhoneProductType.VC,
    phoneNumberType: chime.PhoneNumberType.LOCAL,
  },
);

Voice Connector Creation

const voiceConnector = new chime.ChimeVoiceConnector(this, 'voiceConnector', {
  encryption: true,
  name: 'string',
  region: 'us-east-1',
  termination: {
    terminationCidrs: ['198.51.100.10/32'],
    callingRegions: ['US'],
  },
  origination: [
    {
      host: '198.51.100.10',
      port: 5061,
      protocol: chime.Protocol.TCP,
      priority: 1,
      weight: 1,
    },
  ],
  streaming: {
    enabled: true,
    dataRetention: 0,
    notificationTargets: [chime.NotificationTargetType.EVENTBRIDGE],
  },
});

This will create an Amazon Chime SDK Voice Connector with specified options. Termination, origination, and streaming are all optional.

Phone Number Association

voiceConnectorPhone.associateWithVoiceConnector(voiceConnector);

This will associate the previously created phone number with the voice connector.

Voice Profile Domain

const voiceProfileDomainKey = new Key(this, 'voiceProfileDomainKey', {
  enableKeyRotation: true,
  keySpec: KeySpec.SYMMETRIC_DEFAULT,
  enabled: true,
});

const voiceProfileDomain = new ChimeVoiceProfileDomain(
  this,
  'voiceProfileDomain',
  {
    serverSideEncryptionConfiguration: {
      kmsKeyArn: voiceProfileDomainKey.keyArn,
    },
  },
);