Alexa (Optional)

Once cloud side configurations for Alexa skills are done, you can go on to do configurations on Alexa developer console.

Integrating the Alexa Smart Home Skills with RainMaker

Configuring the Alexa Developer Console

• Log in to Alexa developer console.
• Select the skill created in the section Create an Alexa Smart Home Skill.

Smart Home

---

• Click SMART HOME in the left navigation bar.
• In the Smart Home service endpoint section, add the ARNs of the esp-RM-alexaSmarthome Lambda mentioned in the next section.

Getting the Lambda ARNs for the deployed Alexa Skill

• Select all three check boxes for all three regions.

• For North America, add the ARN of the Lambda present in us-east-1 AWS region.

• For Europe, India, add the ARN of the Lambda present in eu-west-1 AWS region.

• For Far East, add the ARN of the Lambda present in us-west-1 region.

• Copy the value from the North America endpoint into the Default endpoint and click Save.

  

Locales

---

• Click the language and locales dropdown list at the top of the left navigation bar.

  

• Add the languages and locales as per the target audience location of the skill.

  

Account Linking

---

• Click ACCOUNT LINKING in the left navigation bar.

• Add the following information to link RainMaker Authentication to Alexa.

  Standard RainMaker vs OAuth-only RainMaker

  For Standard RainMaker

  • The domain name from the section Creating the AWS Cognito App Clients for Alexa and Google Voice Assistant will be used to construct the Authentication URLs.

    • Authorization URI: <domain-url>/oauth2/authorize
    • Token URI: <domain-url>/oauth2/token
    • Scope: aws.cognito.signin.user.admin

  ---

  For OAuth-only RainMaker

  • Authorization URI: Follow these steps to get the URL
  • Token URI: <HTTP API Endpoint>/token

• Add the client ID and client secret of the Alexa app client by following the steps in Where do I find the Client ID and Callback URLs for Alexa and GVA? into Your Client ID and Your Secret fields, then click Save.

  

Enabling the Skill in Alexa Phone App

• Download the Amazon Alexa App from Google Play Store or IOS Store.

• Go to Skills & Games in the Settings or More tab in the app.

  

• Go to the Your Skills tab and scroll the below list to the left and click Dev.

• Click your skill in Development and hit ENABLE TO USE, you will be redirected to a RainMaker Login.

  

• Add the RainMaker phone app credentials. The devices in the RainMaker phone app will be discovered in the Alexa App.

Beta Testing

Click Distribution and complete the information for all language variants, then click Availability. The Beta Test option would appear.