Create a Quick Link for Your Custom Skill
You can generate Quick Links for Alexa 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 that an Alexa notification 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 Quick Links for Alexa 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), and 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 Health Insurance Portability and Accountability Act (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 previously and replace
<skill-id>with the skill ID that you just located.
Your quick link is now ready.
Customer experience on the Quick Links for Alexa web page
A quick link leads customers to the Quick Links for Alexa web page in a browser, on a computer, or on a 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, customers can choose to launch your skill in either of two ways: from the web or via an Alexa notification.
Option 1: Launch from the web
Customers who are near an Alexa device and want to try your skill can choose to instantly launch your skill on their Alexa device. The Quick Links for Alexa 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 the device. Then, customers can immediately start to interact with your skill.
Option 2: Launch an 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 Alexa sends a notification, customers see a yellow light on devices without screens and an on-screen banner on devices with screens showing that they have a new notification. After customers send a notification to their Alexa device for your skill link, they can say, "Alexa, what's my notification?". Alexa responds 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 then launch your skill.
Account linking with quick links
If your skill requires mandatory account linking, customers can link their accounts to Alexa after they launch your skill by using either of the preceding options. For example, if a customer launches your skill via an Alexa notification, they immediately see the account linking flow for your skill. After the customer completes account linking, they see a confirmation that Alexa sent a notification to their device.
If your skill supports account linking but doesn't require it, customers don't encounter the account linking flow when they use your quick link to launch your skill.
For details about account linking, see Understand Account Linking for Alexa Skills.
If you display a quick link in your mobile app, the customer must 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, the link takes them to the Quick Links for Alexa web page. On the page, they are redirected to the account linking flow (if it is required for your skill). In the account linking flow, they must enter credentials for your service again, since they are no longer in your mobile app. To reduce this friction, you can surface the app-to-app account linking feature to your customers on your mobile app. Then, as the last step of your app-to-app account linking flow, you can redirect the customer to your quick link.
View quick links analytics for your skill
In the developer console, you can view the number of skill launches you generated through quick links.
If you want to track the number of skill launches coming from individual links surfaced in different online channels, you must use custom tasks in your skill in combination with query string parameters in the quick link URL. For example, you might 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 find this out by using a query string attribution parameter. You can pass the parameter 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. For details, see Add campaign attribution to your traffic analytics.