Add Alexa Shopping Actions to Your Alexa Skill

With Alexa Shopping Actions, you can build a custom skill that recommends physical products with Alexa shopping. Customers can buy the recommended product or add it to their Amazon Shopping Cart or Wish List without leaving the skill. For example, your role-playing skill might offer the customer the opportunity to buy the corresponding board game. Customers pay for products by using the payment options associated with their Amazon account.

You can include Alexa Shopping Actions in skills that use the custom voice interaction model. For details about the custom voice interaction model, see Create the Interaction Model for Your Skill.

What are Alexa Shopping Actions?

With Alexa Shopping Actions, you can create a shopping experience within your custom skill by recommending items from the Amazon retail website. You determine what products to offer in your skill. If the customer expresses interest in the product, you use Skills Connections to hand over control to Alexa to complete the shopping experience. Alexa presents the product information, including product title, price, and delivery estimates, asks for confirmation, and then invokes the requested action.

Alexa shopping supports the following actions:

  • Add the product to the customer's Cart. The customer can review the item later by visiting the Amazon retail website; they don't make the purchasing decision during the skill session.
  • Add the product to the customer's Amazon Wish List. The customer can share their Wish List with friends by visiting the Amazon retail website; they don't make a purchasing decision during the skill session.
  • Buy the recommended product. The purchasing workflow incorporates various checks, including valid payment type, delivery address, and voice PIN authorization associated with the customer's Amazon account.
  • Recommend one or more products. The customer can hear details about the products, and then decide to add the products to their Cart, buy the products, or return to the skill.

To start the action, your skill invokes the Amazon shopping flow. Here, Alexa guides the customer through the shopping action by using the Cart and payment options associated with their Amazon account. After the shopping flow completes, Alexa hands control back to your skill.

What does the voice shopping flow look like?

When a customer buys a physical product on Amazon by using Alexa Shopping, the presentation of the product, price, and delivery estimates are like the Cart check-out experience on the Amazon retail website. Alexa Shopping Actions support voice code authorization and voice profile authorization, where applicable.

In the following example voice flow, the customer buys a physical product on Amazon. The example shows the handover from the skill to the Alexa Shopping flow, and control returned to the skill after the shopping flow completes. You can alter the dialog for the skill, but Amazon controls the dialog for Alexa Shopping. For more example voice shopping flows, see Design the Product Recommendation.

Step State Actor Speaker BuyShoppingProducts

1

Product recommendation

Skill

Alexa

"You've strayed far from your bonfire. You can unlock more of the story with the companion comic.
Want to learn how to buy the comic book on Amazon?"

2

Customer response

Skill

Customer

"Yes"

3

Follow-up action

Skill

N/A

<Passes control to Alexa Shopping>

4

Offer presentation

Alexa Shopping

Alexa

"Here are the product details from Amazon. Your purchase includes an interactive narrative comic, the print version. The total, including VAT, is twelve pounds."

5

Confirmation

Alexa Shopping

Alexa

"Would you like to buy it?"

6

Customer response

Alexa Shopping

Customer

"Yes"

7

Acknowledgment

Alexa Shopping

Alexa

"Order placed."

8

Relay control

Alexa Shopping

Alexa

<Passes control to the skill with the action status>

9

Follow-up action

Skill

Alexa

"While you wait for the book, would you like to continue playing?"

Step State Actor Speaker BuyShoppingProducts

1

Product recommendation

Skill

Alexa

"You've strayed far from your bonfire. You can unlock more of the story with the companion comic.
Want to learn how to buy the comic book on Amazon?"

2

Customer response

Skill

Customer

"Yes"

3

Follow-up action

Skill

N/A

<Passes control to Alexa Shopping>

4

Offer presentation

Alexa Shopping

Alexa

"Here are the product details from Amazon. Your purchase includes an interactive narrative comic, the print version. The total, including tax and shipping, is twelve dollars and four cents."

5

Confirmation

Alexa Shopping

Alexa

"Would you like to buy it?"

6

Customer response

Alexa Shopping

Customer

"Yes"

7

Acknowledgment

Alexa Shopping

Alexa

"Order placed."

8

Relay control

Alexa Shopping

Alexa

<Passes control to the skill with the action status>

9

Follow-up action

Skill

Alexa

"While you wait for the book, would you like to continue playing?"

Step State Actor Speaker BuyShoppingProducts

1

Product recommendation

Skill

Alexa

ところでダーク・ソウルの小説では更なるストーリーを体験できます。こちらの商品に興味ありますか?

2

Customer response

Skill

Customer

はい

3

Follow-up action

Skill

N/A

<Passes control to Alexa Shopping>

4

Offer presentation

Alexa Shopping

Alexa

はい、こちらの商品は「ダーク・ソウル 小説」が含まれます。税込みの合計金額は1,200円です。

5

Confirmation

Alexa Shopping

Alexa

購入しますか?

6

Customer response

Alexa Shopping

Customer

はい

7

Acknowledgement

Alexa Shopping

Alexa

注文が送信されました。合計金額は1,200円です。これは税込みの金額です。6月22日お届けの予定です。

8

Relay control

Alexa Shopping

Alexa

<Passes control to the skill with the action status>

9

Follow-up action

Skill

Alexa

それでは商品が届くまで、新しいストーリーを選んで遊びますか?

Earn money with Amazon Associates on Alexa

With Amazon Associates on Alexa, Amazon's affiliate marketing program, you can recommend products to your customers and earn commission from qualifying purchases. When you include your Associated ID in the shopping action, Alexa attributes the purchase to your account. Live custom skills that include Alexa Shopping Actions can join the Amazon Associates on Alexa program. For more details about the benefits of the program, see Amazon Associates Resource Center.

To register for the Amazon Associates on Alexa program

  1. Register for Amazon Associates on Alexa and obtain an Associates ID.
  2. Disclose that your skill earns commission during the product recommendations.
  3. Add your Associates ID to your shopping action API requests so that Alexa attributes qualifying purchases to your Associates account.
    The following shopping actions support attribution: AddToShoppingCart, BuyShoppingProducts, and RecommendShoppingProducts.

Availability

Alexa shopping actions are available in multiple locales and Alexa-enabled devices.

Locales

You can use Alexa Shopping Actions in custom skills in the following locales and languages.

Locale code Language

de-DE

German (DE)

en-AU

English (AU)

en-CA

English (CA)

en-GB

English (UK)

en-IN

English (IN)

en-US

English (US)

es-ES

Spanish (ES)

es-MX

Spanish (MX)

es-US

Spanish (US)

fr-CA

French (CA)

fr-FR

French (FR)

hi-IN

Hindi (IN)

it-IT

Italian (IT)

ja-JP

Japanese (JP)

pt-BR

Portuguese (BR)

To use Alexa Shopping Actions, Amazon requires that you certify and publish your skill in each of your chosen locales. For details, see Develop Skills in Multiple Languages and Define Skill Store Details and Availability.

Alexa-enabled device support

The following Alexa-enabled devices support Alexa shopping:

  • Echo (all models)
  • Echo Dot (all models)
  • Echo Show (all models)
  • Echo Spot
  • Fire TV

How to add Alexa Shopping Actions to your skill

You can add Alexa Shopping Actions to a new or existing custom skill. Complete the following steps to create and publish a skill that includes Alexa Shopping. For details, see Steps to Add Alexa Shopping Actions to Your Skill.

  1. Enable Alexa Shopping Actions in your skill manifest.
  2. Update your voice interaction model to recommend products.
  3. Implement the shopping recommendation flows in your skill code.
  4. Handle declines and errors.
  5. Test your skill.
  6. Certify and publish your skill.

Restrictions

The following restrictions apply to skills that use Alexa Shopping Actions:

  • To use Alexa Shopping in your skill, customers must enable voice purchasing in the Alexa app.
  • To purchase products in your skill, customers must have a default 1-click setting enabled on their Amazon account.
  • You can't use Alexa Shopping Actions in child-directed skills.
  • You can't use Alexa Shopping Actions in Health Insurance Portability and Accountability Act (HIPAA) skills.

The following products on the Amazon retail website aren't eligible for Alexa Shopping Actions:

  • Prime Pantry.
  • Subscriptions.
  • Products with customization features, such as t-shirt sizes or a subscription option.
  • Grocery and consumable products from subsidiaries, such as Whole Foods and Prime Now.
  • Video and e-gift cards.
  • In-skill purchasing products.
  • Products with age restrictions, alcohol, or explicit content might not be available in all locales.