send_message

macOS

Finalidade

Envia um iMessage pelo Messages.app do Mac a um identificador de destinatário (número de telefone com código do país, por exemplo +14155551234, ou um e-mail de Apple ID). Esta é uma operação de escrita: a primeira chamada (sem confirm) retorna uma prévia; chame novamente com confirm=true para realmente enviar. Somente iMessage direto (1:1): o envio para um chat em grupo existente ainda não é suportado. Opcionalmente, anexe arquivos (uma foto, um PDF, um vCard) por `attachments`: cada um é enviado como seu próprio iMessage, em ordem, antes do texto. Se todos os anexos falharem, o texto também não é enviado; se alguns forem enviados, o texto ainda é enviado e `attachments_failed` lista o que não passou. Um envio que o Messages recusa volta como erro, não como um resultado com sent=false. Requer o Messages.app conectado ao iMessage + permissão de Automação. send_message alcança somente o iMessage: um contato que não está no iMessage (uma conversa por SMS / balão verde) não pode receber mensagens por esta ferramenta, e a retransmissão de SMS pelo iPhone não é suportada.

Entradas obrigatórias

• to
• text

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para send_message. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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