Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

On this page

Table of Contents
maxLevel2
exclude(On this page|Use case).*
stylecircle
typeflat
separatorpipe



UI Text Box
sizemedium
typeinfo

Use case

In this use case we will automatically send a Telegram message notifying the reporter of the issue about its status. The message will be delivered to a dedicated Telegram chat. After sending, we will save the response status in the description field.


Prerequisites

UI Text Box
typeinfo

For this use case, we need a Telegram bot (create or use an existing one), a Connection for communicating with Telegram and a Custom action for executing the send message operation.


UI Expand
titleTelegram bot

Create a new Telegram bot or make sure you have access to your bot API token of your Telegram account.


UI Expand
titleCreate a connection

Configure the connection either inside the post function configuration or within the Remote actions page in the Manage apps administration by setting the following input.

UI Steps


UI Step

Name

Telegram


UI Step

Connection type

Choose External.


UI Step

Base URL

Code Block
https://api.telegram.org



UI Step

Authentication

Choose No authentication.




UI Expand
titleCreate a custom remote action

Create the action either inside the post function configuration or within the Remote actions page in the Manage apps administration by setting the following input.

UI Steps


UI Step

Name

Notify the reporter


UI Step

Method

Choose POST.


UI Step

Default connection

Choose Telegram.


UI Step

REST path

The BOT_API_TOKEN is the one you get as soon as a new bot is created.

Code Block
linenumberstrue
/BOT_API_TOKEN/sendMessage?{chat_id}&{text}


Excerpt Include
DECADIS:_snip_execute_remote_action_use_case_values
DECADIS:_snip_execute_remote_action_use_case_values
nopaneltrue

UI Step

Parameters

chat_id

The chat_id is an unique identifier for the target chat or username of the target channel. In this case you can use the chat id we provide as follows:

Code Block
linenumberstrue
-1001535712522

text

Code Block
linenumberstrue
The ticket %{issue.key}-%{issue.summary} was transitioned to status %{issue.status}.






Configuration

UI Steps


UI Step

Add the Execute remote action post function to the desired transition or create a new transition.


UI Step

Select action

Choose the previously created action which we named Notify the reporter.


UI Step

Select connection

The default connection of the selected action should be preselected, which is Telegram.


UI Step

Update issue fields (optional)

Excerpt Include
DECADIS:_snip_execute_remote_action_default_responses
DECADIS:_snip_execute_remote_action_default_responses
nopaneltrue

UI Steps


UI Step

Select the field to be set.

Choose Description.


UI Step

Set the value.

Choose Response status.










Related use cases

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser function, Label
sortByTitle
cqllabel = "use-case-workflow" and ancestor = "73403011"
execute remote action


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


JWT feature

Workflow function

Execute remote action

Label



Page properties
hiddentrue



Status
Tech review

Status
titletodo

Style guide

Status
titletodo

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged