ArgorantDocs

Connecter n'importe quelle boîte mail (SMTP et IMAP)

Connectez des boîtes mail Zoho, Fastmail, Yahoo, iCloud, IONOS, de votre hébergeur web ou de tout autre fournisseur avec leurs paramètres serveur. Testez d'abord la connexion, puis connectez-les une par une ou en nombre depuis un fichier CSV.

Les boîtes mail Google et Microsoft se connectent avec leur propre connexion (voir Connecter un Google Workspace, et Microsoft 365 dans l'app sous Boîtes mail). Tous les autres fournisseurs se connectent avec deux jeux de paramètres serveur. Le serveur d'envoi (SMTP) permet aux campagnes d'envoyer depuis la boîte mail. Le serveur de lecture des réponses (IMAP) ramène les réponses dans votre boîte de réception Argorant, si bien qu'une réponse arrête la séquence pour cette personne.

Argorant se connecte aux deux avant d'enregistrer quoi que ce soit. Une boîte mail n'est connectée que si l'envoi et la lecture des réponses fonctionnent tous les deux. Le mot de passe est stocké chiffré et n'est plus jamais affiché, ni dans l'app, ni dans l'API, ni dans la CLI, ni dans le connecteur.

Dans l'app

Ouvrez Boîtes mail, cliquez sur Add accounts, puis sur Connecter l'existant et Autre fournisseur.

  1. Choisissez votre fournisseur dans la liste. Les noms de serveur, les ports et la sécurité se remplissent pour vous. Choisissez Autre fournisseur si le vôtre ne figure pas dans la liste, et reprenez les paramètres des pages d'aide de votre fournisseur.
  2. Saisissez l'adresse e-mail, le nom d'expéditeur que les destinataires voient et le mot de passe.
  3. Cliquez sur Tester la connexion. Vous voyez une ligne pour l'envoi et une pour la lecture des réponses, chacune avec ce qui a fonctionné ou ce qu'il faut corriger.
  4. Cliquez sur Connecter la boîte mail. Elle apparaît tout de suite dans la liste, avec sa limite quotidienne et son état de santé.

Pour connecter de nombreuses boîtes mail d'un coup, passez à Plusieurs depuis un fichier CSV, envoyez le fichier et vérifiez le résultat de chaque ligne.

Mots de passe d'application

Beaucoup de fournisseurs n'acceptent pas votre mot de passe habituel depuis d'autres applications quand la validation en deux étapes est activée. Créez un mot de passe d'application chez le fournisseur et utilisez-le à la place.

FournisseurOù créer un mot de passe d'application
Zoho MailMy Account, Security, App Passwords. Activez aussi l'accès IMAP dans les paramètres de Zoho Mail.
FastmailSettings, Privacy and Security, Manage app passwords. Toujours nécessaire.
Yahoo MailAccount Info, Account Security, Generate app password. Toujours nécessaire.
iCloud Mailaccount.apple.com, Sign-In and Security, App-Specific Passwords. Toujours nécessaire. Le nom d'utilisateur est votre adresse iCloud complète.
Outlook.com et HotmailMicrosoft refuse souvent les mots de passe venant d'autres applications pour ces comptes. Essayez un mot de passe d'application ; si le test indique que le mot de passe est incorrect, connectez-vous plutôt avec la connexion Microsoft.

Paramètres des fournisseurs

Choisissez un fournisseur et ces valeurs sont remplies. La liste de l'app et GET /api/v1/inboxes/smtp/presets est toujours la liste à jour.

PréréglageFournisseurServeur d'envoiServeur de lecture des réponses
zohoZoho Mail (domaine professionnel)smtppro.zoho.com, 587, STARTTLSimappro.zoho.com, 993, SSL
zoho_euZoho Mail (centre de données UE)smtppro.zoho.eu, 587, STARTTLSimappro.zoho.eu, 993, SSL
zoho_personalZoho Mail (offre personnelle ou gratuite)smtp.zoho.com, 587, STARTTLSimap.zoho.com, 993, SSL
fastmailFastmailsmtp.fastmail.com, 587, STARTTLSimap.fastmail.com, 993, SSL
godaddyGoDaddy Professional Emailsmtpout.secureserver.net, 587, STARTTLSimap.secureserver.net, 993, SSL
titanTitan Emailsmtp.titan.email, 587, STARTTLSimap.titan.email, 993, SSL
hostingerHostinger Emailsmtp.hostinger.com, 587, STARTTLSimap.hostinger.com, 993, SSL
ionosIONOS (États-Unis)smtp.ionos.com, 587, STARTTLSimap.ionos.com, 993, SSL
ionos_deIONOS (Allemagne)smtp.ionos.de, 587, STARTTLSimap.ionos.de, 993, SSL
ionos_ukIONOS (Royaume-Uni)smtp.ionos.co.uk, 587, STARTTLSimap.ionos.co.uk, 993, SSL
namecheapNamecheap Private Emailmail.privateemail.com, 587, STARTTLSmail.privateemail.com, 993, SSL
yahooYahoo Mailsmtp.mail.yahoo.com, 587, STARTTLSimap.mail.yahoo.com, 993, SSL
icloudiCloud Mailsmtp.mail.me.com, 587, STARTTLSimap.mail.me.com, 993, SSL
outlookOutlook.com ou Hotmailsmtp-mail.outlook.com, 587, STARTTLSoutlook.office365.com, 993, SSL
otherAutre fournisseurà saisirà saisir

Utilisez le port 587 pour l'envoi. Si vous saisissez 465, Argorant essaie 587 pour vous et enregistre 587 si cela fonctionne ; le résultat du test affiche alors le port 587 et STARTTLS pour l'envoi. Le nom d'utilisateur des deux serveurs est l'adresse e-mail, sauf si vous en indiquez un autre. La lecture des réponses utilise le même nom d'utilisateur et le même mot de passe que l'envoi, sauf si vous en indiquez d'autres. Sans préréglage, la sécurité dépend du port : STARTTLS sur 587 et 143, SSL sur 993.

Ce que signifie le résultat du test

RésultatSignificationQue faire
signed_inLe serveur a accepté la connexion.Rien.
wrong_passwordLe serveur a refusé le nom d'utilisateur ou le mot de passe.Vérifiez les deux. Utilisez un mot de passe d'application si le fournisseur en demande un, et vérifiez que l'accès IMAP est activé chez le fournisseur.
not_reachableLe serveur n'a pas répondu, ou aucun serveur ne porte ce nom.Vérifiez le nom du serveur et le port.
security_mismatchLa connexion sécurisée n'a pas fonctionné.Essayez l'autre réglage de sécurité. Pour l'envoi, utilisez le port 587 avec STARTTLS.
not_allowedLe nom du serveur pointe vers un réseau privé.Utilisez le nom de serveur public de votre fournisseur.
failedAutre chose n'a pas fonctionné.Vérifiez les paramètres et réessayez, ou contactez le support.

Plusieurs boîtes mail depuis un fichier CSV

Une ligne par boîte mail. Chaque ligne a besoin de email, smtp_password (ou password) et soit d'un preset, soit de smtp_host, smtp_port et imap_host. Les colonnes vides prennent les valeurs par défaut ci-dessus, et 25 e-mails par jour.

ColonneExemple
emailanna@yourcompany.com
sender_nameAnna Weber
presetzoho
smtp_host, smtp_port, smtp_securitymail.yourcompany.com, 587, starttls
smtp_username, smtp_passwordanna@yourcompany.com, votre mot de passe d'application
imap_host, imap_port, imap_securitymail.yourcompany.com, 993, ssl
imap_username, imap_passwordseulement s'ils diffèrent de ceux de l'envoi
daily_limit30
CSV
email,sender_name,preset,smtp_password
anna@yourcompany.com,Anna Weber,zoho,app-password-1
ben@yourcompany.com,Ben Hill,zoho,app-password-2
cara@othercompany.com,Cara Lane,,app-password-3

La troisième ligne n'a pas de préréglage : il faut donc aussi y remplir smtp_host, smtp_port et imap_host, sinon elle revient comme ligne à corriger. Chaque ligne obtient son propre résultat. Les lignes connectées restent connectées quand d'autres échouent : corrigez les lignes en échec et envoyez de nouveau uniquement celles-ci.

Reconnecter après un changement de mot de passe

Quand le fournisseur refuse le mot de passe, la boîte mail affiche Sign in again dans la liste des boîtes mail. Si la lecture des réponses est refusée trois fois de suite, la boîte mail est marquée comme déconnectée et le reste jusqu'à ce que vous la reconnectiez.

Pour la reconnecter, connectez de nouveau la même adresse avec le nouveau mot de passe. Dans l'app, cliquez sur Reconnecter sur la boîte mail, saisissez le nouveau mot de passe et connectez-la ; les autres paramètres sont conservés. Avec l'API, la CLI ou votre assistant IA, connectez de nouveau la même adresse : cela remplace les paramètres et le mot de passe enregistrés pour cette boîte mail.

Depuis l'API

Shell
# Test first: nothing is saved
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/test" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password"}'

# Connect one mailbox
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","display_name":"Anna Weber","preset":"zoho","smtp_password":"app-password"}'

# Connect up to 25 at once
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/bulk" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"mailboxes":[{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password-1"},{"email":"ben@yourcompany.com","preset":"zoho","smtp_password":"app-password-2"}]}'

Si le serveur refuse l'identification au moment de connecter la boîte mail, la réponse est 422 avec le code sign_in_failed et le résultat du test dans error.details.test. La route groupée renvoie 200 avec un résultat par ligne. Un essai gratuit connecte jusqu'à 2 boîtes mail. Vous pouvez tester 30 fois et connecter 30 fois par heure, et connecter jusqu'à 500 boîtes mail par heure via la route groupée.

Depuis le terminal

Shell
argorant inboxes presets
argorant inboxes test-smtp --email anna@yourcompany.com --preset zoho
argorant inboxes connect-smtp --email anna@yourcompany.com --preset zoho --name "Anna Weber"
argorant inboxes connect-smtp --csv mailboxes.csv

La CLI ne prend jamais le mot de passe sur la ligne de commande. Elle le demande, ou le lit dans une variable d'environnement que vous nommez avec --password-env NAME, ou dans ARGORANT_MAILBOX_PASSWORD. Voir CLI.

Depuis votre assistant IA

Avec le connecteur Argorant, demandez avec vos propres mots, par exemple « connecte anna@yourcompany.com, c'est une boîte mail Zoho ». L'assistant utilise argorant_test_smtp_mailbox pour vérifier la connexion et argorant_connect_smtp_mailbox pour connecter une boîte mail ou jusqu'à 25. Voir Outils.

Après la connexion

La boîte mail envoie comme n'importe quelle autre. Réglez sa limite quotidienne et son warm-up sous Boîtes mail ou avec PATCH /api/v1/inboxes/{email}, et choisissez-la comme expéditeur dans n'importe quelle campagne. Les relances partent dans le même fil, les réponses arrivent dans votre boîte de réception Argorant, et vous y répondez depuis celle-ci, dans le même fil. Les réponses qui tombent dans le dossier des indésirables ou du spam sont lues aussi, mais seulement celles des personnes à qui vous avez écrit, si bien que le spam est ignoré.

Sur cette page