Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Próxima »

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.


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 enviado.

Características do bloco


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. 


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.1 -  Arquivo de áudio enviado para o usuário



  • Sem rótulos