Funções da API do Telegram
As funções da API expandem significativamente as capacidades de um bot no Telegram. Ao usar 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!
Origem: 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
parameter=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, "Some text", 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 os valores padrão de cada parâmetro. Portanto, se você não precisar de um parâmetro específico, mas precisar de um que venha depois dele, não pode simplesmente ignorar o que não será usado — em vez disso, você deve passar explicitamente o valor padrão dele.
Assim, o uso correto seria: tg_send_message(platform_id, "Some text", 61818138, None, None, 0, True)
Onde posso conseguir 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 na qual você deseja receber notificações.
Na lista de clientes do projeto, selecione o diálogo do cliente para o qual você deseja enviar solicitações.
Copie o valor do ID do campo do messenger.
Exemplo de passagem do platform_id parâmetro:
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 para 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, você deve fornecer o platform_id como um valor numérico.
Na função tg_send_message(!platform_id, !text) mostrada acima, o platform_id parameter é 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 parse_mode parâmetro formata o texto inteiro ou partes dele em itálico ou negrito. Ele pode ter os valores: html, markdown ou markdownV2.
Se você escolher html:
valores texto em negrito, use "<b>caption</b>"
valores texto itálico, use "<i>caption</i>"
Para Markdown:
valores texto em negrito, use "*caption*"
valores texto itálico, use "_caption_"
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, '*test*', None, None, 'markdown')
Atualizado