Design Checklist

This checklist gives you a quick way to ensure your action is ready to distribute to your users, and helps us evaluate your action for approval. We recommend following this design process to get you started.

Greetings and Goodbyes
Tell users who you are

The Google Assistant passes the user experience to your Conversation Action, so be sure to let users know they are entering your experience.

  • Does your persona tell users who they're talking to?
  • Is there a clear transition from the Google Assistant into the action, and do users know where they are now?
Give the right amount of information

Cater your greeting to users with varying degrees of familiarity with your actions:

  • Will brand new users understand what your action is all about? Is the initial greeting informative without overwhelming them?
  • Does your greeting sound repetitive for experienced users? Is there a shorter, more familiar greeting for returning users?
End conversations appropriately

When users fulfill their intent, give them a chance to do something else or let them move on with their lives. Is there an unobstructed path to the exit? Are simple back out requests like "nevermind" and "no, thanks" honored in the contexts where they make sense for users?

Conversational Dialogs
Take turns

A good conversation partner knows how to give the right cues.

  • DO give users enough context to respond each time you yield a turn. DON'T just make an ambiguous statement and then open the mic.
  • DO give users a question or prompt that turns over the conversation to them. DON'T keep speaking after asking a question.
Sound natural

For every dialog you write, read it aloud and make sure it:

  • Is something your desired persona would say
  • Is written with a conversation in mind rather than just a copy of some other medium (such as a converted mobile app or website).
Conversation Repair (Error Handling)
Find out how you can implement these here.
Prevent errors by expecting variations

Understand input that's phrased in many alternate ways, such as: yes, yeah, sure, it does, it sure does, of course, or definitely.

Provide helpful reprompts or pivot to another question

Reframe questions for users when they say things your action doesn't understand or when they don't say anything at all (two very different contexts!).

Be prepared to help at any time

Users might ask for help at any point in the conversation ("What can I do?"), so be prepared and either reprompt them or offer an explicit help dialog. TIP: Prevent confusion with intuitive commands.

Let users replay information

Recognize and appropriately respond to user input like "what?", "repeat", "say that again", and other similar phrases.

Fail gracefully

If users don't provide a response or one that you can't recognize after two or three tries, exit with an appropriate message.

Reflect your unique brand and identity

Users will perceive a persona whether you plan for one or not, so if you don't already have a persona defined for your brand, create one! Find out more in our Design Tips video.

Keep users coming back

Think of your persona as a real person and make sure that you and your users would want to interact with it, even after many interactions.

Stay consistent

Maintain the persona throughout the entire conversation, so users don't experience jarring or confusing dialogs that feel like they're talking to multiple personalities.