Skip to content
This repository has been archived by the owner on Mar 8, 2019. It is now read-only.

Latest commit

 

History

History
128 lines (78 loc) · 11.5 KB

File metadata and controls

128 lines (78 loc) · 11.5 KB

Build An Alexa Calendar Reader Skill

Voice User InterfaceLambda FunctionConnect VUI to CodeTestingCustomizationPublication

Get Your Skill Certified and Published

We are almost done! The last step is to add the metadata that your skill will use in the Alexa app. This page will walk you through the remaining steps, and give you some tips on how to avoid the common mistakes developers make that result in a failed certification.

  1. Go to your skill's Publishing Information tab on the Amazon Developer Portal.

  2. Complete the Global Fields data. These fields apply across all of the languges that your skill supports.

    • For Category, we are building a calendar reader, so select "Games, Trivia, and Accessories." You will also be presented with a Sub-Category option. For this skill, choose "Knowledge and Trivia."

    • Provide testing instructions. Testing instructions give you an opportunity to explain your skill, and any special or possibly confusing features, to the certification team. A value is required in this box.

      • Since you are using our calendar reader Sample, make sure to add this sentence to your Testing Instructions:

        This was built using the calendar reader Sample.
        

        This will let the testing team understand what you're providing them, and should decrease the testing time required.

    • Countries and Region can be for "all countries", unless you have a specific reason to exclude a specific location. This gives Amazon the ability to distribute your skill globally. Remember that you will need to create additional versions of your skill in the other available languages before they will be available in those countries.

  3. Write your skill descriptions.

    • Spend some time coming up with an enticing, succinct description. This is one of the few places you have an opportunity to attract new users, so make the most of it! These descriptions show up in the list of skills available in the Alexa app.
  4. For your example phrases, come up with the three most exciting ways a user can talk to your skill.

    • Make sure that each of your example phrases are a perfect match with one of your Sample Utterances. Incorrect example phrases are one of the most common reasons that skills fail certification, so we have provided a short list of things to consider as you write your example phrases:

      Common Failure Points for Example Phrases
      Example phrases must adhere to the supported phrases.
      Example phrases must be based on sample utterances specified in your Intent Schema.
      Your first example phrase must include a wake word and your invocation name.
      Example phrases must provide a contextual response.
    • Choose three example phrases that are likely to be the most common ways that users will attempt to interact with your skill. Make sure that each of them works well, and provides an excellent user experience.

  5. Provide a comprehensive list of keywords for users that are searching for new skills. This is an optional field, and searching the Alexa app will also find the words in your Skill Name and descriptions, so you don't need to overdo it. That being said, if there are words that you want users to find your skill with, you should include them here. Separate the keywords with commas.

  6. Create your skill's icons. You need two sizes of your icon: 108x108px and 512x512px.

    • Make sure you have the rights to the icons you create. Please don't violate any trademarks or copyrights.

    • If you don't have software to make icons, try one of these free options:

    • To make it easier to get started, we've created blank versions of these icons in both sizes for many formats:

  7. Open the Privacy & Compliance tab on the left side of your skill in the Developer Portal.

  8. Answer each of the Global Fields questions using the guidance below. These fields also apply across all of the languages that your skill supports.

    • Does this skill allow users to make purchases or spend real money? For this calendar reader, the answer is no. For future skills, make sure you answer this appropriately.

    • Does this Alexa skill collect users' personal information? Again, for this calendar reader, the answer is no. If you do collect information about a user, such as names, email addresses, phone numbers, and so forth, ensure that you answer Yes to this question.

      • Answering "yes" to this question will also require you to provide a link to your Privacy Policy at the bottom of the page.
    • Is your skill directed to children under the age of 13? Because you customized this skill with data you provided, it is possible that you created a skill that targets children under the age of 13. For the Calendar Reader, the answer is no because it doesn't target a specific age group.

      • Factors to consider in determining if this skill is directed to children under 13 include:

        • Subject matter of the skill
        • Presence of child-oriented activities and incentives
        • Type of language used in the skill
        • Music and other audio content in the skill
        • How the skill is described and marketed
        • Intended audience for the skill

        If you're not sure, please see the FTC's COPPA Guidance and FAQ for more information.

  9. Export Compliance. Be certain that you agree with all of the conditions. If you do, make sure to check this box, as Amazon requires this permission to distribute your skill around the globe.

  10. Privacy Policy URL. This is an optional field, and should not be required for this calendar reader skill sample. You can leave it blank.

  11. Terms of Use URL. This is also optional, and you can leave it blank.

  12. Click the Save button at the bottom of the page.

  13. Each checkmark should be green, as shown.

  14. If you feel that your skill is ready for certification, click the "Submit for Certification" button at the bottom of the page.

  15. You're done with your submission! Here are a few things you might need to know: