article

Taira@Amazon avatar image
Taira@Amazon posted

Tips for a Successful Alexa Skill Certification: Card and Account Linking

If your skill requires account linking and a customer has not yet linked an account, your skill will need to deliver a LinkAccount card to their Alexa App so that they can complete this step via that card. Please note that your skill should also inform the customer that the LinkAccount card was delivered to the Alexa App/Activity page so that customer can complete account linking to access the functionality.

Situation: A customer has not yet linked an account.

Good Example
Customer: Open Space Facts.
Alexa: Welcome to the Space Facts skill. To be able to use the skill, you have to link it to your Space Facts user account. Please go to the Alexa App and sign in with your Space Facts login under settings. A Link Account card was delivered to your Alexa App.


Bad Example
Customer: Alexa, open Space Facts.
Alexa: Welcome to the Space Facts skill. To be able to use the skill, you have to link it to your Space Facts user account.


In the bad example above, the skill does not inform the user where to navigate to in order to link their account.

In addition to these requirements, please also make sure that “Link Account” appears in the Card.


To do this, you should set the “type” in your code to LinkAccount. Here is a good example of a skill’s JSON response regarding “LinkAccount”:


{
    "version": "1.0",
    "response": {
        "outputSpeech": {
            "type": "PlainText",
            "text": "Welcome to the Space Facts skill. To be able to use the skill you have to link it to your Space Facts user account. Please go to the Alexa App and sign in with your Space Facts login under settings. Link Account card was delivered to your Alexa app"
        },
        "card": {
            "type": "LinkAccount"
        }
    }
}



For more details, please refer to the document here:
https://developer.amazon.com/en-US/docs/alexa/custom-skills/include-a-card-in-your-skills-response.html#define-a-card-for-use-with-account-linking

account linkingcertificationhomecard
10 |3000 characters needed characters left characters exceeded

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Article

Contributors

Taira@Amazo contributed to this article