send_message

macOS

Objectif

Envoie un iMessage via Messages.app du Mac à un identifiant de destinataire (numéro de téléphone avec indicatif du pays, par exemple +14155551234, ou e-mail d'identifiant Apple). Il s'agit d'une opération d'écriture : le premier appel (sans confirm) renvoie un aperçu ; rappelez avec confirm=true pour envoyer réellement. iMessage direct (1:1) uniquement : l'envoi dans une conversation de groupe existante n'est pas encore pris en charge. Vous pouvez joindre des fichiers (une photo, un PDF, une vCard) via `attachments` : chacun est envoyé comme son propre iMessage, dans l'ordre, avant le texte. Si toutes les pièces jointes échouent, le texte n'est pas envoyé non plus ; si certaines passent, le texte est tout de même envoyé et `attachments_failed` liste celles qui n'ont pas abouti. Un envoi que Messages refuse revient sous forme d'erreur, et non d'un résultat avec sent=false. Nécessite que Messages.app soit connecté à iMessage + l'autorisation d'automatisation. send_message n'atteint qu'iMessage : un contact qui n'est pas sur iMessage (une conversation SMS / à bulles vertes) ne peut pas recevoir de message avec cet outil, et le relais SMS via l'iPhone n'est pas pris en charge.

Entrées requises

• to
• text

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

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

Exemple documentaire

Exemple de documentation pour send_message. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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