Use este bloco quando precisar informar ao usuário que algo está acontecendo do lado do bot, o status da ação será exibido no cabeçalho, junto do nome do bot. O status é definido para 5 segundos ou menos. Quando a mensagem (texto, vídeo, áudio, ...) do bot chegar no cliente, o status da ação é limpo automaticamente. Para mais detalhes, acesse a documentação oficial.

Open

Compatibilidade

• Bloco servidor: cronapp.framework.telegram.BotOperations.sendChatAction()

Retorno

Retorna o valor booleano true, em caso de sucesso.

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á a mensagem de ação do bot. 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"

Ação

Tipo de ação a ser transmitida. 

• Posição: 3

• Inglês: Action

• Tipo: Texto / String 

• Exemplo: "typing"

• Opções:

  • typing: para mensagens de texto.

  • upload_photo: para fotos.

  • record_video ou upload_video: para vídeos.

  • record_voice ou upload_voice: para notas de voz.

  • upload_document: para arquivos gerais.

  • Choose_sticker: para figurinhas.

  • find_location: para dados de localização.

  • record_video_note: ou upload_video_note: para notas de vídeo.

Exemplo

No exemplo da figura abaixo, estamos enviando uma mensagem para um usuário específico, identificado através dos parâmetros passados no bloco. Para informar ao usuário que a mensagem está sendo enviada, inserimos o bloco Enviar ação de bate-papo com a Ação "typing". Como a ação foi bem sucedida, o bloco retornou o valor booleano "true", em conjunto com os dados da mensagem enviada pelo bloco Enviar mensagem. 

Open

A mensagem de ação informada pelo bot pode ser vista na figura 2.1.

Open

Após a mensagem de ação ser exibida, a função envia a mensagem contida no bloco Enviar mensagem, confira na figura abaixo.

Open

Nesta página