Atualizações recentes

29 de Setembro de 2020

Versão 6.4.0

• Correções menores.
• Otimização no tratamento de requisições.
• Aprimoramento na serialização e inicialização de variáveis no processo de requisição.
• Novo método ShellBot.setMyCommands para definicação de lista de comandos do bot.
• Novo método ShellBot.getMyCommands para obter a lista de comandos do bot.
• Nova função ShellBot.BotCommand para criação de um array do tipo BotCommand.
• Novo método ShellBot.sendDice para enviar uma mensagem de dados, que terá um valor aleatório de 1 a 6.

20 de Março de 2020

Versão 6.3.0

• Otimização e correção de erros menores.
• Suporte a formatação de texto em captions de mídia. Especifique o parse_mode desejado (Markdown ou HTML) ao fornecer uma legenda.
• Adicionado na função ShellBot.setMessageRules o novo parâmetro -T, --auth_file para autenticação dinâmica a partir de uma base de usuários.
  • Veja exemplo: MessageRules2.sh
• Adicionada a opção poll ao parâmetro -x, --message_status da função ShellBot.setMessageRules para validação de reposta em enquete.
• O método ShellBot.restringChatMember agora aceita as novas permissões de usuário em um único argumento do tipo ChatPermissions.
• Nova função ShellBot.ChatPermissions para criação do objeto ChatPermissions.
• Novo método ShellBot.setChatPermissions que define as permissões de bate-papo padrão para todos os membros.
• Novo método ShellBot.setChatAdministratorCustomTitle para definir títulos personalizados para administradores em super-grupos promovidos pelo bot.
• Novo método ShellBot.sendPoll para envio nativo de enquete.
  • Veja exemplo: sendPoll.sh
• Nova função ShellBot.KeyboardButtonPollType que retorna um objeto do tipo KeyboardButtonPollType para solicitação de enquetes via interface.
• Adicionado novo parâmetro -r, --request_poll na função ShellBot.KeyboardButton para criação de enquete quando o botão for pressionado.

26 de Janeiro de 2020

Versão 6.2.1

• Atualizações na função ShellBot.setMessageRules:
  • Correção no tratamento de caracteres para o padrão UTF-8 no retorno do parâmetro -E, --exec.
  • Adicionado o parâmetro -B, --bot_action para envio de ação em mensagens.

13 de Abril de 2019

Versão 6.2

• Foram realizadas otimizações e correções menores.
• Foram adicionadas novas flags {OBJECT_ID} e {OBJECT_TYPE} para expansão de objetos heterogêneos em log. Veja: flags de expansão
• Nova função ShellBot.regHandleExec que associa uma lista de comandos a um valor de chamada.
• Foram adicionados novos recursos a função ShellBot.setMessageRules:
  • Suporte a regras em canais.
  • Agora os parâmetros -e, --time e -d, --date suportam grupo negado e data/hora singular.
  • Novo parâmetro -A, --author_signature para tratamento de assinaturas em mensagens enviadas no canal.
  • Agora os parâmetros com suporte a grupo de captura tratam elementos delimitados por \n (nova linha).

14 de Fevereiro de 2019

Versão 6.1

• Foram realizadas correções e otimizações menores.

• Agora o parâmetro -x, --message_status da função ShellBot.setMessageRules suporta as opções inline e chosen para consulta e seleção em mensagens inline.

• A função ShellBot.init agora retorna as informações do bot inicializado no formato especificado no parâmetro -r, --return.

• A função ShellBot.downloadFile agora retorna um objeto contendo o caminho absoluto do arquivo baixado.

• Novo método

  • Adicionado o método ShellBot.answerInlineQuery para enviar respostas para uma consulta inline.

• Nova função

  • Adicionada a função ShellBot.getConfig que retorna as configurações do bot.
  • Adicionada a função ShellBot.InlineQueryResult para criar uma coleção de objetos InlineQueryResult.
  • Adicionada a função ShellBot.InputMessageContent para criar um objeto InputMessageContent.

  Veja o exemplo: InlineYoutube.sh

2 de Outubro de 2018

Versão 6.0

• Foram realizadas otimizações relevantes no tratamento de requisições (thread).

• Nova função

  • Adicionada a função ShellBot.KeyboardButton para criação e configuração de objeto KeyboardButton em teclados personalizados.
  • Adicionada a função ShellBot.ForceReply para criação de objeto ForceReply de interface de reposta em mensagens enviadas ao usuário.
  • Adicionada a função ShellBot.ReplyKeyboardRemove para criação de objeto ReplyKeyboardRemove para remoção de teclados personalizados ativos.

  Veja exemplo: ReplyKeyboardMarkup2.sh

• Modificações: (ATENÇÃO)

  • Agora o parâmetro -b, --button da função ShellBot.ReplyKeyboardMarkup trata implícitamente o objeto KeyboardButton como um array de array. Para mais informações: Estrutura do teclado

  Nota: O teclado personalizado agora suporta configurações distintas para cada botão permitindo a construção simples ou composta do objeto KeyboardButton.

18 de Setembro de 2018

Versão 5.9

• Os métodos com os parâmetros --text e --caption agora interpretam automaticamente caracteres de formatação.
• Novo parâmetro
  • Foram adicionados à função ShellBot.setMessageRules os parâmetros --bot_send_message, --bot_reply_message e --bot_forward_message para o envio prévio de mensagens.
  • Adicionado à função ShellBot.setMessageRules o parâmetro --bot_parse_mode para formatação de mensagem prévia.
  • Adicionado o parâmetro --continue à função ShellBot.setMessageRules para tratamento subsequente de regras.
• O parâmetro --exec da função ShellBot.setMessageRules agora suporta expansão de variáveis e argumentos posicionais.
• Os parâmetros --bot_send_message e --bot_reply_message da função ShellBot.setMessageRules agora suportam expansão de variáveis.
• Os parâmetros --user_id, --username, --chat_id, --chat_name, --chat_type, --language_code, --message_id, --is_bot, --mime_type, --query_data, --query_id, --num_args, --weekday e --user_status da função ShellBot.setMessageRules agora suportam grupo de captura.

10 de Setembro de 2018

Versão 5.8

• Foram realizadas correções menores.
• As regras aplicas por ShellBot.manageRules agora são registradas em -l, --log_file no método ShellBot.init.
• Novo parâmetro
  • Adicionado o parâmetro --exec a função ShellBot.setMessageRules para execução de comandos shell. Veja o exemplo: BotTerminal.sh

19 de Agosto de 2018

Versão 5.7

• Novo método:

  • Adicionado o método ShellBot.sendAnimation para envio de animações com duração, largura e altura especificada.
  • Adicionado o método ShellBot.editMessageMedia para edição do contéudo de mensagem multimídia.

• Nova função:

  • Adicionada a função ShellBot.inputMedia para criação de objetos InputMedia do tipo animation, video, audio, photo e document.

• Novo parametro:

  • Foram adicionados os parâmetros -s, --name (requerido), -k, --reply_message e -x, --message_status a função ShellBot.setMessageRules para nomenclatura de regras, resposta automática e monitoração de mensagens editadas, encaminhadas e fixadas.

• Adicionado dois novos tipos MessageEntity: cashtag e phone_number.

• Modificações: (ATENÇÃO)

  • As funções ShellBot.inputMediaVideo e ShellBot.inputMediaPhoto foram substituídas pela nova função ShellBot.inputMedia.

  Nota: Após a última atualização da API Oficial, o Telegram passou a suportar novos objetos InputMedia e para evitar múltiplas funções para criação de objetos distintos, tal recurso foi implementado em uma única função oferecendo ao desenvolvedor flexibilidade.

24 de Julho de 2018

Versão 5.6

• Correção de erro.
  • Foi corrigido o erro de compatibilidade da função gsub em versões compiladas do pacote jq.
• Nova função.
  • Foram adicionadas as funções ShellBot.setMessageRules e ShellBot.manageRules para criação/gerenciamento de regras em mensagens enviadas. (Exemplo: MessageRules.sh)

10 de Abril de 2018

Versão 5.5

• Correção de erro.
  • Corrigido o erro no envio da flag de ação no método ShellBot.sendChatAction.
• Novos parâmetros
  • Adicionado ao método ShellBot.init os parâmetros -l, --log_file, -o, --log_format, -r, --return e -d, --delimiter.
• Modificações (ATENÇÃO)
  • Foi inserido o campo ok ao retorno de todos os métodos no qual está o código de status (true ou false) do método e que precede todos os demais campos, modificando o retorno de campo1|campo2|campo3|... para ok|campo1|campo2|campo3|... (Somente para --return value)
  • Alteração do parâmetro --file_id para --file_path no método ShellBot.downloadFile.

Nota: As alterações realizadas foram absolutamente necessárias para suportar os novos recursos e adequar o tratamento dos dados de retorno e atribuição.

4 de Março de 2018

Versão 5.4

• Novo parâmetro
  • Adicionado novo parâmetro -s, --supports_streaming nos métodos ShellBot.sendVideo e ShellBot.inputMediaVideo.

8 de Fevereiro de 2018

Versão 5.3.1

• Atualização de correção
  • Corrigido o erro na atualização dos elementos da lista offset que gerava requisições ininterruptas.

7 de Janeiro de 2018

Versão 5.3

• Novo método adicionado ShellBot.sendMediaGroup para envio de fotos e vídeos com suporte a álbum.
• Novo objeto InputMedia para suportar o novo recurso de álbum e dois métodos para criação do mesmo: ShellBot.inputMediaPhoto e ShellBot.inputMediaVideo.
• Correção do método ShellBot.first_name.
  • O método agora retorna 'null' se o primeiro nome do bot não estiver definido.

10 de Novembro de 2017

Versão 5.2

• Correção do método ShellBot.downloadFile para baixar arquivos sem extensão dos servidores do Telegram.

17 de Outubro de 2017

Versão 5.1

• Os bots podem enviar e receber localizações ao vivo e um novo campo live_period foi adicionado ao método ShellBot.sendLocation.
• Foram adicionados dois métodos para gerenciamento de localizações enviadas.
  • ShellBot.editMessageLiveLocation
  • ShellBot.stopMessageLiveLocation
• Novos métodos para gerenciar conjuntos de adesivos em super grupos, bem como objetos necessários para bots inline.
  • ShellBot.setChatStickerSet
  • ShellBot.deleteChatStickerSet
• A solicitação ShellBot.getChat agora retorna o conjunto de adesivos do grupo para supergrupos, se disponível. Os Bots agora recebem entidades de legendas de mídia no novo campo caption_entities no objeto Message.

28 de Setembro de 2017

Versão 5.0

• Novo parâmetro:
  • Foi adicionado ao método ShellBot.init os parâmetros [-s, --service] e [-u, --user], que permite ao usuário criar um Bot Unit Service para gerenciamento do processo via systemd. Para informações de uso leia: Bot Unit Service.

30 de Agosto de 2017

Versão 4.9

• Correção de bugs:
  • Foi corrigido um erro no método ShellBot.downloadFile durante o processamento de arquivos na execução de threads.
• Remoção de arquivos temporários:
  • Arquivos temporários não são mais utilizados para armazenamento dos objetos JSON. A partir de agora as coleções retornadas pelos métodos são carregadas e tratadas na memória durante a execução.

27 de Agosto de 2017

Versão 4.8

• Novo parâmetro:
  • Foi adicionado ao método ShellBot.init o parâmetro -f, --flush que limpa todos os registros da lista offset durante a sua inicialização.
  • O método retorna agora uma coleção de objetos: bot_id|bot_username|bot_first_name|flush_first_id|flush_last_id

8 de Agosto de 2017

Versão 4.7

• Correção de bugs.
• Novo método:
  • ShellBot.downloadFile (Efetua download de arquivos enviados para o bot, grupo ou canal no qual é administrador.)

22 de Julho de 2017

Versão: 4.6

• Tratamento de parâmetros inválidos em chamadas de métodos.
• Pré verificação de arquivos regulares em parâmetros.
• Novos métodos: ShellBot.stickerMaskPosition, ShellBot.getStickerSet, ShellBot.uploadStickerFile, ShellBot.createNewStickerSet, ShellBot.addStickerToSet, ShellBot.setStickerPositionInSet e ShellBot.deleteStickerFromSet

(Atualizando documentação).

15 de Julho de 2017

Versão: 4.5

• Correção de bugs.
• Novo parâmetro foi adicionado ao método ShellBot.init (-m, --monitor). Quando ativado exibe no prompt os eventos do bot.
• Os métodos retornam um coleção de objetos.

03 de Julho de 2017

Versão: 4.2

Métodos para gerenciamento de politicas de super grupos e novos privilégios administrativos para bots.

Funções para monitoração de eventos, funções, atualizações e criação de threads.

• Métodos adicionados: ShellBot.setWebhook, ShellBot.getWebhookInfo, ShellBot.deleteWebhook, ShellBot.exportChatInviteLink, ShellBot.setChatPhoto, ShellBot.deleteChatPhoto, ShellBot.setChatTitle, ShellBot.setChatDescription, ShellBot.pinChatMessage, ShellBot.unpinChatMessage, ShellBot.restrictChatMember, ShellBot.promoteChatMember, ShellBot.sendVideoNote

• Funções adicionadas: ShellBot.ListUpdates, ShellBot.TotalUpdates, ShellBot.OffsetEnd, ShellBot.OffsetNext, ShellBot.regHandleFunction, ShellBot.watchHandle