As funções da API expandem significativamente as capacidades de um bot no Telegram. Usando funções da API, você pode trabalhar com anexos, grupos e chats no Telegram — por exemplo, automatizando o bloqueio ou desbloqueio de usuários, e muito mais!

Fonte: API do bot do Telegram

Importante!

Para entender como trabalhar com funções da API, recomendamos fortemente revisar as regras para especificar funções e parâmetros na calculadora.

NOTAÇÃO:

! — um ponto de exclamação indica parâmetros obrigatórios

parâmetro=None — isso mostra o valor padrão para o parâmetro especificado.

É incorreto simplesmente copiar o texto da função da documentação, assim: tg_send_message(platform_id, "Algum texto", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)

Os valores após os sinais de igual representam valores padrão para cada parâmetro. Portanto, se você não precisar de um determinado parâmetro, mas precisar de um que o suceda, não pode simplesmente pular o não utilizado — em vez disso, deve passar explicitamente seu valor padrão.

Assim, o uso correto seria: tg_send_message(platform_id, "Algum texto", 61818138, None, None, 0, True)

Onde posso obter o platform_id para enviar notificações?

  • Você precisa ter um bot do Telegram conectado ao seu projeto.
  • Envie qualquer mensagem para este bot a partir da conta do Telegram onde deseja receber notificações.
  • Na lista de clientes do projeto, selecione o diálogo do cliente para o qual deseja enviar solicitações.
  • Copie o valor do ID do campo do mensageiro.

  1. O parâmetro platform_id pode ser passado sem especificar explicitamente valores numéricos.

react = tg_set_reaction(platform_id, 1556, '👌')

Funções com este parâmetro funcionarão mesmo sem especificar explicitamente um valor de platform_id.

Importante: Na maioria das funções, este parâmetro é obrigatório e não deve ser omitido.

2. Se você precisar usar a função em um chat, canal ou grupo específico, deve fornecer o platform_id como um valor numérico.

Na função tg_send_message(!platform_id, !text) mostrada acima, o parâmetro platform_id é passado usando aspas envolvendo um valor numérico:

tgmess = tg_send_message('1234566788', 'Olá!')

Como definir botões no parâmetro reply_markup

Exemplo de botões de resposta:

opts = {"keyboard": [[{"text": "Esquerda"}, {"text": "Direita"}]]}

Exemplo de botões inline:

opts = {"inline_keyboard": [[{"text": "Pacote 1","callback_data":1}, {"text": "Pacote 2","callback_data":2}]]}

Como usar formatação de texto (Markdown) no parâmetro parse_mode**?**

O parâmetro parse_mode formata todo o texto ou partes dele em itálico ou negrito. Pode ter os valores: html, markdown ou markdownV2.

  1. Se você escolher html:

para texto em negrito, use "<b>legenda</b>"

para texto em itálico, use "<i>legenda</i>"

  1. Para Markdown:

para texto em negrito, use "*legenda*"

para texto em itálico, use "_legenda_"

Exemplo de envio de texto em itálico:
tg_send_message(47615196, "<i>itálico</i>",None,None,"html")

Exemplo de envio de texto em negrito:
tg_send_message(platform_id, '*teste*', None, None, 'markdown')