Substitutions

JIRA tenant - koji-sertificationcertification.atlassian.net

Jira Admin username - admin@companykoji.owner@gmail.com

Jira Admin password - admin_ Pas$w0rd

Customer username - customer@companykoji.customer@gmail.com

Customer password - customer_Pas$w0rd

Live agent username - koji.agent@gmail.com

Live agent password - agent_ Pas$w0rd

JSDM project name - Certification

FAQ article title – Koji sample article 

First authentication

Prerequisites

1. Login as a Jira Admin to test Jira Service Desk Management instance:URL:

• Go to koji-

...

• certification.atlassian.net

...

• .

• Enter koji.owner@gmail.com

...

• as your email.

• Enter admin_ Pas$w0rd as your password.

• Click Log in.

...

Now you can access the Certification service management project in Atlassian.

...

2. Add the Koji application to your instance. Follow the appropriate instruction here: Installation To do so, follow the instruction described on the Installation page.

Steps

...

1. Log in as a user in a channel.

...

When you open a newly installed application, the bot

...

greets you.

2. Start talking to the bot. When the bot prompts you to log in, enter the following data:

• Domain: koji-sertification.atlassian.net

• Username:

...

• koji.customer@gmail.com

• Password: customer_Pas$w0rd

Expected result

The authentication is carried out successfully, the bot accepts and processes your initial input.

Setup scenarios

Customizing the bot

1. As a JiraAdmin go to Projects > Certification > Koji backoffice.

2. In Koji backoffice, go to Koji settings > Global settings.

Bot name

...

Press Edit button

Provide a bot name i.e. My Bot. Save changes

Refresh the page. Open the chat. New bot name appeared

...

Go back to Koji settings. Try

...

Refresh the chat. Default name Koji appears.

Bot

...

Conversation Scenarios: interactions

“Quick answer”

Prerequisites

As JiraAdmin navigate to Projects -> Certification -> Koji backoffice

Inside Koji backoffice navigate to Koji settings -> Search.

...

avatar

Upload the valid image file with bot avatar following the instructions below

...

Refresh the chat. New bot avatar will be in use.

Remove the image you uploaded from File manager.

Refresh the chat. The default Koji avatar will be used.

Welcome message

...

Press Edit button

Provide a message. Save changes.

Refresh the page. Open the chat. New message will appears.

Go back to Koji settings. Try the following option:

...

Refresh the page. Open the chat. Default welcome message appears.

Conversation scenarios: interactions

Quick answer

Prerequisites

1. As a JiraAdmin go to Projects > Certification > Koji backoffice.

2. In Koji backoffice, go to Koji settings > Search.

3. Enable the Search the local FAQ parameter:

...

Steps

1. As a user, go to

...

the chat.

2. Start a new conversation.

3. Select the Quick answer option.

4. When a bot asks you a question, reply with “sample article”.

Expected result

Bot will show you The bot shows you the FAQ article with title “Koji sample article”

...

“Sample FAQ article”.

Google support

Prerequisites

1. As a JiraAdmin navigate go to Projects - > Certification - > Koji backoffice.

Inside 2. In Koji backoffice navigate , go to Koji settings - > Search.

3. Enable the following Google G-Suite support search parameter:

...

Steps

1. As a user, go to

...

the chat.

2. Start a new conversation.

3. Select the Google support option.

4. When a bot asks you a question, reply with “How can I create Gmail account?”.

Expected result

Bot will show The bot shows you the article from Google Help center with the title “Create “Create a Gmail account - Gmail Help”

...

Help”.

Request management — menu

Prerequisites

• You

...

• have passed the authentication for the first time with the bot.

• First time when you start

...

• managing your requests, bot may

...

• ask you for a project, so you

...

• must select one JSDM project from the list bot provides to you.

Steps

1. As a user, go to

...

the chat.

2. Start a new conversation.

3. Select the Request management option.

Expected result

Bot will show The bot shows you the request management menu. There It should beinclude the following:·        

• Project ID

...

• : it must match the project you’ve selected before

...

• Filter by Status (Open by default)

...

• Current request type (All by default)

...

• List of requests (empty for the new customer)

...

• Button

...

• Create new

...

• Switcher Quick status preview/List mode

...

• Button Done

...

Request management — create new request

Prerequisites

• You

...

• have passed the authentication for the first time with the bot.

• First time when you start managing your requests, bot may

...

• ask you for a project, so you

...

• must select one JSDM project from the list bot provides to you.

Steps

1. As a user, go to

...

the chat.

2. Start a new conversation.

3. Select the Request management option.

4. Click the Create new button in the menu

...

.

5. Select a ticket type from the list and respond to all bot’s questions.

Expected result

Bot will send The bot displays a success message with a link to the ticket. When you follow the link, it will open opens a ticket on the Certification customer portal.

...

Request management — file attachment

Prerequisites

• You

...

• have passed the authentication for the first time with the bot.

• First time when you start managing your requests, bot may

...

• ask you for a project, so you

...

• must select one JSDM project from the list bot provides to you.

Steps

1. As a user, go to

...

the chat.

2. Start a new conversation.

3. Select the Request management option.

4. Click the Create new button in the menu

...

.

5. Select a ticket type from the list and respond to all bot’s questions.

6. When the bot

...

asks about the request summary, you can attach files

...

.

Expected result

Bot will send The bot sends a success message with a link to the ticket. When you follow the link, it will open opens a ticket on the Certification customer portal. All the attached files will are present, as a requests’ comments. 

Conversation

...

scenarios: direct input

Hello

Prerequisites

• You have passed the authentication for the first time with the bot.

Steps

1. As a user, go to the chat.

2. Start a new conversation.

3. Type hello .

Expected result

The bot will greet you and provide the most common options you can use.

Help

Prerequisites

• You have passed the authentication for the first time with the bot.

Steps

1. As a user, go to the chat.

2. Start a new conversation.

3. Type help.

Expected result

The bot will display a list of options that that you can use.

Search in the internal knowledge base

Prerequisites

• Same as for the appropriate scenario with interactions.

As JiraAdmin navigate to Projects -> Certification -> Koji backoffice

Inside Koji backoffice navigate to Koji settings -> Search.

Enable the following parameter:

...

Steps

1. As a user, go to the chat.

2. Start a new conversation

3. Type Koji sample article.

Expected result

The bot shows you the FAQ article with the title “Koji sample article”.

Google support

Prerequisites

• Same as for the appropriate scenario with interactions.

Steps

1. As a user, go to the chat.

2. Start a new conversation.

3. Type How can I create Gmail account?.

Expected result

The bot shows you the article from Google Help center with the title “Create a Gmail account - Gmail Help”.

Request management — menu

Prerequisites

• Same as for the appropriate scenario with interactions.

Steps

1. As a user, go to the chat.

2. Start a new conversation.

3. Type list tickets.

Expected result

The bot shows you the request management menu. It should include the following:

• Project ID: it must match the project you’ve selected before

• Filter by Status (Open by default)

• Current request type (All by default)

• List of requests (empty for the new customer)

• Button Create new

• Switcher Quick status preview/List mode

• Button Done

Request management — create new request

Prerequisites

• Same as for interaction

Steps

1. As a user, go to the chat, start the new conversation with “Koji sample article”.

2. Start a new conversation.

3. Type create ticket .

4. Select a ticket type from the list and respond to all bot’s questions.

Expected result

The bot displays a success message with a link to the ticket. When you follow the link, it opens a ticket on the Certification customer portal.

Stop

Steps

1. As a user, go to the chat.

2. Start a new conversation.

3. At any time of conversation type stop or exit.

Expected result

Bot will show you FAQ article with title “Koji sample article”

...

The bot will send the message that conversation is finished and provide options in order to start a new one.

Conversation scenarios: chat commands

#help

Steps

1. As a user, go to

...

the chat.

2. Start a new conversation

...

.

3. Type #help”.

Expected result

Bot will respond with an The bot responds with instructions and tips of what you can you do with the bot

...

.

#exit

Steps

1. As a user, go to the chat.

2. Start a new conversation.

3. At any time of conversation type #exit.

Expected result

The bot will send the message that conversation is finished and provide options in order to start a new one.

Live agent support

No operators available

Steps

1. As a user, go to chat, start the new conversation with “the chat.

1. Start a new conversation.

1. Type

talk to operator”.

Expected result

Bot will reply The bot replies that no operators are available but and that you can create a request.

Transfer to an agent

Prerequisites

1. As a JiraAdmin go to Projects > Certification > Koji backoffice.

2. In Koji backoffice, go to Koji settings > Live agent.

3. Enable the Enable the live chat so your customers can interact with live agents. parameter:

4. In Koji backoffice, go to Configuration > Tenants > Tenant role setup.

5. Set role Live agent to your customer.

...

Steps: agent preparation

1. As a user, go to the chat.

2. If authentication is not passed yet, provide the credentials.

3. Start a new conversation.

4. Type #on.

Expected result

The bot will send a message about ‘on duty’ status.

Steps: transfer to an agent from user side

1. As non-agent user go to chat (may use portal chat or chat component inside Koji backoffice).

2. Start a new conversation.

3. Type transfer to an agent.

Expected result

• The bot will send a message that agent will take this conversation and got a summary.

• If user send a message, this message will also be sent to a live agent.

• If agent send a message, user will see it on user’s side with agent’s name.

Steps: transfer to an agent from agent side

1. As an agent go to chat.

2. Prepare yourself as ‘on duty’ as it is described above.

3. Wait for a user who ask talking to a live agent

Expected result

• The bot will send the username and conversation summary.

• If user send a message, this message will also be sent to a live agent.

• If agent send a message, user will see it on user’s side.

Steps: closing the conversation

1. From any side (agent or non-agent user) in a chat type #exit.

Expected result

• The bot will send a message to both sides that conversation is finished.