Telegram is a messaging application that enables integration with various systems using chatbots.

ITSM Telegram-bot serves the following purposes: 

  • Create Incidents and User Queries
  • View Incidents and User Queries
  • Leave comments
  • Provide additional information for the Requests in the state Information needed
  • Approve and reject requests
  • Cancel requests and evaluate the agent's work and the service.

Bot connecting to your instance


Required role: admin.

To connect to a preset bot, complete the following steps:

  1. Go to the Preferences menu → Application, select ITSM from the dropdown list.
  2. Go to ITSM Telegram-бот → Bot connection page.

  3. Follow the instructions on the page.

    Save a username (@username_bot) and a name of the new bot.


  4. Complete the steps and click Set.

    Use an instance with an open to public URL, to enable Telegram server connection to the instance. Otherwise, an error occurs:
    Connection failed: Bad Request: bad webhook: Failed to resolve host: Name or service not known.


  5. In the Telegram application, find the created bot using its name or username.
  6. Click Start.

As a result, the bot is activated on your instance.

Before using the ITSM bot, ensure the following:

  1. The user has an active employee record, that is not Locked Out. 
  2. Verify that the telephone number in Telegram is current and the same as given in the Mobile Phone field in the Employee record form. If the telephone number starts with a plus sign in the Telegram account, the telephone number in the Employee record form should also start with a plus sign.

To activate an ITSM bot, do the following:

  1. Open Telegram.
  2. In the search bar, enter the name or username of the bot connected to your instance.
  3. Click Start. The bot will ask you to enter your mobile number.

As a result:

  • Successful connection: The bot has found your Employee record with the number provided. The bot setting is finished.
  • Error: The bot cannot authorize you because there is no record of an employee with such a mobile phone. Write to the support service and check if your current phone number is in the system.

When the connection is established, open the main menu. The following actions are available:



  • My Tickets – open a list of active incidents and user queries.
  • My approvals – open a list of active approval tickets.
  • New user query – ask a question, or request a personal consultation.
  • Report a problem – report about a problem with services, hardware, or software.


Creating a user query

To create a user query via the Telegram bot, follow the steps below:

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

  2. In the text field, briefly describe your problem and the question.

    This text will be used as a description and the subject of the user 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.



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

Creating an incident

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

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

  2. In the text field, briefly describe your problem. 

    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 your incident.

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


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, complete the following steps:

  1. In the main menu, click My Tickets.
    A list of active tickets will appear. Click on the link to open the list on the portal if you need.


  2. Click on the ticket name to see more details.
    The next message contains the following fields: Number and Subject, State, Description.
    In this step, the following options are available: 

      • 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 .

      • 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 .

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, 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 =
      • Meets Expectations =
      • Above Expectations =
    • 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 .
    • 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 .
    • My tickets – click the button to see the list of your active tickets.
    • Menu – click the button to see the main menu.

Ticket approval and rejection

You can check your active approval tickets via the ITSM 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, complete the steps below:

  1.  Click Go to the approval ticket to open the information about the ticket.
  2. Click Approve or Reject.
    • If you reject the ticket, specify the reason. Enter your comment and click the plane button .