# Bot. Receber Mensagem

Recebe uma mensagem ou callback da fila. Se não houver mensagens na fila, um erro é gerado.

<table data-header-hidden><thead><tr><th width="250" valign="top"></th><th width="293" valign="top"></th></tr></thead><tbody><tr><td valign="top">Conexão</td><td valign="top">[Link] Objeto de conexão ao bot. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Conexão", do bloco "Bot. Criar Conexão" do grupo Telegram, que foi usado anteriormente para conectar ao bot Telegram.</td></tr><tr><td valign="top">Aguardar Mensagem</td><td valign="top">Quando ativado, o bloco aguardará novas mensagens. Caso contrário, se não houver mensagem, um erro será gerado.</td></tr><tr><td valign="top">Mensagem</td><td valign="top"><p>[Link] Retorna o objeto mensagem. Propriedades disponíveis:</p><ul><li>Id - id da mensagem;</li><li>ChatId - id do chat;</li><li>From - nome do Usuário que enviou a mensagem;</li><li>Text - texto da mensagem;</li><li>Type - designação textual do tipo de mensagem;</li><li>IsFile - indica se há um arquivo na mensagem (aqui é possível determinar mais precisamente o tipo usando as propriedades IsDocument, IsPhoto, IsVoice). Por exemplo: $TMessage.IsPhoto - se for igual a $true, então há uma foto na mensagem.</li></ul></td></tr><tr><td valign="top">Callback</td><td valign="top"><p>[Lógico] Se ativado, a mensagem contém dados sobre o callback (pressionamento de botão). Propriedades disponíveis:</p><ul><li>IsCallback - se ativado, é um callback;</li><li>CallbackData - string com os dados do botão pressionado (esses dados são definidos no dicionário no bloco "Bot. Enviar Mensagem";</li><li>Callback - objeto de callback.</li></ul></td></tr><tr><td valign="top">Nível de Tratamento</td><td valign="top"><p>Seleção do nível de tratamento de erros. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Ignore" - erros são ignorados;</li><li>"Handle" - erros são tratados.</li></ul><p>Se o valor "Default" for selecionado, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Nível de Mensagens</td><td valign="top"><p>Seleção do nível de mensagens que os blocos exibirão durante a operação. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Release" - saída desativada;</li><li>"Debug" - saída de informações principais;</li><li>"Detailed" - saída de informações detalhadas.</li></ul><p>Se o valor "Default" for selecionado, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Texto do Erro</td><td valign="top">[Texto] Retorna informações detalhadas sobre o erro em caso de execução incorreta do bloco.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/spravochnik-blokov/telegram/bot.-poluchit-soobshenie-telegrambotreceived.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.