Page History

Telegram is a messaging app providing that provides an option to integrate with various systems using chat botschatbots.

In SimpleOne, we developed a chat bot chatbot for our ITSM application. It provides the following operations:

• Creating incidents and inquiriesuser queries.
• Reviewing incidents and inquiriesuser queries.
• Leaving a comment.
• Giving additional information when tickets are in the Information Needed state.
• Approving or rejecting tickets.
• Closing tickets and rating agent work and level of service.

Connecting bot to your instance

To connect to a preconfigured bot, please complete the steps below:

1. Switch to the ITSM application in the Preferences menu.
2. Navigate to ITSM Telegram Bot → Bot Connection Page.

3. Follow the instructions given on the page. 

   Tooltip
   onlyIcon true appendIcon info-filled iconColor blue
   Save the username (@username_bot) and the name of the created chat bot.

   
   

4. When

   Once all steps are completed, click Set to connect the bot to your instance.
   

   Info
   You need to use an instance with a public URL so that Telegram servers can connect it. Otherwise, the following error will occur: Connection failed: Bad Request: bad webhook: Failed to resolve host: Name or service not known.

   
   

5. Find the bot on Telegram by its name or username.
6. Click Start.

As a result:

, the bot is activated on your instance.

User authorization 

Anchor
user authorization user authorization

To start using an ITSM bot, perform the following steps:

1. Launch the Telegram app.
2. In the search bar, type the username or name of the bot connected to your instance.
3. Click Start. The bot will ask you to share your phone number.
4. Click Share your phone number.

As a result:

• Success: The bot finds your profile record in your instance by with your phone number. Then all everything is set to work.
• Failed: The bot cannot authorize you because on the instance, there are no matching profiles with this phone number. Please write is no active Employee record that is not locked out with the Mobile Phone you are sharing. Write to your support and check if your current phone number is in the system.

In case of successful connection, If the connection is successful, open the main menu opens. The following actions are available:

Section

Column Image Added Anchor main menu main menu Image Removed Buttons My Approvals and Information are temporarily unavailable. Our developers are working on them and will deliver the functionality in one of the next ITSM application versions . Column My Tickets – opens open a list of active incidents and inquiries.user queries. My approvals – open a list of active approval tickets. New user query Consult – ask a question, or request a personal consultation. Create Incident – Report a problem – report about a problem with services, hardware, or software. Info

Creating

a user query

To create in inquiry a user query via the Telegram bot, perform the following steps:

1. In the main menu, click Consult New user query.
   The bot will ask you to write down your question.

2. In the message pole, briefly describe your problem and the question. 

   Info
   This text will be used as a description and the subject of the inquiryuser query, but unlike the description, the subject can contain only the first six words.

   
   

3. Click on the plane icon to send it.
   The bot will ask you to define the urgency of your question.

4. Define the necessary level of urgency: Low, Medium, High, Critical. 

   Tooltip
   onlyIcon true appendIcon info-filled iconColor blue
   Image RemovedImage Added

   
   

As a result, the inquiry user query is sent to your instance. You can continue working with the bot.

Creating an incident

To create in an incident via the Telegram bot, perform the following steps:

1. In the main menu, click Create incidentclick Report a problem.
   The bot will ask you to describe the problem you have faced.

2. In At the message pole, briefly describe your problem. 

   Info
   This text will be used as a description and the subject of the incident, but unlike the description, the subject can contain only first six words.

   
   

3. Click on the plane icon  to send it.
   The bot will ask you to define the urgency of the incident.

4. Define the necessary level of urgency: Low, Medium, High, Critical. 

   Tooltip
   onlyIcon true appendIcon info-filled iconColor blue
   Image RemovedImage Added

   
   

As a result, the incident is sent to your instance. You can continue working with the bot.

Checking a ticket state

To check the state and details of your active tickets, perform the following steps:

1. In the main menu, click My Tickets.

   • A list of active tickets will appear. 

     Tooltip
     onlyIcon true appendIcon info-filled iconColor blue
     Image RemovedImage Added

     
     

   • You can click on the link to open the list on the portal if you need.
2. Click on the ticket name to see more details.
   • Next message contains the following fields: Number and Subject, State, Description.
     On In this step, the following options are available: 

     • Details – click on this the button to see a more detailed information about your ticket.  Next The message contains will contain the following fields: State, Caller, Subject, Description, Company, Service, and other fields if they are not empty. 

       Tooltip
       Image Removed

       Comment – click on this

       onlyIcon true appendIcon info-filled iconColor blue
       Image Added

       
       

     • Leave a comment – click the button to create an additional comment which will be saved in the Activity Feed. Enter your comment and click the plane button Image Added.

     • My tickets – click the button to see the list of your active tickets.

     • Menu – click the button to see the main menu.

Information Needed

When the ticket state changes to Information Needed, you will receive a notification message and will be asked to add information. To add information, complete the steps below:

1. Click Go to the ticket to open the ticket details.
2. Enter your comment and click the plane button Image Added.

The comment will be sent and the state of the ticket will change to Assigned.

Closing tickets

Once the state of your ticket changes to Complete, you will receive a notification message about closing the ticket with the ticket number, closure code and closure information. To close the ticket, please complete the following steps:

1. Click Go to evaluation.
2. The following actions will appear:
   • Accept – click to accept the solution given. You will be asked to evaluate the quality of service and the agent's work. Values of these evaluations are connected to the values of choice options.
     • Below Expectations =Image Added
     • Meets Expectations =Image Added
     • Above Expectations =Image Added
   • Reject – click if you are not satisfied with the results. You will be asked to specify the rejection reason. Enter your comment and click the plane button Image Added.
   • Details – click the button to see more detailed information about your ticket. The message will contain the following fields: State, Caller, Subject, Description, Company, Service, and other fields if they are not empty. 
   • Leave a comment – click the button to create an additional comment, which will be saved in the Activity Feed. Enter your comment and click the plane button Image Modified.
   • Back My tickets – click on this the button to see the list of your active tickets.
   • Menu – click on this the button to see the main menu.

Approval tickets

You can check your active approval tickets via the telegram bot. In the main menu, click My approvals. A list of approval tasks will appear. 

When tickets that require your approval are created, you will also receive a notification message. 

To approve a ticket, please complete the steps below:

1.  Click Go to the approval ticket to open the information about the ticket.
2. Approve or reject the ticket.
   • If you reject it, you will need to specify the reason for rejection. Enter your comment and click the plane button Image Added.