Ir para o conteúdo

Aurium

Voltar a Blog
Tela cheia

Telegram Bot API Proposal: Alarm Notification Method

10 de Maio de 2018, 15:37 , por Aurélio A. Heckert - 0sem comentários ainda | No one following this article yet.
Visualizado 43 vezes

Personal assistant bots could need to emergency notify. It is not enough to have a message notification for heavy users or for who is not using the smartphone or other device with a telegram client in that emergency moment.

 

For instance:

  • An assistant bot my need to notify an schedule marked as important. To ensure that the user will see the notification in time, the bot could ask the client to alarm the user.
  • A server monitoring tool with a bot interface could alarm the server admin when worrying event happens.

 

Specification

 

sendAlarm

Use this method to send alarm messages. On success, the sent Message is returned. The optional photo will be presented on the "highlighted chat alarm message" and as a background on the device alarm when it is possible. An "highlighted chat alarm message" must display a button to enable/disable this bot alarm. Bot developers must consider to send a request message with enable_alarmKeyboardButton, before the first alarm.

 

Parameters Type Required Description
chat_id Integer or String Yes Unique identifier for the target chat or username of the target channel (in the format @channelusername). Yes it may try to alarm all group.
text String Yes Text of the alarm. This text will be show as a highlighted message in the chat and in the device alarm.
parse_mode String Optional Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message.
photo InputFile or String Optional Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data.

 

KeyboardButton

Add this field:

enable_alarm Boolean Optional. If True, a button to enable bot alarm will be show to the user. (It do not need to be show if the user already enabled this bot to alarm)

 

Android Screen Proposal

Telegram alarm notification
A ring tone must play with.


Tags deste artigo: telegram proposal

0sem comentários ainda

    Enviar um comentário

    Os campos realçados são obrigatórios.

    Se você é um usuário registrado, pode se identificar e ser reconhecido automaticamente.

    Cancelar