teams_search_messages
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
Busca en los mensajes de chat y de canal de Microsoft Teams de una cuenta de Microsoft 365 con Microsoft Search: por texto y, opcionalmente, por remitente e intervalo de fechas. Úsala para encontrar dónde se habló de algo sin saber en qué chat. Los resultados llegan en el orden de relevancia de Microsoft (no del más reciente al más antiguo), y body es un fragmento alrededor de la coincidencia, no el mensaje completo; lee el chat con teams_read_chat_messages para obtener el resto. Devuelve como máximo 100 resultados de como máximo 4 páginas de la búsqueda. Cuando la lectura se corta (por ese límite, o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true. Requiere una cuenta profesional o educativa de Microsoft 365 conectada con connect_m365_account (las cuentas personales de Microsoft no permiten lecturas de Teams).
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"
},
"from_sender": {
"description": "Only messages from this sender (name or email; optional)",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "integer"
},
"query": {
"description": "Text to search for",
"type": "string"
},
"since": {
"description": "Only messages on/after this date, YYYY-MM-DD (optional)",
"type": "string"
},
"until": {
"description": "Only messages on/before this date, YYYY-MM-DD (optional)",
"type": "string"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para teams_search_messages. 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,
"query": "launch checklist"
}Windows
Propósito
Busca en el historial de chats y mensajes directos de Microsoft Teams (todas las conversaciones a la vez) por texto, remitente o intervalo de fechas. Úsala para encontrar dónde se habló de algo sin saber en qué chat. Devuelve los mensajes coincidentes (los más relevantes primero), cada uno con un fragmento y el chat de origen. Devuelve como máximo 100 resultados de como máximo 4 páginas de la búsqueda. Cuando la lectura se corta (por ese límite, o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true.
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"
},
"from_sender": {
"description": "Filter to a sender by name (optional)",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "integer"
},
"query": {
"description": "Text to find in messages",
"type": "string"
},
"since": {
"description": "Only messages on/after this date, YYYY-MM-DD (optional)",
"type": "string"
},
"until": {
"description": "Only messages on/before this date, YYYY-MM-DD (optional)",
"type": "string"
}
},
"type": "object"
}Ejemplo documental
Ejemplo de documentación para teams_search_messages. 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,
"query": "launch checklist"
}