About Frustration Free Setup (FFS) for AVS

Frustration Free Setup (FFS) allows users to set up their new Alexa Voice Service (AVS) enabled devices through a registered Echo device or the Alexa app on their mobile devices. FFS leverages saved user credentials from the Amazon Wi-Fi locker to create a hassle-free registration experience for users.

The following sections give a conceptual overview of how FFS works with AVS.

Benefits of FFS

Implementing FFS on your AVS-enabled device has the following benefits:

  • Development efficiency – Remove the time and cost of developing your own companion app and cloud setup implementation.
  • Certified for Humans eligibility – An AVS device must implement FFS to be eligible for the Amazon Certified for Humans program. Certified for Humans provides additional marketing benefits and opportunities to certified AVS devices. To learn more, see AVS Certified for Human Program Requirements.
  • Simplified device setup for customers – Mitigate the most common reason for customers to call support for help.
  • Customer satisfaction – Positive user experiences lead to happier customers and more sales.

FFS setup options for users

FFS enables three different ways that users can set up an Alexa Voice Service (AVS) enabled device:

  • Zero-touch setup (ZTS) – The user powers on the AVS-enabled device, and then a registered Alexa provisioner, such as an Echo, Fire TV, or Alexa app, recognizes the device automatically and finishes the setup process.
  • Auto-discovery – The Alexa app on a mobile device uses Bluetooth Lowe Energy (BLE) to detect the new AVS-enabled device and the Alexa app completes Wi-Fi setup and registration for the device.
  • User-guided setup (UGS) – The Alexa app on a mobile device guides a user through a series of screens and prompts the user to perform the setup for the AVS-enabled device.

For UX guidance on these setup options, see Setting up Alexa using the Alexa app.

FFS setup flow for AVS-enabled devices

All FFS implementations perform the following setup tasks for an AVS-enabled device:

  1. The device connects to the local Wi-Fi network.
  2. FFS adds the device to the Alexa account for the user.

Error handling

Design and build your device to gracefully handle errors that occur during setup, such as incomplete device data or a BLE transaction failure. The following sections give basic tips for helping to troubleshoot setup errors.

If a setup failure occurs, the Echo device or Alexa app returns an error code. Use the error code to learn about possible causes of the error. When reporting failures to Amazon, include the error code to help with debugging.

For sample error codes and descriptions, see Fallback and Failure Cases.