send_message

macOS

Zweck

Sendet eine iMessage über die Messages.app des Mac an ein Empfänger-Handle (Telefonnummer mit Ländervorwahl, z. B. +14155551234, oder eine Apple-ID-E-Mail-Adresse). Dies ist eine Schreiboperation: Der erste Aufruf (ohne confirm) gibt eine Vorschau zurück; rufen Sie erneut mit confirm=true auf, um tatsächlich zu senden. Nur direkte (1:1) iMessage – das Senden in einen bestehenden Gruppenchat wird noch nicht unterstützt. Optional können Dateien (ein Foto, ein PDF, eine vCard) über `attachments` angehängt werden – jede wird der Reihe nach vor dem Text als eigene iMessage gesendet. Schlagen alle Anhänge fehl, wird auch der Text nicht gesendet; gelingen einige, wird der Text dennoch gesendet und `attachments_failed` listet auf, was nicht durchgegangen ist. Ein Versand, den Messages ablehnt, kommt als Fehler zurück, nicht als Ergebnis mit sent=false. Erfordert, dass Messages.app bei iMessage angemeldet ist, sowie die Automatisierungsberechtigung. send_message erreicht nur iMessage: Einem Kontakt, der nicht bei iMessage ist (eine SMS-Konversation / grüne Sprechblasen), kann mit diesem Tool keine Nachricht gesendet werden, und die SMS-Weiterleitung über das iPhone wird nicht unterstützt.

Erforderliche Eingaben

• to
• text

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für send_message. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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