-
Notifications
You must be signed in to change notification settings - Fork 40
Atualizações recentes
- 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.
- 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.
- 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.
- Correção no tratamento de caracteres para o padrão UTF-8 no retorno do parâmetro
- 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).
-
Foram realizadas correções e otimizações menores.
-
Agora o parâmetro
-x, --message_status
da função ShellBot.setMessageRules suporta as opçõesinline
echosen
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
-
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.
- Agora o parâmetro
- 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.
- Foram adicionados à função ShellBot.setMessageRules os parâmetros
- 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.
- 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
- Adicionado o parâmetro
-
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
edocument
.
- Adicionada a função ShellBot.inputMedia para criação de objetos InputMedia do tipo
-
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.
- Foram adicionados os parâmetros
-
Adicionado dois novos tipos MessageEntity:
cashtag
ephone_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.
- Correção de erro.
- Foi corrigido o erro de compatibilidade da função
gsub
em versões compiladas do pacotejq
.
- Foi corrigido o erro de compatibilidade da função
- 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)
- 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
.
- Adicionado ao método ShellBot.init os parâmetros
- 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 decampo1|campo2|campo3|...
paraok|campo1|campo2|campo3|...
(Somente para--return value
) - Alteração do parâmetro
--file_id
para--file_path
no método ShellBot.downloadFile.
- Foi inserido o campo
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.
- Novo parâmetro
- Adicionado novo parâmetro
-s, --supports_streaming
nos métodos ShellBot.sendVideo e ShellBot.inputMediaVideo.
- Adicionado novo parâmetro
- Atualização de correção
- Corrigido o erro na atualização dos elementos da lista
offset
que gerava requisições ininterruptas.
- Corrigido o erro na atualização dos elementos da lista
- 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.
- Correção do método ShellBot.downloadFile para baixar arquivos sem extensão dos servidores do Telegram.
- 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.
- Novos métodos para gerenciar conjuntos de adesivos em super grupos, bem como objetos necessários para bots inline.
- 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.
- 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.
- Foi adicionado ao método ShellBot.init os parâmetros
- 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.
- 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
- Foi adicionado ao método ShellBot.init o parâmetro
- Correção de bugs.
- Novo método:
- ShellBot.downloadFile (Efetua download de arquivos enviados para o bot, grupo ou canal no qual é administrador.)
- 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).
- 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.
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
- E-mail: shellscriptx@gmail.com
- Juliano Santos (SHAMAN)
-
Inicio
-
- Update
- User
- Chat
- Message
- MessageEntity
- PhotoSize
- Audio
- Document
- Video
- Voice
- VideoNote
- Contact
- Location
- Venue
- UserProfilePhotos
- File
- ReplyKeyboardMarkup
- KeyboardButton
- ReplyKeyboardRemove
- InlineKeyboardMarkup
- InlineKeyboardButton
- CallbackQuery
- ForceReply
- ChatPhoto
- ChatMember
- Sticker
- StickerSet
- MaskPosition
- ResponseParameters
- WebhookInfo
- ChatPermissions
-
Funções
- ShellBot.init
- ShellBot.id
- ShellBot.username
- ShellBot.first_name
- ShellBot.token
- ShellBot.ListUpdates
- ShellBot.TotalUpdates
- ShellBot.OffsetEnd
- ShellBot.OffsetNext
- ShellBot.getConfig
- ShellBot.regHandleFunction
- ShellBot.regHandleExec
- ShellBot.watchHandle
- ShellBot.InlineKeyboardButton
- ShellBot.InlineKeyboardMarkup
- ShellBot.ReplyKeyboardMarkup
- ShellBot.KeyboardButton
- ShellBot.ForceReply
- ShellBot.ReplyKeyboardRemove
- ShellBot.inputMedia
- ShellBot.downloadFile
- ShellBot.stickerMaskPosition
- ShellBot.InlineQueryResult
- ShellBot.InputMessageContent
- ShellBot.ChatPermissions
- ShellBot.KeyboardButtonPollType
- ShellBot.setMessageRules
- ShellBot.BotCommand
- ShellBot.manageRules
-
Mètodos
- ShellBot.getWebhookInfo
- ShellBot.deleteWebhook
- ShellBot.setWebhook
- ShellBot.setChatPhoto
- ShellBot.deleteChatPhoto
- ShellBot.setChatTitle
- ShellBot.setChatDescription
- ShellBot.pinChatMessage
- ShellBot.unpinChatMessage
- ShellBot.restrictChatMember
- ShellBot.promoteChatMember
- ShellBot.exportChatInviteLink
- ShellBot.sendVideoNote
- ShellBot.getMe
- ShellBot.answerCallbackQuery
- ShellBot.sendMessage
- ShellBot.forwardMessage
- ShellBot.sendPhoto
- ShellBot.sendAudio
- ShellBot.sendDocument
- ShellBot.sendSticker
- ShellBot.sendVideo
- ShellBot.sendVoice
- ShellBot.sendLocation
- ShellBot.sendVenue
- ShellBot.sendContact
- ShellBot.sendChatAction
- ShellBot.getUserProfilePhotos
- ShellBot.getFile
- ShellBot.kickChatMember
- ShellBot.leaveChat
- ShellBot.unbanChatMember
- ShellBot.getChat
- ShellBot.getChatAdministrators
- ShellBot.getChatMembersCount
- ShellBot.getChatMember
- ShellBot.editMessageText
- ShellBot.editMessageCaption
- ShellBot.editMessageReplyMarkup
- ShellBot.deleteMessage
- ShellBot.getStickerSet
- ShellBot.uploadStickerFile
- ShellBot.createNewStickerSet
- ShellBot.addStickerSet
- ShellBot.setStickerPositionInSet
- ShellBot.deleteStickerFromSet
- ShellBot.editMessageLiveLocation
- ShellBot.stopMessageLiveLocation
- ShellBot.setChatStickerSet
- ShellBot.deleteChatStickerSet
- ShellBot.sendMediaGroup
- ShellBot.editMessageMedia
- ShellBot.sendAnimation
- ShellBot.answerInlineQuery
- ShellBot.setChatPermissions
- ShellBot.setChatAdministratorCustomTitle
- ShellBot.sendPoll
- ShellBot.setMyCommands
- ShellBot.getMyCommands
- ShellBot.sendDice
- ShellBot.getUpdates