teams_list_chats
Microsoft Teams · macOS · Windows
Efecto: lectura. Estado: disponibilidad controlada.
«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.
macOS
Propósito
Lista los chats de Microsoft Teams de una cuenta de Microsoft 365 (mensajes directos, chats de grupo y chats de reunión), los de actividad más reciente primero, leídos desde Microsoft 365. Cada chat tiene su id (para teams_read_chat_messages), un título, los demás participantes, su tipo (oneOnOne, group o meeting) y su último mensaje. participants nombra a todos los demás miembros; uno cuyo nombre no se pudo leer aparece como "unnamed member" (o "unnamed member (external)"), nunca como nada. participants_state indica cuánto fiarse de ello: resolved, unresolved (al menos uno sin nombre), only_you (nadie más en el chat) o unknown (no se pudo leer la lista de miembros: participant_count y has_external_members están entonces ausentes). Lee como máximo 20 páginas de 50 chats. Cuando la lectura se corta (por ese límite o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true. Necesita una cuenta de Microsoft 365 de trabajo o escuela conectada con connect_m365_account (las cuentas personales de Microsoft no tienen lecturas de Teams). Cuando no hay ninguna cuenta de Microsoft 365 conectada, lee en su lugar la caché local de la app Teams en este Mac (necesita Acceso total al disco, puede ir horas o días atrasada); el source de la respuesta indica cuál respondió (graph o local_cache).
Entradas obligatorias
El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.
Permisos y confirmación
El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.
- Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.
Esquema técnico canónico en inglés — macOS
{
"properties": {
"account": {
"description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
"type": "string"
},
"limit": {
"description": "Max items to return (default 50)",
"type": "integer"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para teams_list_chats. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.
{
"limit": 5
}Windows
Propósito
Lista tus conversaciones de chat recientes de Microsoft Teams mediante Microsoft Graph, usando la cuenta de Microsoft 365 conectada. Lee como máximo 20 páginas de 50 chats. Cuando la lectura se corta (por ese límite o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true. participants nombra a todos los demás miembros; uno cuyo nombre no se pudo leer aparece como "unnamed member" (o "unnamed member (external)"), nunca como nada. participants_state indica cuánto fiarse de ello: resolved, unresolved (al menos uno sin nombre), only_you (nadie más en el chat) o unknown (no se pudo leer la lista de miembros: participant_count y has_external_members están entonces ausentes).
Entradas obligatorias
El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.
Permisos y confirmación
El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.
- Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.
Esquema técnico canónico en inglés — Windows
{
"properties": {
"account": {
"description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
"type": "string"
},
"limit": {
"description": "Maximum chats to return (default: 50)",
"type": "number"
}
},
"type": "object"
}Ejemplo documental
Ejemplo de documentación para teams_list_chats. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.
{
"limit": 5
}