Pour les raccourcis, les scripts et les autres apps

Un lien, et un nouveau message est ouvert dans Postfach.

Postfach a son propre lien, postfach://. Avec lui, un raccourci sur votre iPhone, iPad ou Mac, un script, une page web ou votre propre app ouvre Postfach, ou commence un nouveau message avec les destinataires, l'objet et le texte déjà remplis. Le message vous attend : un lien n'envoie jamais rien.

Télécharger Exemples

À partir de Postfach 1.7.3, sur Mac, iPhone et iPad.

Les liens.

Un lien peut faire deux choses : ouvrir Postfach, ou y ouvrir un nouveau message.

Lien	Ce qu'il fait
`postfach://`	Ouvre Postfach. Sur le Mac, quand toutes les fenêtres sont fermées, il ouvre la fenêtre principale.
`postfach://compose?to=…&subject=…&body=…`	Ouvre un nouveau message avec les destinataires, l'objet et le texte que le lien indique.
`postfach://compose/anna@example.org?subject=…`	La même chose, avec les adresses avant le point d'interrogation, là où un lien `mailto:` les a. Ainsi, `mailto:` devient un lien Postfach quand `postfach://compose/` prend sa place.

Ce qu'un nouveau message peut contenir.

Les champs sont ceux d'un lien mailto:, lus de la même manière. Écrivez chaque valeur encodée en pourcentage : une espace s'écrit %20, un retour à la ligne %0A et une esperluette dans un texte %26. Un plus reste un plus.

Le message est écrit depuis le compte du dossier où vous vous trouvez, comme avec « Nouveau message », et vous pouvez en choisir un autre sous « De » avant de l'envoyer.

to, cc, bcc : une adresse ou plusieurs, séparées par des virgules, avec un nom si vous le souhaitez : Anna%20Keller%20%3Canna@example.org%3E
subject : une ligne
body : le texte, retours à la ligne compris
Jusqu'à 100 destinataires, 1000 caractères d'objet et 100 000 de texte. Tout ce qu'un lien indique d'autre, un expéditeur ou une pièce jointe, est laissé de côté

Exemples.

Le même lien fonctionne sur l'iPhone, l'iPad et le Mac.

Un raccourci qui écrit toujours à la même personne

Dans l'app Raccourcis, ajoutez l'action « Ouvrir les URL » avec un lien comme celui-ci. Placez le raccourci sur votre écran d'accueil, et un message à votre équipe n'est plus qu'à un toucher.

postfach://compose?to=team@example.org&subject=Weekly%20report

Envoyer à Postfach ce que vous partagez

Un raccourci qui reçoit du texte de la feuille partagée : encodez le texte avec « Encodage d'URL », placez-le dans un lien avec l'action « Texte », puis passez le lien à « Ouvrir les URL ». Dans n'importe quelle app, « Partager » commence alors un message dans Postfach avec le texte partagé.

postfach://compose?subject=Shared&body=[Texte d'URL encodée]

Un lien `mailto:`, dans Postfach

Sur l'iPhone et l'iPad, un lien mailto: ouvre l'app de messagerie choisie dans Réglages. Un raccourci avec « Remplacer le texte » en fait un lien Postfach : cherchez mailto:, remplacez-le par postfach://compose/, puis « Ouvrir les URL ». Sur le Mac, rien de tout cela n'est nécessaire : choisissez Postfach dans Mail › Réglages › Général › « Application de messagerie par défaut ».

mailto:anna@example.org?subject=Hello
postfach://compose/anna@example.org?subject=Hello

Depuis le Terminal ou un script sur le Mac

La commande open passe un lien à Postfach, tout comme open location en AppleScript. Un script qui compile ou teste quelque chose peut vous laisser le message prêt à relire.

open "postfach://compose?to=team@example.org&subject=Build%20finished&body=All%20tests%20passed."

osascript -e 'open location "postfach://compose?subject=Hello"'

Depuis votre propre app

Encodez vous-même chaque valeur, en ne laissant telles quelles que les lettres et les chiffres. URLComponents laisse une esperluette telle quelle dans une valeur, ce qui y termine le champ. Pour savoir d'abord si Postfach est installé, ajoutez postfach à LSApplicationQueriesSchemes dans l'Info.plist de votre app et appelez canOpenURL.

func encoded(_ text: String) -> String {
    text.addingPercentEncoding(withAllowedCharacters: .alphanumerics) ?? ""
}

let link = "postfach://compose"
    + "?to=\(encoded("anna@example.org"))"
    + "&subject=\(encoded("Build 185"))"
    + "&body=\(encoded("It's on TestFlight & ready."))"

if let url = URL(string: link) {
    UIApplication.shared.open(url)    // NSWorkspace.shared.open(url) sur le Mac
}

Sur une page web

Un lien sur une page ouvre Postfach pour un lecteur qui l'a. Pour tous les autres, il ne se passe rien : sur une page destinée au public, un lien mailto: reste donc le meilleur choix.

<a href="postfach://compose?to=support@example.org">Écrire avec Postfach</a>

Ce qu'un lien ne fait pas.

N'importe qui peut écrire un lien, sur n'importe quelle page ou dans n'importe quelle app : un lien ne fait donc que remplir un message. Vous le voyez, et vous décidez.

Il n'envoie rien : c'est vous qui appuyez sur « Envoyer »
Il ne joint aucun fichier et ne choisit pas le compte depuis lequel un message est envoyé
Il ne lit pas votre courrier, n'y cherche rien et n'ouvre aucun message
Il ne renvoie aucune réponse à l'app qui l'a ouvert
Sans compte capable d'envoyer, il ouvre Postfach et rien de plus
Il ne fait pas de Postfach l'app de messagerie par défaut sur l'iPhone et l'iPad, où un lien mailto: ouvre toujours celle choisie dans Réglages
L'iPhone et l'iPad peuvent demander s'il faut ouvrir Postfach avant de lui passer un lien

Obtenir Postfach.

Sur Mac, iPhone et iPad. Depuis l'App Store, un seul achat pour les trois.