Use este bloco para enviar arquivos de voz, no formato .ogg para que os clientes do Telegram exibam o arquivo como uma mensagem de voz reproduzível. Para enviar arquivos de áudio, utilize o formato .mp3. 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.


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 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 o segundo é tratado como um arquivo de áudio. 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 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 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 observar que o arquivo enviado pelo bot 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

Nesta página