Intro

When writing dialog for your digital assistant, imagine that you’re writing for a real person who has important tasks that they need to accomplish. The user might be frustrated or in a hurry to complete a work-related task. You’re having a conversation with your users and want to give them an answer that is quick, concise, and accurate. Don’t think about how you you’d write a statement for users, but how you’d say it to them.



Focus on user

The user is the most important person in conversational design. Focus the conversational design on your users. Give users only the relevant information they need to complete their request. Don’t waste their time or frustrate them further.

Do

Give a link or button that quickly helps them create a leave request.
Give a link or button that quickly helps them create a leave request.

Don’t

The response is asking irrelevant questions and not helping the user.
The response is asking irrelevant questions and not helping the user.


Concise language

Use concise, natural, neutral language. Typical responses are between 60-90 characters. Keep it simple.

Do

Give users a concise answer to their request. Use simple sentences, buttons, images to simplify the response.
Give users a concise answer to their request. Use simple sentences, buttons, images to simplify the response.

Don’t

Too many words for the user to read and comprehend. Get to the point as quickly as you can. They don't have time for this.
Too many words for the user to read and comprehend. Get to the point as quickly as you can. They don't have time for this.


Active voice

Basic active voice sentences are subject, verb, object. I love biking. Active voice is more understandable and direct. In the passive voice, the subject is acted on by the verb. Biking is loved by me. This can be unclear or too wordy. Write dialog as if you are having a conversation with a friend or coworker. If you say it aloud and it sounds strange, try to reword it.

Do

Keep the active voice, present tense to avoid confusion and awkward sentence structure.
Keep the active voice, present tense to avoid confusion and awkward sentence structure.

Don’t

The digital assistant language is confusing:
The digital assistant language is confusing: "the software should have been downloaded...", "steps were followed...", which makes it unnecessarily complex and awkward.


Guide users

Users don’t know what they need. That’s why they’re asking for help. Find out what they need and give them options and next steps to help them complete their task. Keep earlier information in mind when responding. Give users a call-to-action to complete their task.

Do

The user only gave a name, no other details, like a country. Give the user options to clarify the information.
The user only gave a name, no other details, like a country. Give the user options to clarify the information.

Don’t

The digital assistant doesn't give the user any choices. It just points out that the user made a mistake in the request.
The digital assistant doesn't give the user any choices. It just points out that the user made a mistake in the request.


Slang and jargon

We want our users to know that we take them and their concerns seriously. Slang (very informal language) and colloquialisms (local or regional expressions) don’t translate well. Indian English, Australian English, and US English often have very different ways of saying things. What is said in English can be insulting or disrespectful in another language. Stick to basic, professional language.

Do

This gives an estimate of how much a laptop is without any additional confusing language.
This gives an estimate of how much a laptop is without any additional confusing language.

Don’t

The phrases
The phrases "ballpark figure" and "in a pickle" are American expressions and might not translate into different languages and cultures. "Okey dokey, artichokey" is slang and a using a bit of unnecessary humor. Use language that everyone can understand.


Emotions and Humor

It’s best to stay away from using emotions, emojis and emoticons when communicating online. These don’t always translate well from one culture to another. Certain emojis, like a hand gesture, can be offensive in some cultures. Humor is subjective and can be interpreted differently.

Do

Give user the information they asked for. A user has a serious question and wants a serious answer.
Give user the information they asked for. A user has a serious question and wants a serious answer.

Don’t

Humor and jokes aren't universal. Don't waste the user's time joking around
Humor and jokes aren't universal. Don't waste the user's time joking around