Account Linking Setup
Last updated
Last updated
Assumptions: To complete account linking you need to have set up an account in the Voiceworx and created a skill in the Voiceworx portal. To learn how to set up skills in the Voiceworx platform you can follow this documentation.
Login to Voiceworx portal at https://portal.voiceworx.ai.
On the menu go to Custom Apps -> Manage Apps. Click on the App for which you need to setup Account Linking. If you do not have any apps ready, you can follow this document to create app in VoiceWorx.
After the App has been selected, following screen with all components of the app will display. Click on the Publish tab.
On the publishing tab, Create Publish Profile (if not already created), fill out other details and click the Enable Account Linking check box and click save. As the Note says, “When this option is selected, it is still required to configure account linking in Alexa”, there are few additional steps we need to configure in Alexa developer console.
Before heading to Alexa developer console, save this publish profile and publish to Alexa. You can again follow this document for assistance in publishing to Alexa.
Go to https://developer.amazon.com and login with the same Amazon Account the app has been published to in step 5. Click on Developer Console.
On the resulting screen, Click on "Login with Amazon".
Login with Amazon Console page would open in a new tab. Click the “Create a New Security Profile” button.
Fill all the required fields in the Security Profile Management page and click the Save button.
Security Profile is successfully created. Click the gear icon and click on web settings
In the web settings page, fill the following fields as shown below and click the “Save” button.
Allowed Origins -
Allowed Return URLs
Note the Client ID and Client Secret from Step 11 for later use.
Go https://developer.amazon.com/alexa/console/ask and select the skill that needs account linking
Select Models tab
Click on the Account Linking Tab
In the resulting page enable account linking by clicking the “Do you allow users to create an account or link to an existing account with you?” toggle
Set Auth Grant as the authorization type and fill in the following.
Your Web Authorization URI: https://www.amazon.com/ap/oa
Access Token URI: https://api.amazon.com/auth/o2/token
Your Client ID: This is the client Id shown in the security profile created in step 10 above. Example- amzn1.application-oa2-client.2ec922f2fbfa435433892
Your Secret: Click on show secret in the Security Profile page as shown in step 10. Copy and paste the secret here
Your Authentication Scheme: Http Basic
Scope: Click on add new Scope and type in “profile”
Domain List: channeltest.voiceworx.ai, channel.voiceworx.ai
Default Token Expiration Time : 80420
Alexa Redirect URLs:
https://alexa.amazon.co.jp/api/skill/link/M278T3HJB37YPD
https://pitangui.amazon.com/api/skill/link/M278T3HJB37YPD
https://layla.amazon.com/api/skill/link/M278T3HJB37YPD
Note: You also need to add these Redirect URLs to your Allowed Return URLs in your Amazon Security Profile.
Scroll up and click save.
Go to http://alexa.amazon.com/, login and click on Skills
On the Skills page, click on the Your Skills button
Search the name of the skill you want to enable account linking on. Select the skill.
Click on Enable Skill
This will open the Login with Amazon page. Insert your username and password and press login
If your login details are correct, you will be presented with a success screen.
You can now try invoking the skill from your Alexa device and Alexa developer console.