proton_send_email

Proton Mail · macOS · Windows

Efeito: envio. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Envia uma mensagem de texto simples a partir de um endereço do Proton Mail conectado, pelo Proton Mail Bridge neste computador. A primeira chamada retorna uma prévia com remetente, destinatários, assunto e corpo, e não se conecta a nada; confirm=true envia. Sem anexos. Exige um plano do Proton que inclua o Bridge, com o Bridge em execução.

Entradas obrigatórias

to
subject
body

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.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "account": {
      "description": "The Proton Mail account: its address, as proton_connect lists it. Optional when one account is connected.",
      "type": "string"
    },
    "body": {
      "description": "Plain text.",
      "type": "string"
    },
    "cc": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Copy recipients, the same form as `to`."
    },
    "confirm": {
      "description": "Must be true to send. Without it the call returns a preview and sends nothing.",
      "type": "boolean"
    },
    "subject": {
      "type": "string"
    },
    "to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Recipient address, or several (an array, or separated by commas)."
    }
  },
  "required": [
    "to",
    "subject",
    "body"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para proton_send_email. 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.

{
  "body": "Can we review the launch checklist on Tuesday?",
  "confirm": false,
  "subject": "Planning meeting",
  "to": "sam@example.com"
}

Windows