teams_send_channel_message

Microsoft Teams · macOS · Windows

Efecto: envío. 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

Envía un mensaje de texto a un canal de Microsoft Teams a través de Graph API. Requiere connect_m365_account con permisos Chat.ReadWrite / ChannelMessage.Send. team_id y channel_id deben provenir de teams_list_teams / teams_list_channels. La primera llamada devuelve una vista previa; establezca confirm=true para enviar.

Entradas obligatorias

team_id
channel_id
text

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 declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

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": {
    "channel_id": {
      "description": "Channel ID from teams_list_channels, or the channel's name",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "type": "boolean"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams, or the team's name",
      "type": "string"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id",
    "text"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para teams_send_channel_message. 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",
  "confirm": false,
  "team_id": "demo-team-001",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows