Alexa Account Linking

Learn how to use account linking with Alexa and Jovo.

Account linking enables you to connect your Alexa Skill users to other systems. In the Alexa Skill, users can sign in to an external account and grant the Skill the permission to access profile information. You can also learn more in the official Alexa documentation on account linking.

To prompt your Alexa Skill users to link their accounts, you can send a LinkAccountCard to their mobile Alexa app. Learn more in the official Alexa docs.

To show the card, you can use the LinkAccountCardOutput:

import { LinkAccountCardOutput } from '@jovotech/platform-alexa';
// ...

someHandler() {
  // ...

  return this.$send(LinkAccountCardOutput, {
    message: 'Please link your account in the Alexa app.',
  });
}

Under the hood, the LinkAccountCardOutput looks like this:

{
  message: this.options.message,
  listen: false,
  platforms: {
    alexa: {
      nativeResponse: {
        response: {
          card: {
            type: 'LinkAccount'
          }
        }
      }
    }
  }
}

After the user successfully linked their account, you can access the access token like this:

this.$alexa.$user.accessToken;

This access token can then be used to make API calls to your system and retrieve user specific information.