Sallyport
MenuFermer
Aller à la documentation
DocumentationE-mail

E-mail

Laissez un agent envoyer depuis votre boîte, la chercher, la lire et trier son courrier, pendant que Sallyport garde le mot de passe.

Sur cette page

Votre agent écrit le message et Sallyport l’envoie depuis votre propre boîte. Il cherche dans votre boîte de réception, lit les messages et les pièces jointes, déplace et marque le courrier. Le mot de passe reste dans Sallyport, et l’agent ne le voit jamais.

Connectez une boîte aux lettres

  • Ouvrez Connecter une boîte aux lettres. Depuis Clés de service, c’est « Ajouter une clé de service », puis « E-mail » dans « Source de la clé ».
  • Choisissez le « Fournisseur de messagerie » : Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo Mail, iCloud Mail, Fastmail, Zoho Mail ou « Votre propre serveur de messagerie ». Les serveurs, les ports et le chiffrement se remplissent et restent modifiables.
  • Saisissez l’« Adresse e-mail » et le « Mot de passe de la boîte ». La plupart des fournisseurs attendent ici un mot de passe d’application, et le formulaire mène à la page qui le délivre.
  • Appuyez sur « Tester la connexion ». Sallyport se connecte à chaque serveur et nomme celui qui a refusé.
  • Appuyez sur « Enregistrer la boîte ». Le mot de passe est scellé et ne peut pas être relu. Tous les agents de l’espace de travail reçoivent la boîte.
FournisseurMot de passe à utiliser
Gmail / Google WorkspaceUn mot de passe d’application. Google en délivre un dès que la validation en deux étapes est activée.
Outlook / Microsoft 365Le mot de passe de la boîte. Votre administrateur Microsoft 365 active SMTP AUTH et la connexion IMAP par mot de passe pour la boîte.
Yahoo MailUn mot de passe d’application depuis Sécurité du compte.
iCloud MailUn mot de passe pour app de votre compte Apple.
FastmailUn mot de passe d’application avec accès IMAP et SMTP.
Zoho MailUn mot de passe spécifique à l’application. Les boîtes d’organisation utilisent smtppro.zoho.com et imappro.zoho.com.

Une boîte envoie par son serveur SMTP et se lit par son serveur IMAP. Désactivez-en un dans « Envoi (SMTP) » ou « Lecture (IMAP) », et ses outils partent avec lui.

Se connecter avec Google ou Microsoft

Les boîtes Gmail et Microsoft 365 se connectent avec le fournisseur au lieu d’un mot de passe. Dans « Comment Sallyport se connecte », choisissez « Se connecter avec Google » ou « Se connecter avec Microsoft » et appuyez sur « Enregistrer et se connecter avec Google » ou « Enregistrer et se connecter avec Microsoft ». Le fournisseur vous demande d’autoriser l’accès et vous ramène à la page de la clé.

  • Sallyport garde le jeton dans le coffre et le renouvelle seul, comme toute clé avec connexion. Aucun mot de passe n’est stocké.
  • Google se connecte par l’application de Sallyport. Chez Microsoft, vous enregistrez votre propre application : le formulaire donne l’« URI de redirection » à ajouter et reçoit son « Client ID » et son « Client secret ». L’application a besoin de IMAP.AccessAsUser.All, SMTP.Send et offline_access.
  • Le jeton ne va qu’aux serveurs de messagerie du fournisseur : smtp.gmail.com et imap.gmail.com, ou smtp.office365.com, outlook.office365.com et smtp-mail.outlook.com.

Ce que l’agent peut faire

L’agent garde sa connexion MCP à Sallyport. Une boîte lui donne trois outils, au nom de la connexion :

OutilCe qu’il faitClasse
_readlist_folders ; search dans un dossier ; fetch d’un message par son uid ; un attachment par son part. Lire ne marque rien comme lu.Lecture
_sendEnvoie un message depuis la boîte : to, cc, bcc, subject, text, html, reply_to, in_reply_to, references et attachments.Écriture
_changemove et copy vers to_folder ; flag et unflag avec flags ; delete ; create_folder.Écriture. delete et le marquage deleted sont destructifs.
Arguments de _read · le courrier non lu de la facturation
{
  "operation": "search",
  "from": "[email protected]",
  "unseen": true
}
Arguments de _send · une réponse avec un fichier
{
  "to": "Ana Lima <[email protected]>",
  "bcc": "[email protected]",
  "subject": "Re: Invoice 42",
  "text": "Paid today. The receipt is attached.",
  "in_reply_to": "<[email protected]>",
  "attachments": [{ "filename": "receipt.csv", "content_type": "text/csv", "content_base64": "YW1vdW50LGR1ZQo0MjAwLEZyaWRheQo=" }],
  "intent": "Confirm the payment of invoice 42"
}
Arguments de _change · classer la facture payée
{
  "operation": "move",
  "uids": [4102],
  "to_folder": "Archive",
  "intent": "File the paid invoice"
}
  • search renvoie le total et les messages les plus récents, 20 par défaut et 100 au plus, chacun avec son uid, son expéditeur, son objet, sa date et ses marques.
  • fetch renvoie les en-têtes, le texte, le HTML et la liste des pièces jointes avec leur part.
  • Un message part toujours de la boîte elle-même. La copie cachée atteint ses destinataires et n’entre jamais dans le message.
  • Un changement ne touche que les messages qu’il nomme. Un uid absent du dossier revient dans missing.

Choisissez ce qui vous attend

Le courrier passe sans demander par défaut. Pour voir chaque message avant qu’il parte, ouvrez l’agent dans Agents, trouvez la boîte dans sa liste « Accès » et mettez la colonne d’écriture sur « Approbation requise », ou activez « Demander à chaque appel ».

La carte d’approbation montre chaque destinataire, copie cachée comprise, l’objet, le texte et chaque fichier par nom et taille. Le message qui part est celui de la carte.

Limites et sécurité

  • Un message porte jusqu’à 100 destinataires, 20 pièces jointes et 10 Mio au total.
  • Un message se lit jusqu’à 80 Mio, son texte et son HTML jusqu’à 2 Mio chacun. Une réponse plus longue est stockée, et fetch_body la lit.
  • Une opération dure jusqu’à 120 secondes.
  • Toujours TLS avec un certificat vérifié : SMTP sur 465 ou 587, IMAP sur 993 ou 143. Le port 25 est refusé.
  • Le journal garde les destinataires, l’objet et les noms de fichiers de chaque message. Le texte reste dehors.