Enabling Amazon Chime SDK Alexa skill calling - Amazon Chime SDK

Enabling Amazon Chime SDK Alexa skill calling

If you create Alexa Skills, you can enable calling directly from those Skills by using the StartCommunicationSession API. To enable calling, you must do the following:

  • Use the Alexa Developer Console to find the Skill's client ID.

  • Use the Amazon Chime SDK console to enable skill calling for at least one SIP media application.

  • Use the Alexa Developer Console again to enable the Communication - Calling permission for the Skill.

The following topics explain how to complete those tasks. Follow them in the order listed. After you complete them, see Using Amazon Chime SDK Alexa skill calling in the Amazon Chime SDK Developer Guide for information about adding skill calling to your Alexa Skill.

To integrate your Alexa Skill with an Amazon Chime SDK SIP media application, you first need to find the Skill's client ID.

Note

Alexa Skills have skill IDs and client IDs. For these steps, you only use the client ID.

To find a Skill's client ID

  1. In the Alexa Developer Console, choose the desired Skill.

  2. Choose Tools and then Permission.

  3. At the bottom of the page, choose Timers to enable the Timers permission, and then choose Timers to disable the Timers permission.

    The client ID appears at the bottom of the Permission page. The ID has a prefix of amzn1.application-oa2-client followed by a string of characters. For example, amzn1.application-oa2-client.ad213256-e602-4756-9534-cc3b76b670b4.

  4. Copy that ID and go to the next steps.

After you find your skill's client ID, you use it to integrate the skill with a SIP media application.

To integrate Alexa with a SIP media application

  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 SIP media applications.

  3. Select the SIP media application that you want to integrate.

  4. Choose the Alexa Skill Configuration tab.

  5. Under Alexa Skill Status, choose the Enabled button.

  6. Under Alexa Skill Client ID, enter the ID from the previous steps.

  7. Choose Save.

After you integrate your Skill with a SIP media application, you use the Alexa Developer Console to enable the Communication - Calling permission for the Skill. By default, that permission only appears after you integrate a Skill with a SIP media application. Once you do that, the Communication - Calling permission appears at the bottom of the Permission page in the Alexa Developer Console.

After you enable the permission, the Skill prompts users for their consent to make a call.

To enable the permission

  1. In the Alexa Developer Console, choose the desired Skill.

  2. Choose Tools and then Permission.

  3. At the bottom of the page, move the Communication - Calling slider to the on position.