Uh oh! We couldn’t find any match.

Please try other search keywords.

Bixby Developer Center

Guides

Confirmation Moment

Confirmation Moment

In a Confirmation Moment, Bixby asks the user for a confirmation before taking an important action. This Moment is an opportunity for the user to review all the choices and decisions they have made (or Bixby assumed based on selection or preference learning) before completing a task for the user.

Prior to a Confirmation Moment, Bixby gathers all the information your capsule needs to fulfill a user’s intention during the Input Moment. Once they land on the Confirmation Moment, users still have an opportunity to make any changes they wish to make by either touch or voice.

Examples

Go ahead and book it?

Ready to book?

When to Use

There are certain actions and transactions that must be reviewed or confirmed before they are completed:

  • Confirming Transactions that involve the user spending money or authentication. For instance, buying tickets to a concert, making a hotel reservation, or booking a ride share.
  • Confirming Actions that have a critical impact on the user or on other people or businesses, including actions that are not easily reversed without an impact. For instance, getting directions, sending a message, or making a restaurant reservation.

In all cases, the confirmation moment should have a summary header followed by each input in its own tappable input cell. For more information, see transaction properties in the Building Views topic.

Key Considerations

Transactions to Confirm

We recommend confirming a transaction before it is executed. However, in cases of non-monetary transactions, you should exercise discretion, keeping in mind what would make for a better assistant experience. For example, it’s better to just complete simple tasks (like setting reminders, or playing music) without a confirmation.

Review and Modification
  • All the choices made by the user or Bixby should be editable, allowing the user to make any changes by touch, typing or voice.

  • If the user chooses to change an input, you should carry over the information to the consequential Input Moment, so the user sees their previous choice, has the option to modify, and is not starting from scratch.

  • Split separate inputs into individual cells leading to individual prompts. For instance, if you require first name and last name as two separate inputs, use two separate Input Moments asking, "What’s your first name?" and “What’s your last name?”. Correspondingly, separate the first name and last name as two separate input cells in the Confirmation Moment.

Confirming Monetary Transactions

The Bixby platform requires letting the user review all the important information as well as a detailed price breakdown before making a monetary transaction or authentication.

image alt text

Additional Considerations

Show a summary of all important information, including a detailed breakdown of the transaction amount (including base amount and taxes) for the user to review.

Confirming Non-Monetary Transactions

You should design your capsule such that Bixby confirms any irreversible or critical tasks.

image alt text

Additional Considerations

Show a summary of all important information, in order of priority, for the user to review, which should you consider while modeling actions.

Composing This Moment

Conversation Zone

The dialog used on a confirmation moment should be a brief and direct question that prompts the user to act. For more information on how to write dialog, see the writing guidelines.

Content Zone

You can read about these components in the Confirmation View section on the Building Views page of the Developer Guide or the reference guides linked below.

Use these components in a Confirmation Moment:

Action Zone

The intention of the actions provided on the action zone is to let the user complete their task seamlessly, but also have the option to cancel. Therefore, it is not recommended to add conversation drivers that take the user away from the transaction.

Design Considerations
  • The confirmation action is always provided as a button. An action to cancel the transaction can be provided as a conversation driver. It is recommended to keep both the labels on the button and driver conversational.

  • You can brand the confirmation button by using labels and colors which are specific to your brand.