send_message

macOS

Scopo

Invia un iMessage tramite Messages.app del Mac a un handle destinatario (numero di telefono con prefisso internazionale, ad es. +14155551234, oppure un'e-mail dell'ID Apple). È un'operazione di scrittura: la prima chiamata (senza confirm) restituisce un'anteprima; richiama con confirm=true per inviare davvero. Solo iMessage diretto (1:1): l'invio in una chat di gruppo esistente non è ancora supportato. Facoltativamente allega file (una foto, un PDF, una vCard) tramite `attachments`: ognuno viene inviato come iMessage a sé, in ordine, prima del testo. Se tutti gli allegati falliscono, non viene inviato nemmeno il testo; se alcuni riescono, il testo viene comunque inviato e `attachments_failed` elenca ciò che non è andato a buon fine. Un invio che Messages rifiuta torna come errore, non come risultato con sent=false. Richiede Messages.app con accesso a iMessage effettuato + autorizzazione di Automazione. send_message raggiunge solo iMessage: a un contatto che non è su iMessage (una conversazione SMS / a bolle verdi) non è possibile scrivere con questo strumento, e l'inoltro degli SMS tramite iPhone non è supportato.

Input obbligatori

• to
• text

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del 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"
}

Esempio documentale

Esempio di documentazione per send_message. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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