About Frustration Free Setup (FFS) for AVS

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

The following sections provide you with 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.
  • 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 then finishes the setup process.
  • Auto-discovery – The Alexa app on a mobile device uses Bluetooth Low Energy (BLE) to detect the new AVS-enabled device, and then 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 any 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 you report failures to Amazon, include the error code to help with debugging.

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

Was this page helpful?

Last updated: Dec 04, 2023