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

« Anterior Versão 4 Próxima »

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: Inteiro / Integer

  • Exemplo: 5

Deslocamento


  • Posição: 3
  • Inglês: offset
  • Tipo: Inteiro / Integer

  • 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: 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.


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.


Figura 2.1 - Resultado da execução do bloco

Nesta página

  • Sem rótulos