m365_create_contact
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
Úsala cuando el usuario quiera agregar un contacto nuevo a sus contactos de Microsoft 365 / Outlook. Indica al menos un nombre o un correo. Necesita la cuenta conectada con scopes_for: ["contacts"].
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": {
"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"
},
"company": {
"description": "Company.",
"type": "string"
},
"confirm": {
"description": "Ignored; kept for older clients.",
"type": "boolean"
},
"emails": {
"description": "Up to 3 e-mail addresses.",
"items": {
"type": "string"
},
"type": "array"
},
"given_name": {
"description": "First name.",
"type": "string"
},
"mobile": {
"description": "Mobile phone.",
"type": "string"
},
"name": {
"description": "The name shown for the contact (default: first and last name).",
"type": "string"
},
"notes": {
"description": "Notes.",
"type": "string"
},
"phones": {
"description": "Up to 2 business phones.",
"items": {
"type": "string"
},
"type": "array"
},
"surname": {
"description": "Last name.",
"type": "string"
},
"title": {
"description": "Job title.",
"type": "string"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para m365_create_contact. 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.
{
"company": "Example Co",
"confirm": false,
"emails": [
"alex@example.com"
],
"given_name": "Alex",
"surname": "Rivera"
}Windows
Propósito
Crea un contacto en los contactos (Outlook) de la cuenta de Microsoft 365: nombre, correos, teléfonos, empresa, cargo y notas; al menos un campo. La cuenta debe haber concedido el permiso de contactos (consent_required con scopes_for ["contacts"] indica cómo).
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": {
"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"
},
"company": {
"description": "Company",
"type": "string"
},
"confirm": {
"description": "Ignored; kept for older clients.",
"type": "boolean"
},
"emails": {
"description": "Email addresses (at most 3)",
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"given_name": {
"description": "First name",
"type": "string"
},
"mobile": {
"description": "Mobile phone",
"type": "string"
},
"notes": {
"description": "Notes",
"type": "string"
},
"phones": {
"description": "Business phones",
"items": {
"type": "string"
},
"type": "array"
},
"surname": {
"description": "Last name",
"type": "string"
},
"title": {
"description": "Job title",
"type": "string"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para m365_create_contact. 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.
{
"company": "Example Co",
"confirm": false,
"emails": [
"alex@example.com"
],
"given_name": "Alex",
"surname": "Rivera"
}