connect_m365_account
Microsoft 365 · macOS · Windows
Efecto: escritura. 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
Conecta una cuenta de Microsoft 365 (o agrega otra, o vuelve a iniciar sesión en una). La primera llamada devuelve una vista previa y no inicia nada; confirm: true obtiene un código de inicio de sesión. Vuelve a llamar después de autenticarte en microsoft.com/devicelogin para terminar la conexión. Pasa include_channel_messages: true para leer también los mensajes de canales de Teams y buscar en ellos; ese permiso necesita a un administrador de tu organización de Microsoft 365, y sin esa aprobación se rechaza el inicio de sesión y la cuenta conserva su acceso actual.
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 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": {
"account_type": {
"description": "\"work\" (default): a work or school Microsoft 365 account — mail, calendar, contacts, Teams. \"personal\": an Outlook.com / Hotmail / Live account — mail, calendar and contacts only (Microsoft has no Teams chats or directory for personal accounts, and asking for them makes Microsoft refuse the sign-in as an 'expired code'). Ask the person which one it is when unsure.",
"enum": [
"work",
"personal"
],
"type": "string"
},
"confirm": {
"description": "Must be true to start the sign-in. Without it the call returns a preview and does nothing.",
"type": "boolean"
},
"include_channel_messages": {
"description": "Also request access to Teams channel messages and message search. Needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para connect_m365_account. 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.
{
"confirm": false
}Windows
Propósito
Conecta una cuenta de Microsoft 365 (o agrega otra, o vuelve a iniciar sesión en una). La primera llamada devuelve una vista previa y no inicia nada; confirm=true obtiene un código de inicio de sesión, y luego hay que volver a llamar tras autenticarse en microsoft.com/devicelogin para terminar. Pasa include_channel_messages: true para leer también los mensajes de canales de Teams y buscar en ellos; ese permiso necesita a un administrador de tu organización de Microsoft 365, y sin esa aprobación se rechaza el inicio de sesión y la cuenta conserva su acceso actual.
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 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 — Windows
{
"properties": {
"confirm": {
"description": "Must be true to start the sign-in. Without it, returns a preview.",
"type": "boolean"
},
"include_channel_messages": {
"description": "Also request access to Teams channel messages and message search. That permission needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para connect_m365_account. 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.
{
"confirm": false
}