This section is responsible for user account linking with an Alexa Skill. Account linking with an Alexa Skill is a good way to reach more customers.

The state when account linking is disabled or is going to be disabled

The state when account linking is enabled or is going to be enabled

 

Steps to configure Account Linking for an Alexa Skill:

• Enable Account Linking – Enable Account Linking for the selected Alexa Skill
• Skip Account Linking on Skill Enablement – Should the user be forced to link the account before the skill can be enabled?
• Your Web Authorization URI – The URI where customers will be redirected in the companion app to enter login credentials
• Access Token URI – This URI will be used for both access token and token refresh requests
• Your Client ID – Unique public string used to identify the client requesting for authentication
• Your Secret – A credential you provide that lets the Alexa service authenticate with the Access Token URI. This is combined with the Client ID to identify the request as coming from Alexa
• Scope – The list of permissions to request from the skill user. You can provide up to 15 scopes. Separate list items with a semicolon (;)
• Domain List – The list of domains that the authorization URL will fetch content from. You can provide up to 30 domains. Separate list items with a semicolon (;)

 

Account Linking Examples

Link Amazon User Accounts with your Alexa Skill

• Values that are required to be set in Amazon Alexa Skill Account Linking Section
  • Your Web Authorization URI – https://www.amazon.com/ap/oa
  • Access Token URI – https://api.amazon.com/auth/o2/token
  • Your Client ID – from your security profile
  • Your Secret – from your security profile
  • Scope – scope for LWA is required and can be all of these below:
    • profile
    • profile:user_id
    • postal_code
• Action required to be taken on your Amazon Security Profile
  • Copy the Alexa Redirect URLs from [Alexa Developer Console] > [tools] > [account linking] > [Alexa Redirect URLs]
  • Add all of the Alexa Redirect URLs to [your security profile] > [Allowed Return URLs]  in [Alexa Developer Console] > [click on your user icon] > [settings] > [Login with Amazon] > [Security Profiles] > [Select Your Security Profile from list] > [Web Settings] > [Allowed Return URLs]

Link Convoworks Admin Accounts with your Alexa Skill

• Values that are required to be set in Amazon Alexa Skill Account Linking Section
  • Your Web Authorization URI – https://proto.convoworks.com/login/amazon or https://proto-stage.convoworks.com/login/amazon
  • Access Token URI – https://proto.convoworks.com/rest_public/proto/v1/token/amazon or https://proto-stage.convoworks.com/rest_public/proto/v1/token/amazon

Link other User Accounts with your Alexa Skill

• Values that are required to be set in Amazon Alexa Skill Account Linking Section
  • Your Web Authorization URI – https://www.example.com/login
  • Access Token URI – https://api.example.com/auth/o2/token
  • Your Client ID – your client id, if you have it
  • Your Secret – your client secret, if you have it
  • Scope – scopes if they are required for your oauth service