How to Edit Conversation Key Messages

A Virtual Assistant uses conversation messages when communicating with end users. It is a best practice to customize these messages and add new messages or ontologies before you set up your Intents, Fulfillments, Conversation flow, or Workflows.

Conversation Messages link in Bot Details Window

Choose the View Conversations link (shown above) in your application or bot Details window to modify Default Conversation Key Messages. If you bot experiences conversation errors, see Conversation Error Messages.

The messages are the same for all the Domains, with the exception of:

  • initial_greeting

  • initial_recommendations

  • banners

  • No_answer_message (message that appears if user doesn't answer)

Message Conventions

These are the minimum requirements from Aisera, however, you can modify these messages to match your company voice and tone.

  • Use Neutral language.

  • Don’t sound too apologetic. Give users a solution, not an apology.

  • Be Concise.

  • Remove jargon/technical words (such as terms specific to your data source).

  • Look for opportunities to offer proactive assistance.

  • Use a variety of messages to make your bot sound less robotic.

  • Think about using phrases that will work long-term (maintainable and sustainable).

Default Conversation Key Messages

To modify the default messages, click the View Messages link in your application or bot Details window. When you see the list of Conversation Messages, hover over the right end of the message that you want to modify and click the pencil icon to open the Edit dialog for the message.

Choose a Message to Edit

You can edit the original message or add more messages below the initial message.

Add a second message below the first

The screenshot below displays a message where a second line has been added.

Second message for the same key

The table below describes the Aisera Default Conversation Key Messages.

Conversation Key/Name
Context
Examples

action_exception_hint_key

If an error occurs during a flow execution

It looks like something went wrong while processing your request. Please reach out to support for assistance.

approve_failure_message _key

If an error happens during "getting an approval" flow.

Something went wrong while working on your approval. Please reach out to support for assistance.

approve_feedback _message_key

After the manager approves a request.

Thank you for approving the request!

Thanks for your approval!

Awesome, your approval has been successfully submitted.

bot_not_trained

Could only occur in staging if an admin doesn’t set up a Virtual Assistant properly. It’s important that the Virtual Assistant recommends that an admin retrains the app.

It looks like I wasn’t set up properly. Please let an admin know that I need to be retrained.

conversation_error_message

If an error happens on the conversation server side when processing a request (common reason: not being able to recognize a phrase)

Looks like I haven’t learned that yet. Please try rephrasing your request or typing Help for more options.

I don’t know how to help with that yet. Please rephrase your request or type Help for more options.

conversation_invalid _identity_message

Could only occur in staging if a channel to tenant mapping was not set up properly. It’s important to acknowledge the reason for an error.

It looks like I wasn’t set up properly. Please let an admin know that my channel to tenant mapping hasn’t been completed yet.

conversation_reordering_find_skill

This message appears only when a conversation policy is set to emphasizing skills over articles and highlights that a specific skill might be the solution to the request.

Would you like to try the solution %skill? You can also select Self-Help Info to view self-help articles instead.

I found this solution for you: %skill. Would you like to continue? Please select Self-Help Info to view self-help articles instead.

email_sms_help_message

E-mail & sms channels only: when an error occurs.

Sorry, I can’t help you with that yet. Please try rephrasing, typing Help, or try one of the below:

  • skill 1

  • skill 2

exception_intent_handling _find_skills

When a Virtual Assistant did not find skills with high confidence levels, but still recommended a few options with lower confidence.

Great, I found a few results that may help!

Absolutely. Please take a look at the following solutions:

Sure. I hope the following options are helpful:

Got it, looks like one of the following might help:

Awesome, I think the below options may help:

Here are a few options I found for you:

exception_intent_handling _non_added_skill

When a Virtual Assistant recognizes user's intent, however the skill has not been imported locally and could not be activated.

Sorry, I can’t help with that yet. Please try rephrasing or entering Help for options you can try.

feedback_comment_on_no

When a user considers the answer helpful and selects "Yes" to the question "Was this helpful?"

I’m sorry to hear my answer wasn’t helpful. Please try typing Help for more options.

I’m sorry I couldn't help you this time. Please try typing Help for more options.

Sorry I wasn’t helpful this time. Please try typing Help for more options.

Would you like to try something else? You can also type Help for some other options.

I aspire to be better! Try typing Help to see some things I can do.

feedback_comment_on_yes

When a user considers the answer helpful and selects "Yes" to the question "Was this helpful?"

Great! Let me know if there’s anything else I can do for you.

Thank you! Let me know how else I can help. 🙂

Happy I could help!

Glad I could help - let me know if there’s anything else I can do for you. 🙂

Thanks for your feedback! I appreciate it.

flow_ask_approval_followup _message_key

A Virtual Assistant sends this message to let the end-user know that it would follow-up after an approval from the end-user’s manager.

Great, you’ll be notified once your request is approved. What else can I do for you?

flow_execution_wait_message_key

Appears when a flow takes longer than the expected wait time. Default 3 seconds (configurable).

Got it! Working on it...

Just a moment. Working on it...

Please allow me a moment to work on this…

I’m working on your request now - please allow me a little more time…

Please give me a few more moments while I work on your request…

flow_exit_hint_message_key

A hint message that shows up in a flow to explain how to cancel it at any point. It is helpful in case users get stuck in a flow and would like to start over.

You can type Exit to start over and ask me something else.

Type Exit to start over and ask me a different question.

Feel free to type Exit and ask me something else.

You can type Exit any time before asking me another question.

Did you know you can type Exit to start over and ask me another question?

flow_exit_message_key

The response to when users type "Cancel" or "Exit" to cancel a flow.

No problem, let's start over. How can I help?

Got it. Feel free to ask me something else!

Sure, let’s try helping you with something else.

Done! Happy to help you with another request.

Of course. What can I help you with next?

flow_resume_fail_key

Some flows require users to click on a link to fill out a form outside of a Virtual Assistant channel (external flow). This message appears if an error happens during one of those external flow executions.

It seems that something went wrong with your selection. Can you please try again?

flow_resume_success_key

Some flows require users to click on a link to fill out a form outside of a Virtual Assistant channel (external flow). This message appears when that flow execution processes successfully.

All done! Let me know how else I can help.

You're all set. What else can I do for you?

You’re good to go! Let me know if I can help with anything else.

Finished - how can I help you next?

hidden_first_page_kb_button_label

A label for a button that is only visible when conversation policy is set to emphasizing skills over articles. On click, the button shows relevant article(s).

Self-Help Info

initial_greeting

The initial greeting message from a Virtual Assistant. Specific to an app.

Hi %s, I’m your Virtual Assistant! 🤓 Feel free to ask me anything.

Hey %s, I’m your Virtual Assistant. How can I help you today?

initial_recommendation

This message follows the initial_greeting. Initial recommendations typically have a message with a set of suggested action buttons. When providing multiple messages, a Virtual Assistant would alternate those. Specific to an app.

Here are some ways I can get you started:

  • skill 1

Here are some of the most popular requests:

  • skill 1

Feel free to try one of the below options to start:

  • skill 1

intent_disambiguation_key

When user's request is ambiguous and a Virtual Assistant provides a few options that have a high confidence score.

These might help! Please select one of the options to continue:

Sure, here are a few suggestions. Please select one to continue:

Got it. I found a few things for you to try:

kb_find_service_catalog

When a Virtual Assistant provides options from Service Catalog.

I found this form that may help with your request:

I think this form may help:

kb_find_service_catalog_also

When a Virtual Assistant provides options from Service Catalog in addition to other options (skills, articles).

Form(s):

live_agent_connection_timeout

When a Virtual Assistant was not able to establish a connection with a live agent after a specific wait time (the wait time is configurable).

It looks like there aren't any support agents available at the moment. Please try connecting later or submit a ticket.

  • Create Ticket skill

live_agent_contact_fail

When a Virtual Assistant was not able to find a live agent. Reasons: outside office hours or no agent available at the requested time.

It looks like no one is available at the moment. Please try connecting later or submit a request by typing "Create Ticket". How else can I help?

live_agent_fail_user_inactive

When a user is not (yet) on the list of users who can contact live agents.

Looks like your account [%email] has not been activated yet. New users are typically activated within 24–48 hrs. Please try again later.

live_agent_message_user_ disconnected

When the user ends the conversation with a live agent.

Your conversation with the live agent has ended.

Your live session has ended.

live_agent_pre_fulfillment_msg

Last opportunity to prevent an escalation.

I'm happy to transfer you to a support agent. First, can you please briefly explain the problem?

message_feedback_request

Asking for feedback on whether the Virtual Assistant answer was helpful.

Currently, we support emojis in buttons. But only the first two buttons will be accepted, the first button is for Yes, and the second button is for No.

Did this help? 👍 👎

Was I able to help? 👍 👎

Did I help resolve your request? 👍 👎

Was this helpful? 👍 👎

Was I helpful? 👍 👎

multi_fulfillment_find_skills

When a Virtual Assistant finds multiple skills to the user's request.

Here are a few things you can try:

Here are a few options:

Here are a few suggestions:

multi_fulfillment_find_skills_also

When a Virtual Assistant finds a few skills in addition to other answers.

Other relevant options:

Other options:

no_answer_message

When a Virtual Assistant was not able to find an answer to the question.

I can't help with that yet. Below are some of the most common requests we receive. Please select one or rephrase your question.

  • skill 1

notification_application_provision_key

When a Virtual Assistant notifies users that a new application is available for them to install.

Good news! 🎉 We just added a new application. Would you like to install it?

notification_banner

WebChat only. A message located at the very top of a WebChat in the beginning of a session.

Remote Team Meeting Etiquette Tip

Turn video on so your team is more engaged.

Outages:

💡Email Interruption Tonight at 11:00 PM ET

password_hint_message

When asking a user to enter a new password.

Please enter a new password (min 1 uppercase & 1 lowercase letters).

notification_ticket_action_button_key

Ticket Concierge. When providing some options for users to update their ticket.

Here are a few options to update the request:

Update the request:

notification_ticket_resolved_action _key

Ticket Concierge. When resolving users' tickets with an action skill.

Click on the button to start:

Click on the recommendation below:

notification_ticket_resolved_kb_key

Ticket Concierge. When resolving users' tickets with a knowledge article.

Here’s what I found:

notification_ticket_resolved_key

Ticket Concierge. When a Virtual Assistant sends a potential solution to the user’s request.

Good news! I think I found a solution to your request: %s

I think I’ve got a solution to your request: %s

notification_ticket_resolved_sc_key

When resolving users' tickets with service catalog.

Suggested form:

recommendation_continue_context _message

A Virtual Assistant would remind me about an unfinished task.

It looks like we haven't finished working on: '%s'. Would you like to resume?

It looks like we haven't finished your request: '%s'. Would you like to continue working on it?

recommendation_has_result_message

A Virtual Assistant would highlight that the list of tasks it recommends is based on the previous request.

Based on your previous request, here are some relevant options:

reset_password_fail

This message appears if the password requirements were not met.

Please try again and [make sure your password meets the below requirements:8 characters min, 1 lowercase letter, 1 uppercase letter, 1 number, no parts of your username.

resolution_note_header_message

Email only: the text in a header that is based on ticket resolution notes.

Here’s some helpful information:

This information might help:

search_multiple_results

When returning an answer with multiple knowledge articles.

I took a look for you, and found these articles that might help:

Sure. Here are a few things I found:

Absolutely. Here are some relevant articles:

Cool, I got it! One of the below articles may help:

Here are some articles I found for you that should help:

search_results_key

When returning an answer with one knowledge article.

Looks like this might answer your question:

Sure, here’s something I found:

Here’s some information I found for you:

No problem. I hope this helps!

Please take a look at the below and let me know if it helps:

Got it, I found this for you. Let me know if it helps!

session_feedback_survey_question

When asking for feedback (1-5 stars) at the end of a chat session.

➡️ How has your experience been so far?

Poor, Fair, Good, Very Good, Excellent

How has your experience been so far?

😠 😔 😐 😊 😃

session_feedback_survey_response

Responding to the feedback a user left.

Thank you! I appreciate your feedback.

Thank you - your feedback helps me continuously learn!

Noted! I appreciate the feedback.

I always appreciate your feedback.

Thank you. Keep the feedback coming!

silent_request_answered

Slack silent listening mode: when responding to a user's question in a general slack channel.

Hi {user}, I've sent a DM on your request. Let us know if you have any questions.

Hi {user}, I've sent you a DM with the next steps.

👋 {user}, I am sending you a DM with related information. Please respond to it so I know what to do next!

silent_request_preamble

Slack silent listening mode: when returning an answer to a user's question in the direct channel.

Hey {user}! this may help answer your request: '$QUESTION'

Hey {user}! This might help with your request: '$QUESTION'

Hi {user}, this information could help with your request: '$QUESTION'

Hi {user}, this might help with your request: '$QUESTION'

silent_request_resolved

Slack silent listening mode: when a user marks the Virtual Agent’s response as helpful.

{user} rated my answer as helpful. Marking this as resolved.

slack_form_password_reset

Slack only: Password reset button label.

Reset Password

ticket_SOR_not_found

When a ticket was not found in the system of record because the system of record was not set up.

Looks like there isn’t a connection to a ticketing system. Please reach out to live support.

too_many_match_item_key

Virtual Assistant asking for clarification when too many results matched the user's input.

To narrow down the results, could you please make your request more specific? Sure. To get you the best answer, would you please make your request more specific? I’m on it! Can you please make your request more specific so I can help you find the best answer?

user_input_clarification_message

Asking for clarification.

No problem. Could you please confirm?

Absolutely. Can you please choose the relevant option?

Got it. Could you please confirm?

Of course. Can you please confirm?

Definitely. Could you please confirm?

user_input_retry_message

When a Virtual Assistant asks a user to re-enter his/her choice since the previous one is invalid (e.g., getting numbers when an email address is expected).

Your answer doesn’t match the expected format. Please type Exit to start over.

It looks like your answer is in an invalid format. Please type Exit to start over.

silent_mode_skill_preamble

In silent listening mode, when Aisera is able to find a single Skill to help a user's request from a public channel. This message will be used as a preamble before the Skill’s button in the DM to the user.

Click on the button below:

Click on the button below to start:

fail_to_continue_closed_conversation

This is for channels (such as, Slack or MS Teams), where a conversation history is preserved. In this case, an end user tries to click on one of the options from the previous session, that had already finished. Because that session is over, the bot can not get back with the proper answer and instead uses a default message asking the end user to retype the question.

Hmm, seems like you’re selecting something from our previous session. Please reenter your request and I can help you out.

We’ve closed the previous conversation for now. If you still need help, just enter your request, and we can pick up where we left off

silent_request_agent_notification

Slack silent listening mode: after escalation, when returning the conversation history between an end user and a bot to the agent.

Here is the conversation history with $USER on '$QUESTION'

routing_to_live_agent

When starting a live agent session and before an agent picks up the conversation, showing that the conversation has been routed to agents.

Routing you to a live agent...

agent_joined_msg

When an agent picks up the conversation and joins the chat.

%s will be replaced by agent’s name

%s has joined the chat

live_agent_external_system_error_msg

When the external live agent system has issue and cannot find any available agent.

Looks like there aren’t any available agents at the moment. Please try again later.

agent_exited_msg

When an agent terminates the live agent conversation

%s will be replaced by agent’s name

%s closed the session

%s has ended the live chat

%s has closed the live chat

%s has closed the live session

%s has ended the conversation

agent_waiting_queue_update_msg

When a user is waiting for an agent, s/he can see the position in line.

(this data will be provided by the external live agent system)

%s will be replaced by the number of users waiting in the queue

There are %s people in front of you

agent_waiting_time_update_ms

When a user is waiting for an agent and the waiting time has changed

When the user is waiting for an agent, and his position in the waiting queue has changed

(this data will be provided by the external live agent system)

%s will be replaced by the estimated number of minutes

An agent will be with you in %s minutes

agent_typing_msg

When an agent is typing, showing a notification on user’s side

(this data will be provided by the external live agent system)

%s will be replaced by the agent’s name

%s is typing...

user_continue_confirm_message

When Bot has multiple fulfillments and a tenant is configured with Action first, Bot will use Flow’s preamble message to engage with a user. But the flow’s preamble message won’t have Would you like to proceed? since flow’s preamble message also will be used when flow fulfillment is directly matched. So we need to combine Flow’s preamble message with this message together

Note: I understand you want to access the application. is from flow message and Would you like to proceed? is from this message key

agent_waiting_queue_update_second _position_msg

User is 2nd in line waiting for a live agent to join.

There is 1 person in front of you

agent_waiting_queue_update_top_ position_msg

User is next in line waiting for a live agent to join.

You are next in line. An agent is joining soon.

conversation_history_bot_label

When conversation history is generated as part of escalation to create ticket or live agent init message, this is the bot Label that is replaced with.

Aisera:

Buddy Bot:

conversation_history_user_label

When conversation history is generated as part of escalation to create ticket or live agent init message, this is the user Label that is replaced with when message is of value : ${user.FirstName!=''?user.FirstName:user.EmailId}@%requestTime:

${user.FirstName!=''?user.FirstName:user.EmailId}@%requestTime:

User:

Customer :

agent_request_file_sharing

Live Agent requests the user to upload a file.

Agent has requested a file from you.

agent_cancelled_file_sharing

Live Agent has canceled the file uploading request.

Agent has canceled a file sharing request.

live_agent_message_user_ disconnected_ticket_id

The user ends the conversation with a live agent. And a ticket id will be appended to the message, which was created during the conversation. %ticketId will be replaced by the ticket id.

Your conversation with the live agent has ended - please start a new conversation if you want to continue. Otherwise, your ticket ID from the conversation is %ticketId.

live_agent_message_download_ transcript

Live Agent Message that give a hint to let user download conversation transcript.

Please click the button to download the transcript.

download_transcript_button_label

Label of the download conversation transcript button.

Download.

low_confidence_answer_preamble

PreAmble message for conversation response if it’s coming from exception handling (no valid intent).

Got it, let's see if this will help for your request:

No problem. Do any of the below help?

Sure - hopefully one of the results below will help.

Okay! I found a few things which might help:

live_agent_connection_timeout_ fallback_button_label

The label of the button which will show when connection to live agent timeouts

Submit a case

too_many_retries_error_message

Message displayed when user retries a flow input has exceed config maxUserInputRetry [default = 2]

I have detected too many bad retries I am closing this request. If you need anything else please type in your request again.

flow_exit_with_escalate_hint_ message_key

The flow exit hint message with escalate command, to allow users to escalate at any point of execution of non-feedback flows.

You can type %s to start over, or %s for more assistance.

initial_greeting_unknown

The initial greeting message from a Virtual Assistant when username to greet with is unavailable.

Hey there, I may be able to help answer your question.

channel_error

If the channel timeout responds to the user, this message is displayed.

I’m having trouble finding what you need, please submit a case and a member of our support team will assist you!

fulfillment_disambiguation_message

The bot found multiple answers to a request, asking the user to select which to continue with.

Please select one of the following options to continue.

member_joined_channel

Message displayed when a new member is added to a slack channel.

Hey $USER, Excited to have you on the team. Here is some important info to help bring you up to speed on what's going on in the $channelName channel.

unknown_user_input_on_wait_message

While the user types a new request while s/he was asked to wait while the flow is working on its response, try to remind them about the pending request and hint to exit if they want to start with a new request.

I am currently working on your previous request kindly wait, if you want help with something else, you can type Cancel and start a new request.

translated_content_hint

When the response to the user is translated content from the original flow message this is added as a note. [Only when flag “Show translated Content Info“ is enabled].

Note: This is Translated Content

domain_exception_handling_ask_ clarification

For Universal App Only, when Domain is not predicted with high confidence the bot requests the user to pick the intent s/he wants to continue with.

I am working on your request, but need your help to find what works the best for you. Please select the most appropriate option that applies to your question

error_kb_not_found

Message displayed when internal services are unable to fetch intented KB in fulfillment.

There was an unexpected failure when I tried to fetch the article that would have really helped you. Please submit a case and a member of our support team will assist you!

kb_more_recommendations

More recommendation button label when there are more kb articles.

More Recommendations

entity_based_filtering_low_ confidence_answer_preamble

During the entity based fulfillment filtering, if there is no fulfillments based on entity filtering and there are no bol KBs, No fallback fulfillment inside this intent and have fulfillments without entity bindings, we will show the fulfillments without entity bindings, with this preamble message.

I am trying my best to understand your question - '$QUESTION'.

entity_based_filtering_low_ confidence_answer_preamble

During the entity based fulfillment filtering, if there is no fulfillments based on entity filtering and there are no bol KBs, No fallback fulfillment inside this intent and have fulfillments without entity bindings, we will show the fulfillments without entity bindings, with this preamble message.

I am trying my best to understand your question - '$QUESTION'.

deflection_fulfillments_preamble

When Deflect Escalate Intent is enabled, eg, create ticket, before executing the flow in Create Ticket intent, we will try to deflect the request by asking the user to clarify the questions and use this message as a preamble message.

Before continuing, I found something that might be able to help.

webchat_input_prompt

Customize your webchat input field message

Type your question here

user_preference_reminder

Universal App specific this message is sent when the user updates the language preference.

Reminder: You can always check or change your preferred language by typing: 'Change language' in any supported language

user_preference_update_prompt

Universal App specific, this message is sent when the bot identifies the user request language was detected to be other than the language preference.

It looks like your preferred language is %language. Would you like to change it?

user_preference_empty_set_prompt

Universal App specific, this message is sent when the bot identifies the user request language was detected, but Aisera does not have a user preference.

It looks like your language preferences have not been set. Would you like to update it to help me learn?

multiple_kb_public_domain_disclaimer

Multiple KB card hints when it contains more than 1 public domain content.

Some knowledge articles are authorized to be served from %publicDomain.

single_kb_public_domain_disclaimer

Single KB card /Multiple KB card hint when it contains just 1 public domain content.

A knowledge article is authorized to be served from %publicDomain.

live_agent_contact_fail_no_agent _available

User asks to connect to a live agent but there aren't any available.

It seems that there is no agent available right now. Please try it later.

live_agent_user_upload_file

Used in SNOW Live Agent, when a user sends a file to the agent, this message is used to show to the agent, which file is uploaded.

User uploads a file: %s

live_agent_file_type_not_support

Users in SNOW Live Agent, when user uploads a file, whose type (mime type) is not supported by SNOW

The type of the file, %s, is not supported in the live agent system.

not_helpful_other_reason

Would you please provide more information?

not_helpful_preamble

Could you let me know why this is not helpful?

listening_ticket_concierge_skill_only

Ticket concierge channel finds a single action flow as a fulfillment for the title of the ticket that was created.

Hey $user, I see you have created a ticket $ticketId regarding $ticketTitle. I find the below skills helpful

listening_ticket_concierge_preamble

Ticket concierge channel when finds multiple sources as a fulfillment for the title of the ticket that was created.

Hey $user, I see you have created a ticket $ticketId regarding $ticketTitle. I find the below skills helpful

live_agent_exit_hint

When an agent sends a message to the user, attach this message as a hint and send it to the user.

To stop talking to the agent, just type %s

form_input_retry_message

Oops, got some error from the form, could you please retry?

validation_number_too_big

Invalid input for '$fieldLabel'. Can not greater than $maxVal

validation_number_too_small

Invalid input for '$fieldLabel'. Can not smaller than $minVal

validation_number_invalid_range

Invalid input for '$fieldLabel'. Needs in the range of [$minVal, $maxVal]

validation_general_invalid

Invalid input for '$fieldLabel'

validation_missing_required_field

Missing required input for '$fieldLabel'

Conversation Error Messages

The following table describes the Aisera platform error messages associated with conversations.

You can also share these messages with your Aisera team to help diagnose an issue.

Conversation Error Code
Cause

ERR-001: Failed Internal Service Request

Any gRPC based service calls exceeds deadline to respond

ERR-002: Internal System Error

Any reference to NULL

ERR-003: Internal System Error

Improper arguments sent to a method

ERR-004: Internal System Error

Usually occurs when deployment has not completed properly

ERR-005: Internal System Error

Usually occurs when deployment has not completed properly

ERR-006: Internal System Error

Internal Aisera System Error

ERR-007: Failed Fulfillment Service

Any fulfillment exception, such as: action, custom fulfillment, or failure.

ERR-008: Internal System Error

Any runtime exceptions

ERR-009 - Host Unavailable

Unable to identify host

ERR-010: Unavailable resource

Resource provided does not exists

ERR-011: Process Interrupted

Interrupted process

ERR-012: Aisera Unexpected Server Error

Any other exceptions are logged with this code

Last updated