teams_send_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 chat o canal de Microsoft Teams. Requiere que Microsoft Teams esté en ejecución y que haya iniciado sesión (el token se lee desde las cookies locales de Teams en cada llamada). `chat_id` DEBE provenir de una llamada anterior de teams_list_chats; nunca invente identificadores. Esta es una operación de escritura: la primera llamada devuelve una vista previa, la segunda llamada (con confirm=true) realmente envía. `sent:true` significa que el mensaje fue leído de la conversación (entrega verificada): confía en ESE campo, no en una lectura de seguimiento: teams_search_messages y teams_read_chat_messages leen el propio índice de sincronización local de Teams, que puede retrasar un envío verificado por minutos (caso único observado: 3 min, #2285). Una lectura de un hermano con resultado cero justo después del envío NO demuestra que el envío falló. Una respuesta con estado "sent_unconfirmed" significa que el servidor aceptó el POST pero NO se pudo verificar el mensaje; dígale al usuario que abra Teams y verifique antes de asumir que se notificó al destinatario.

Entradas obligatorias

chat_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": {
    "chat_id": {
      "description": "Thread id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<uuid>@thread.tacv2' for group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview without making any network call.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments in v1.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Ejemplo documental

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

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows