send_message

macOS

Propósito

Envía un iMessage a través de la aplicación Messages.app de Mac a un identificador de destinatario (número de teléfono con código de país, por ejemplo, +14155551234, o un correo electrónico de ID de Apple). Esta es una operación de escritura: la primera llamada (sin confirm) devuelve una vista previa; llame nuevamente con confirm=true para enviar realmente. Directo (1:1) solo para iMessage: aún no se admite el envío a un chat grupal existente. Opcionalmente se pueden adjuntar archivos (una foto, un PDF, una vCard) mediante `attachments`: cada uno se envía como un iMessage independiente, en orden, antes del texto. Si fallan todos los adjuntos, tampoco se envía el texto; si algunos se envían, el texto se envía igualmente y `attachments_failed` enumera lo que no pasó. Un envío que Messages rechaza se devuelve como un error, no como un resultado con sent=false. Requiere que Messages.app haya iniciado sesión en iMessage + permiso de automatización.

Entradas obligatorias

• to
• 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.

{
  "properties": {
    "attachments": {
      "description": "Files to send, as comma-separated absolute paths (e.g. a photo or PDF). Each is sent as a separate iMessage, before the text.",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to actually send. Without it, returns a preview only.",
      "type": "boolean"
    },
    "text": {
      "description": "Message body to send.",
      "type": "string"
    },
    "to": {
      "description": "Recipient handle: phone number with country code (+14155551234) or Apple ID email.",
      "type": "string"
    }
  },
  "required": [
    "to",
    "text"
  ],
  "type": "object"
}

Ejemplo documental

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

{
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?",
  "to": "+12025550123"
}