Use este bloco para enviar arquivos de voz, se quiser que os clientes do Telegram exibam o arquivo como uma mensagem de voz reproduzível. Para que isso funcione, seu áudio deve estar em um arquivo .OGG. Atualmente, os bots podem enviar mensagens de voz de até 50 MB; esse limite pode ser alterado no futuro. Para mais informações, acesse a documentação oficial.

Figura 1 -  Bloco Enviar voz

Compatibilidade

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

Retorno

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

Características do bloco

Este bloco pode tanto receber arquivos no formato .ogg quanto .mp3. O Telegram reconhece o primeiro arquivo como um arquivo de voz, enquanto que o segundo é tratado como um arquivo de áudio. Diferentes plataformas do Telegram tratam esses arquivos com algumas particularidades. O Telegram web e desktop permitem que o usuário faça o download desses arquivos, no entendo, em plataformas mobile, somente o arquivo .mp3 pode ser armazenado  no dispositivo, e será salvo na pasta músicas.

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 arquivo de voz. 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"

Voz

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

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

• Exemplo: "AwACAgQAAxkDAANZZikbA-ZnaLEDzmc81-yh1-JIt4AAAusFAAJVT0xRY8UIsw94Njc0BA"

Exemplo

No exemplo da figura abaixo, estamos enviando um arquivo de voz no formato .ogg para um usuário específico, identificado através dos parâmetros passados no bloco. Os dados do arquivo podem ser observados no retorno da função, impresso no console do depurador. Os resultados apresentados nas figuras 2.1 e 2.2 foram realizados na plataforma desktop do Telegram.

Figura 2 -  Função que envia um arquivo de voz para um usuário.

O resultado da execução pode ser observado na figura abaixo. Podemos comprovar que o arquivo enviado pelo contém a extensão .ogg através dos destaques 1 da figura 2.1. 

Figura 2.1 -  Resultado da execução da função da figura 2

Modificamos o tipo de dado recebido pelo terceiro parâmetro do bloco para um arquivo .mp3, dessa forma, o usuário receberá um arquivo de áudio, ao invés de um arquivo de voz. Confira nos destaques 1 da figura 2.2.

Figura 2.2 -  Arquivo de áudio enviado para o usuário