Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
O bloco Obter Atualizações é usado para receber atualizações de mensagens e eventos que ocorrem em um determinado chat ou canal. Quando esse método é acionado, o Telegram retorna um array de objetos json que representam as atualizações mais recentes desde o ponto em que o método foi chamado pela última vez.
Figura 1 - Bloco Obter Atualizações
Compatibilidade
- Bloco servidor: cronapp.framework.telegram.BotOperations.getUpdates()
Retorno
Retorna uma lista de objetos json.
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
"
Limite
Parâmetro opcional. Limita o número de atualizações a serem recuperada. Valores entre 1 e 100 são aceitos. O padrão é 100
- Posição: 2
- Inglês: Limit
- Tipo: Texto Inteiro / String Integer
Exemplo: 5
Deslocamento
- Posição: 3
- Inglês: offset
- Tipo: Texto Inteiro / StringInteger
Exemplo:
Atualizações permitidas
Parâmetro opcional. Recebe uma lista JSON serializada dos tipos de atualização que você deseja que seu bot receba.
- Posição: 4
- Inglês: Allowed Updates
- Tipo: Texto / String
Exemplo:
Exemplo
- Array de Strings / Array of Strings
Exemplo: especifique ["message", "edited_channel_post", "callback_query"] para receber apenas atualizações desses tipos. Especifique uma lista vazia para receber todos os tipos de atualização, exceto chat_member, message_reaction e message_reaction_count (padrão). Se não for especificado, a configuração anterior será usada.
Exemplo
No exemplo da função abaixo, inserimos o token de acesso ao bot como o primeiro parâmetro no bloco Obter Atualizações e limitamos o número máximo de respostas retornadas a cinco mensagens. Em seguida, inicializamos uma lista vazia chamada 'id' para armazenar os IDs dos usuários que interagem com o bot. Utilizamos um loop de repetição para acessar o caminho que contém o ID do usuário e, em seguida, o adicionamos à lista 'id'. Imprimimos a matriz de objetos contendo todos os parâmetros das mensagens dos usuários e, finalmente, exibimos os identificadores dos usuários que interagiram com o bot.
Image Added
Figura 2 - Função que obtém as atualizações do chat
O resultado da execução do bloco pode ser observado na figura abaixo.
Image Added
Figura 2.1 - Resultado da execução do blocoImage Removed
Nesta página
Índice |
---|