# Cliente. Lista de chats (TelegramClientGetChats)

Retorna todos os chats do usuário: chats em grupo, canais, diálogos.

<table data-header-hidden><thead><tr><th width="239" valign="top"></th><th width="321" valign="top"></th></tr></thead><tbody><tr><td valign="top">Conexão</td><td valign="top">[Link] Objeto de conexão do cliente. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Conexão", do bloco "Cliente. Criar conexão" do grupo Telegram, que foi usado anteriormente para conectar o cliente Telegram.</td></tr><tr><td valign="top">Filtro</td><td valign="top">[Texto] String para filtrar a lista de chats. Procura a ocorrência do valor fornecido nos chats (Id, Título) e nos diálogos (Id, Primeiro Nome, Último Nome, Nome de Usuário, Telefone).</td></tr><tr><td valign="top">Retornar como lista</td><td valign="top"><p>Quando ativado, o resultado será retornado como uma lista de objetos de chat. Propriedades disponíveis: Id; Título; IsPrivate - indica que este chat é privado com o Usuário.</p><p>Se a propriedade for igual a $true (e a propriedade "Extrair dados do usuário" também estiver ativada), as seguintes propriedades estarão disponíveis: UserId; UserName; PhoneNumber.</p><p>As propriedades Chat e User também estão disponíveis, apontando para esses objetos do Telegram.</p></td></tr><tr><td valign="top">Extrair dados do usuário</td><td valign="top">Se a propriedade "Retornar como lista" estiver ativada, ao ativar esta propriedade, os dados do Usuário para chats privados serão extraídos.</td></tr><tr><td valign="top">Lista de chats</td><td valign="top"><p>[Dicionário/Lista] A lista de chats é retornada na forma de um dicionário. As chaves do dicionário são os nomes dos chats, e os valores são os ids dos chats.</p><p>Por exemplo: $chatid = $Chats["username"]. Obtemos o valor id do chat com o Usuário username, e essa variável pode ser usada em blocos de envio de mensagens.</p><p>Se uma lista for retornada, as seguintes propriedades estarão disponíveis: Id, Título, UserId, Nome de Usuário, Telefone.</p></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, o valor do bloco "Início" deste diagrama será utilizado.</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, o valor do bloco "Início" deste diagrama será utilizado.</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/klient.-spisok-chatov-telegramclientgetchats.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.