Test Alexa Shopping Actions in Your Skill


Use the Alexa Simulator in the Alexa developer console to test your skill and the Alexa Shopping Actions implementation. If your skill supports multiple marketplaces, test in the default locale for each marketplace. For details about how to test your skill in the developer console, see Validate and test your skill.

Make sure that you include the following scenarios in your testing.

Verify product recommendations

Verify all places in your skill where you offer product recommendations. Make sure that you test the following scenarios:

  • Verify that the placement of the recommendation makes sense.
  • Make sure that the suggestion to learn more requires a Yes or No response to confirm interest in the product.
  • Verify that the purchase prompt doesn't include any pricing information.
  • Make sure that the customer doesn't receive a purchase suggestion for a product that they already own.
  • If the customer declines the recommendation, verify that you don't offer the same product again.

Verify the add-to-cart flow

Verify all places in your skill where you offer to add the product to the customer's Amazon Shopping Cart. Include the following scenarios:

  • Customer declines the recommendation.
  • Customer adds the product to their Cart.
  • Customer declines the product during the interaction with Alexa.
  • Verify the handover from Alexa back to your skill. Make sure that you have a follow-up response for a successful action and a flow to handle customer errors.
  • Don't continue to recommend a product that received a success response.

Verify the add-to-list flow

Verify all places in your skill where you offer to add the recommended product to the customer's Wish List. Include the following scenarios:

  • Customer declines the recommendation
  • Customer adds the product to their Wish List.
  • Customer declines the product during the interaction with Alexa.
  • Verify the handover from Alexa back to your skill. Make sure that you have a follow-up response for a successful action and a flow to handle customer errors.
  • Don't continue to recommend a product that received a success response.

Verify the purchase flow

Verify all places in your skill where you ask the customer if they want to purchase a product. Include the following scenarios:

  • Verify that the placement of the purchase suggestion makes sense.
  • Make sure that the suggestion to buy the product requires a Yes or No response to confirm interest in the product.
  • Customer declines the recommendation.
  • Customer purchases the product.
  • Customer declines the purchase during the interaction with Alexa.
  • Verify the handover from Alexa back to your skill. Make sure that you have a follow-up response for a successful action and a flow to handle customer errors.
  • Don't continue to recommend a product that received a success response.

Verify the recommend-products flow

Verify the places in your skill where you recommend one or more products. Customers can hear details about the products, and then buy the products or return to your skill. Include the following scenarios:

  • Customer declines the recommendations.
  • Customer confirms that they want to learn more.
  • Customer declines the recommendations during the interaction with Alexa.
  • Your skill receives a session error response.
  • Verify the handover from Alexa back to your skill. Make sure that you have a follow-up response for a successful action and a flow to handle customer errors.
  • Don't continue to recommend a product that received a success response.

Verify the refund flow

After the customer purchases a product, they can ask for a refund. Verify that your skill reminds the customer to visit the Amazon retail website to review and cancel their order.

Verify the Amazon Associates disclaimer

If you registered your skill with the Amazon Associates on Alexa program, make sure that your skill provides the disclosure that the skill earns commission each time the customer invokes the skill. Verify for voice and text. For more details, see product recommendation guidelines.


Was this page helpful?

Last updated: Nov 23, 2023