Saltar al contenido
Todas las herramientas

teams_read_channel_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

Lee las publicaciones más recientes de un canal de Microsoft Teams (team_id de teams_list_teams, channel_id de teams_list_channels), de la más antigua a la más reciente, desde Microsoft 365. Solo publicaciones de nivel superior: no se incluyen las respuestas. Leer los mensajes de un canal requiere un permiso que aprueba un administrador de la organización de Microsoft 365; sin él, la respuesta es consent_required e indica qué hacer. Lee como máximo 20 páginas de 50 publicaciones, incluidas las eliminadas. 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

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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.

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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para teams_read_channel_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.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}

Windows

Propósito

Lee mensajes de un canal de Teams específico (solo publicaciones de nivel superior; no se incluyen las respuestas). Lee como máximo 20 páginas de 50 publicaciones, incluidas las eliminadas. Cuando la lectura se corta (por ese límite, o porque la llamada se quedó sin tiempo), la respuesta incluye truncated: true.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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.

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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels (within that team)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum messages (default: 50)",
      "type": "number"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para teams_read_channel_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.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}