Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
Informações |
---|
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.
Image RemovedImage Added
Figura 2 - Função que envia um áudio para um usuário
O resultado da execução pode ser observado na figura abaixo.
Enviamos um arquivo de áudio (.mp3
) ao usuário através da função criada anteriormente.
Image AddedImage Removed
Figura 2.1 - Áudio - 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.
Image Added
Figura 2.2 - Arquivo de voz enviado ao usuário
Nesta página
Índice