Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Use este bloco quando precisar informar ao usuário que algo está acontecendo do lado do bot. O status é definido para 5 segundos ou menos. Quando chega uma mensagem do seu bot, os clientes do Telegram limpam o status de digitação. Para mais detalhes, acesse a documentação oficial.
Informações |
---|
Para utilizar este bloco, é preciso ter o plugin Telegram Bot instalado no seu projeto. Acesse a documentação do Cronapp Plugin Telegram Bot para mais detalhes. |
Image Added
Figura 1 - Bloco Enviar ação de bate-papi
Compatibilidade
- Bloco servidor: cronapp.framework.telegram.BotOperations.sendChatAction()
Retorno
Retorna o valor boleano 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 vo,
- upload_document: para arquivos gerai,
- 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.
Image Added
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.
Image Added
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.
Image Added
Figura 2.2 - Mensagem enviada pelo bloco Enviar mensagem
Nesta página
Índice