When creating a custom Alexa skill, you will need to provide an invocation name that users will use to invoke and interact with your skill. The invocation name does not need to be the same as your Voiceflow project's name but it must meet certain criteria to ensure a positive user experience. The invocation name you provide should also easily identify your skill’s capabilities, be memorable and also be accurately recognized by Alexa herself.
Invoking Your Custom Skill
Your service gets called when customers use your invocation name, such as “Alexa, ask dungeon dice for a d20.” In this example, users invoke the Alexa skill by using the Invocation Name ‘dungeon dice’ along with a supported phrase for requesting the service.
You can change your invocation name at any time while developing a skill within the Publish tab in your Voiceflow project. You cannot change the invocation name after a skill is certified and published.
It is also important to think about how the rest of the invocation phrase will sound when using your invocation name. Remember, there are three ways in which users will always invoke your skill. A good invocation name will make sure it works well in all of these contexts:
- Invoking the skill with a particular request. For example, “Alexa, Ask Daily Horoscopes for Gemini.”
- Invoking the skill without a particular request, using a defined phrase such as “open” or “start”. For example, “Alexa, open Daily Horoscopes.”
- Invoking the skill using just the invocation name and nothing else: “Alexa, Daily Horoscopes.”
Here are some additional examples of the supported phrases for requesting an Alexa skill. For a complete list of all launch phrases, see Understanding How Users Invoke Custom Skills.
New Invocation Name Requirements
In order to simplify the process for choosing acceptable invocation names, Alexa team is providing new guidance. You’ll need to meet the following requirements in order to pass certification.
- The skill invocation name must not infringe upon the intellectual property rights of an entity or person.
- One-word invocation names are not allowed, unless the invocation name is unique to your brand/intellectual property.
- Invocation names which are names of people or places (for example, “molly,” “seattle”) are not allowed, unless they contain other words in addition to the name (for example, “molly’s horoscope”).
- Two-word invocation names are not allowed if one of the words is a definite article (“the”), indefinite article (“a,” “an”) or preposition (“for,” “to,” “of”). For example, “a bicycle,” “an espresso,” “to amuse,” “for fun.”
- The invocation name must not contain any of the Alexa skill launch phrases and connecting words. Launch phrase examples include “launch,” “ask,” “tell,” “load,” and “begin.” Connecting word examples include “to,” “from,” “by,” “if,” “and,” “whether.” See Understanding How Users Invoke Custom Skills for a complete list of skill launch phrases and connecting words.
- The invocation name must not contain the wake words “Alexa,” “Amazon,” “Echo,” or the words “skill” or “app.”
- The invocation name must contain only lower-case alphabetic characters, spaces between words, possessive apostrophes (for example, “sam’s science trivia”), or periods used in abbreviations (for example, “a. b. c.”). Other characters like numbers must be spelled out. For example, “twenty one.” The name must be easy to pronounce correctly and be phonetically distinct to avoid being misinterpreted as other similar sounding words.
- The invocation name must not create confusion with existing Alexa features. If your invocation name overlaps with common Alexa commands, users may get confused by Alexa's response and not enable your skill. For example, if your invocation name is too similar to the built-in "weather" command, Alexa may sometimes respond with your skill and sometimes respond with the built-in weather feature, providing an inconsistent user experience.
The following recommendations are not required for certification, but will provide your users with a better experience and are highly recommended:
- The skill invocation name should be specific to the functionality of the skill, unless the invocation name is unique to your brand or intellectual property (for example, “uber,” “dominos”). One way to achieve relevance is to qualify the invocation name with something that describes the skill’s functionality or something relevant to your company or developer name. For example, “boston transit,” “cricket trivia,” “math tutor,” “magic eight ball,” “baby stats,” “tim’s jokes.”
- The invocation name should also fit smoothly with at least one of the Alexa skill launch phrases (for example, “launch,” “ask,” “tell,” “load,” “begin”) to allow customers to naturally invoke the skill.
Finally, plan on spending some time testing your invocation name once you have an initial version of your service up and running. When testing with an Alexa-enabled device, you can see how Alexa interpreted your invocation name by reviewing the history in the Amazon Alexa App (in the app, navigate to Settings and then History).
For more guidance on creating a Custom Skill for Alexa, check out the following additional assets:
Article modified from the original Dave's article (@TheDaveDev)