Create a Quick Link for Your Custom Skill
You can generate an Alexa Quick Link to take your customers to your custom skill on their Alexa device. Quick links are standard URLs. You can provide them to your customers via your website, mobile app, social media, or email.
Customers can click your Quick Link and either:
- Instantly launch your skill on their Echo device, or
- Ask for an Alexa notification to be sent to their Echo device, allowing them to launch the skill whenever they are near the device.
Quick link availability and requirements
While you can publish Alexa Quick Links anywhere, the corresponding skills can only be launched on the following devices, in the following locales:
- Devices: Customers can use Quick Links to launch skills on these devices: Echo (all versions), Echo Tap, Echo Dot (all versions), Echo Show (all versions), Echo Spot
- Locales: Custom skills that are built for
Your skill must meet the following requirements:
- It must be live (certified and published).
- It must be a custom skill.
- Child-directed skills and HIPAA skills aren't eligible to use Quick Links.
Generate a Quick Link for your skill
The URL for a custom skill's Quick Link has the following syntax:
To Generate a Quick Link for your live custom skill
- Locate the
- Navigate to the Alexa developer console.
- Log in if necessary.
- In the Skills tab, click the View Skill ID link under the skill name.
- Use the syntax provided above and replace
<skill-id>with the skill ID that you just located. Your Quick Link is now ready!
Customer experience on the Alexa Quick Links web page
An Alexa Quick Link leads customers to the Alexa Quick Links web page in a browser, on a computer or mobile device. There customers can sign in to their Amazon Alexa account to retrieve information about your skill, the list of devices they own, and other information such as ratings and availability of in-skill purchases.
After they sign in and review your skill information, the customer can choose to launch your skill in either of two ways: launch from the web or launch via Alexa notification.
Option 1: Launch from the web
Customers who are already near an Alexa device, and are willing to try your skill, can choose to instantly launch your skill on their Alexa device. The Alexa Quick Links web page shows customers a list of supported Alexa devices that they own. Customers can click one of these devices to have your skill launch on it and start engaging with your skill immediately.
Option 2: Launch via Alexa notification
Customers can click this option to send a notification to their Alexa devices that enables them to launch your skill when they are near an Alexa device. When an Alexa notification is sent, customers see a yellow light on devices without screens and an on-screen banner on devices with screens indicating that they have new notifications. Once customers send a notification to their Alexa device for your skill link, they can say Alexa, what's my notification?, to which Alexa will respond with You have one skill to try - <Skill Name>. Would you like to open it?. Customers can say yes to have Alexa respond with Here's <Skill Name> launched from the web and launch your skill.
If your skill requires mandatory account linking, customers will be able to link their accounts to Alexa after they launch your skill using either of the preceding options. For example, if a customer launches your skill via an Alexa notification, they see the Account Linking flow for your skill immediately. Once account linking is completed, the customer sees a confirmation that Alexa sent a notification to their device.
If your skill supports account linking but does not require it, customers will not encounter the account linking flow when using your Quick Link to launch your skill.
For more information about account linking, see Understand Account Linking for Alexa Skills.
If you display an Alexa Quick Link in your mobile app, the customer needs to enter their credentials for your app again during the account linking process, even if they are already logged in to your app. For example, if a customer is signed in to your mobile app, and they click a Quick Link, they are taken to the Quick Links web page, where they are redirected to the Account Linking flow (if it is required for your skill). Here, they will need to enter credentials for your service again, since they are no longer in your mobile app. In order to reduce this friction, you can instead surface the app-to-app account linking feature to your customers on your mobile app, and then redirect the customer to your Alexa Quick Link as the last step of your app-to-app account linking flow.
View analytics for your skill
Using the developer console, you can view the number of skill launches you drove through Quick Links.
If you want to track the number of skill launches coming from individual links surfaced in different online channels, you will need to use custom tasks in your skill in combination with query string parameters in the Quick Link URL. For example, you may want to understand which online channel is driving the most traffic to your skill's Quick Link among your website, mobile app, social media page and paid ads. You can do this by using a query string attribution parameter and passing it to your skill through a custom task input parameter. Read more about how to create a Quick Link for a custom task, and how to use an attribution parameter in your Quick Link and custom task.
If your skill doesn't need inputs and you want the query string attribution input parameter hidden, use the
a2z_ref input parameter. See Add campaign attribution to your traffic analytics.