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.

Figura 1 - Bloco Enviar ação de bate-papo

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. 

Figura 2 - Função que informa ao usuário que o bot está digitando uma mensagem

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

Figura 2.1 - Mensagem de ação informada pelo bot

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

Figura 2.2 - Mensagem enviada pelo bloco Enviar mensagem