# Cliente. Lista de chats (TelegramClientGetChats)

Se devuelven todos los chats del usuario: chats grupales, canales, 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">Conexión</td><td valign="top">[Enlace] Objeto de conexión del cliente. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Conexión", del bloque "Cliente. Crear conexión" del grupo Telegram, que se utilizó anteriormente para conectar el cliente Telegram.</td></tr><tr><td valign="top">Filtro</td><td valign="top">[Texto] Cadena para filtrar la lista de chats. Se busca la ocurrencia del valor dado en los chats (Id, Título) y en los diálogos (Id, Nombre, Apellido, Nombre de usuario, Teléfono).</td></tr><tr><td valign="top">Devolver como lista</td><td valign="top"><p>Si se activa, el resultado se devolverá como una lista de objetos de chat. Propiedades disponibles: Id; Título; IsPrivate - indica que este chat es privado con el Usuario.</p><p>Si la propiedad es igual a $true (y también se activa la propiedad "Extraer datos del usuario"), entonces están disponibles las siguientes propiedades: UserId; UserName; PhoneNumber.</p><p>También están disponibles las propiedades Chat y User, que apuntan a estos objetos de Telegram.</p></td></tr><tr><td valign="top">Extraer datos del usuario</td><td valign="top">Si se activa la propiedad "Devolver como lista", al activar esta propiedad se extraerán los datos del Usuario para chats privados.</td></tr><tr><td valign="top">Lista de chats</td><td valign="top"><p>[Diccionario/Lista] La lista de chats se devuelve en forma de diccionario. Las claves del diccionario son el nombre del chat, y los valores son el id del chat.</p><p>Por ejemplo: $chatid = $Chats["username"]. Obtenemos el valor id del chat con el Usuario username, luego esta variable se puede usar en los bloques de envío de mensajes.</p><p>Si se devuelve una lista, entonces están disponibles las siguientes propiedades: Id, Título, UserId, Nombre de usuario, PhoneNumber.</p></td></tr><tr><td valign="top">Nivel de manejo</td><td valign="top"><p>Selección del nivel de manejo de errores. Valores posibles:</p><ul><li>"Default" - por defecto;</li><li>"Ignore" - se ignoran los errores;</li><li>"Handle" - se manejan los errores.</li></ul><p>Si se selecciona el valor "Default", se utilizará el valor del bloque "Inicio" de este diagrama.</p></td></tr><tr><td valign="top">Nivel de mensajes</td><td valign="top"><p>Selección del nivel de mensajes que mostrarán los bloques durante la operación. Valores posibles:</p><ul><li>"Default" - por defecto;</li><li>"Release" - salida desactivada;</li><li>"Debug" - salida de información principal;</li><li>"Detailed" - salida de información detallada.</li></ul><p>Si se selecciona el valor "Default", se utilizará el valor del bloque "Inicio" de este diagrama.</p></td></tr><tr><td valign="top">Texto de error</td><td valign="top">[Texto] Devuelve información detallada sobre el error en caso de que la ejecución del bloque no sea correcta.</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/es/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.