Use este método para enviar arquivos de áudio para usuários do Telegram. Seu áudio deve estar no formato *.mp3. Os bots atualmente podem enviar arquivos de áudio de até 50 MB de tamanho, esse limite pode ser alterado no futuro. Para mais detalhes, acesse a documentação oficial.


Para utilizar este bloco, é preciso ter o plugin Telegram Bot instalado no seu projeto. Acesse a documentação do Cronapp Plugin Telegram Bot para mais detalhes. 


Figura 1 - Bloco Enviar Áudio

Compatibilidade

  • Bloco servidor: cronapp.framework.telegram.BotOperations.sendAudio()

Retorno

Retorna um objeto JSON contendo informações do bot, cliente e do áudio enviado.

Características do bloco

Este bloco pode tanto receber arquivos no formato .mp3 quanto .ogg. O Telegram reconhece o primeiro arquivo como um arquivo de áudio, enquanto o segundo é tratado como um arquivo de voz. Diferentes plataformas do Telegram (Telegram web e desktop) tratam esses arquivos com algumas particularidades. 

Parâmetros

Bot Token

Parâmetro obrigatório. Chave de acesso exclusiva que identifica o seu bot junto à API do Telegram.

  • Posição: 1
  • Inglês: Bot Token
  • Tipo: Texto / String 

  • Exemplo: "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz1234567890"

Chat Id

Parâmetro obrigatório. ID do usuário que receberá o áudio. Para obter o id dos usuários que se comunicaram com o bot, utilize o bloco Obter Atualizações / Get Updates.

  • Posição: 2
  • Inglês: Chat Id
  • Tipo: Texto / String 

  • Exemplo: "1235862828"

Áudio

Arquivo de áudio que será enviado. Passe um file_id como string para enviar um arquivo de áudio que existe nos servidores do Telegram (recomendado) ou, passe uma URL HTTP como string para o Telegram obter um arquivo de áudio da Internet.

  • Posição: 3
  • Inglês: Audio
  • Tipo: Texto / String 

  • Exemplo: "CQACAgQAAxkDAAMsZh1peNWIfOyabsXr69NqM5G6okYAAtQFAALRsvVQi89rHGSfumo0BA"

Exemplo

No exemplo da figura abaixo, estamos enviando um áudio para um usuário específico, identificado através dos parâmetros passados no bloco. Os dados do áudio podem ser observados no retorno da função, impresso no console do depurador.


Figura 2 - Função que envia um áudio para um usuário


Enviamos um arquivo de áudio (.mp3) ao usuário através da função criada anteriormente.


Figura 2.1 - Arquivo de áudio enviado ao usuário


Modificamos o tipo de dado recebido pelo terceiro parâmetro do bloco para um arquivo no formato .ogg, dessa forma, o usuário receberá um arquivo de voz, ao invés de um arquivo de áudio.


Figura 2.2 - Arquivo de voz enviado ao usuário

Nesta página