ArgorantDocs

Beliebiges Postfach verbinden (SMTP und IMAP)

Verbinde Postfächer von Zoho, Fastmail, Yahoo, iCloud, IONOS, deinem Webhoster oder jedem anderen Anbieter mit ihren Servereinstellungen. Teste zuerst die Anmeldung, verbinde eins nach dem anderen oder viele aus einer CSV-Datei.

Postfächer von Google und Microsoft verbinden sich mit ihrer eigenen Anmeldung (siehe Google Workspace verbinden, und Microsoft 365 in der App unter Postfächer). Jeder andere Anbieter verbindet sich mit zwei Sätzen von Servereinstellungen. Der Postausgangsserver (SMTP) lässt Kampagnen aus dem Postfach versenden. Der Server zum Lesen von Antworten (IMAP) holt die Antworten in deinen Posteingang in Argorant. So stoppt eine Antwort die Sequenz für diese Person.

Argorant meldet sich bei beiden an, bevor irgendetwas gespeichert wird. Ein Postfach wird nur verbunden, wenn Versand und Lesen von Antworten beide funktionieren. Das Passwort wird verschlüsselt gespeichert und nie wieder angezeigt, weder in der App noch in der API, der CLI oder dem Connector.

In der App

Öffne Postfächer, klick auf Konten hinzufügen, dann auf Vorhandene verbinden und Beliebiger anderer Anbieter.

  1. Wähl deinen Anbieter aus der Liste. Servernamen, Ports und Sicherheit werden für dich ausgefüllt. Wähl Anderer Anbieter, wenn deiner nicht dabei ist, und übernimm die Einstellungen aus den Hilfeseiten deines Anbieters.
  2. Gib die E-Mail-Adresse, den Absendernamen, den Empfänger sehen, und das Passwort ein.
  3. Klick auf Verbindung testen. Du siehst eine Zeile für den Versand und eine für das Lesen von Antworten, jeweils mit dem, was funktioniert hat, oder dem, was du korrigieren musst.
  4. Klick auf Postfach verbinden. Es erscheint sofort in der Liste mit seinem Tageslimit und seinem Zustand.

Um viele Postfächer auf einmal zu verbinden, wechsle zu Mehrere aus einer CSV-Datei, lade die Datei hoch und prüf das Ergebnis für jede Zeile.

Die Namen der Schaltflächen können in der App leicht abweichen, wenn sie auf Englisch angezeigt wird.

App-Passwörter

Viele Anbieter akzeptieren dein normales Passwort aus anderen Apps nicht, wenn die Bestätigung in zwei Schritten aktiv ist. Erstell beim Anbieter ein App-Passwort und nutz stattdessen dieses.

AnbieterWo du ein App-Passwort erstellst
Zoho MailMein Konto, Sicherheit, App-Passwörter. Schalte in den Einstellungen von Zoho Mail auch den IMAP-Zugriff ein.
FastmailEinstellungen, Datenschutz und Sicherheit, App-Passwörter verwalten. Immer nötig.
Yahoo MailKontoinformationen, Kontosicherheit, App-Passwort generieren. Immer nötig.
iCloud Mailaccount.apple.com, Anmeldung und Sicherheit, App-spezifische Passwörter. Immer nötig. Der Benutzername ist deine vollständige iCloud-Adresse.
Outlook.com und HotmailMicrosoft lehnt Passwörter aus anderen Apps hier oft ab. Versuch ein App-Passwort. Wenn der Test sagt, das Passwort ist falsch, verbinde stattdessen mit der Microsoft-Anmeldung.

Die Menünamen können je nach Sprache deines Kontos beim Anbieter leicht abweichen.

Einstellungen der Anbieter

Wähl einen Anbieter, dann wird das hier ausgefüllt. Die Liste in der App und GET /api/v1/inboxes/smtp/presets ist immer aktuell.

PresetAnbieterPostausgangsserverServer zum Lesen von Antworten
zohoZoho Mail (eigene Domain)smtppro.zoho.com, 587, STARTTLSimappro.zoho.com, 993, SSL
zoho_euZoho Mail (EU-Rechenzentrum)smtppro.zoho.eu, 587, STARTTLSimappro.zoho.eu, 993, SSL
zoho_personalZoho Mail (privat oder kostenloser Plan)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 (USA)smtp.ionos.com, 587, STARTTLSimap.ionos.com, 993, SSL
ionos_deIONOS (Deutschland)smtp.ionos.de, 587, STARTTLSimap.ionos.de, 993, SSL
ionos_ukIONOS (Großbritannien)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 oder Hotmailsmtp-mail.outlook.com, 587, STARTTLSoutlook.office365.com, 993, SSL
otherAnderer Anbieterträgst du selbst einträgst du selbst ein

Nimm Port 587 für den Versand. Wenn du 465 einträgst, probiert Argorant 587 für dich und speichert 587, wenn es klappt. Das Testergebnis zeigt dann Port 587 und STARTTLS für den Versand. Der Benutzername für beide Server ist die E-Mail-Adresse, außer du setzt einen anderen. Das Lesen von Antworten nutzt denselben Benutzernamen und dasselbe Passwort wie der Versand, außer du setzt andere. Ohne Preset richtet sich die Sicherheit nach dem Port, also STARTTLS auf 587 und 143 und SSL auf 993.

Was das Testergebnis bedeutet

ErgebnisWas es bedeutetWas zu tun ist
signed_inDer Server hat die Anmeldung akzeptiert.Nichts.
wrong_passwordDer Server hat Benutzername oder Passwort abgelehnt.Prüf beides. Nimm ein App-Passwort, wenn der Anbieter eins verlangt, und prüf, ob der IMAP-Zugriff beim Anbieter eingeschaltet ist.
not_reachableDer Server hat nicht geantwortet, oder es gibt keinen Server mit diesem Namen.Prüf Servername und Port.
security_mismatchDie sichere Verbindung hat nicht funktioniert.Probier die andere Sicherheitseinstellung. Für den Versand nimm Port 587 mit STARTTLS.
not_allowedDer Servername zeigt auf ein privates Netzwerk.Nimm den öffentlichen Servernamen deines Anbieters.
failedEtwas anderes ist schiefgegangen.Prüf die Einstellungen und versuch es erneut, oder wende dich an den Support.

Viele Postfächer aus einer CSV-Datei

Eine Zeile pro Postfach. Jede Zeile braucht email, smtp_password (oder password) und entweder ein preset oder smtp_host, smtp_port und imap_host. Leere Spalten übernehmen die Standardwerte oben und 25 E-Mails pro Tag.

SpalteBeispiel
emailanna@yourcompany.com
sender_nameAnna Weber
presetzoho
smtp_host, smtp_port, smtp_securitymail.yourcompany.com, 587, starttls
smtp_username, smtp_passwordanna@yourcompany.com, dein App-Passwort
imap_host, imap_port, imap_securitymail.yourcompany.com, 993, ssl
imap_username, imap_passwordnur wenn sie vom Versand abweichen
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

Die dritte Zeile hat kein Preset. Sie braucht also auch smtp_host, smtp_port und imap_host, sonst kommt sie als Zeile zum Korrigieren zurück. Jede Zeile bekommt ihr eigenes Ergebnis. Verbundene Zeilen bleiben verbunden, wenn andere fehlschlagen. Korrigier also die fehlgeschlagenen Zeilen und lade nur diese erneut hoch.

Nach einer Passwortänderung neu verbinden

Wenn der Anbieter das Passwort ablehnt, zeigt das Postfach in der Liste der Postfächer Erneut anmelden. Wird das Lesen von Antworten dreimal hintereinander abgelehnt, wird das Postfach als getrennt markiert und bleibt es, bis du es neu verbindest.

Zum Neuverbinden verbindest du dieselbe Adresse noch einmal mit dem neuen Passwort. In der App klickst du beim Postfach auf Neu verbinden, gibst das neue Passwort ein und verbindest. Die anderen Einstellungen bleiben erhalten. Mit der API, der CLI oder deinem KI-Assistenten verbindest du dieselbe Adresse noch einmal. Das ersetzt die gespeicherten Einstellungen und das Passwort dieses Postfachs.

Über die 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"}]}'

Eine abgelehnte Anmeldung beim Verbinden antwortet mit 422, dem Code sign_in_failed und dem Testergebnis in error.details.test. Die Bulk-Route antwortet mit 200 und einem Ergebnis pro Zeile. In der kostenlosen Testphase kannst du bis zu 2 Postfächer verbinden. Du kannst 30 Mal pro Stunde testen und 30 Mal pro Stunde verbinden, und über die Bulk-Route bis zu 500 Postfächer pro Stunde verbinden.

Aus dem 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

Die CLI nimmt das Passwort nie auf der Kommandozeile an. Sie fragt danach, liest es aus einer Umgebungsvariable, die du mit --password-env NAME nennst, oder aus ARGORANT_MAILBOX_PASSWORD. Siehe CLI.

Aus deinem KI-Assistenten

Mit dem Argorant-Connector fragst du in normalen Worten, zum Beispiel „Verbinde anna@yourcompany.com, das ist ein Zoho-Postfach“. Der Assistent nutzt argorant_test_smtp_mailbox, um die Anmeldung zu prüfen, und argorant_connect_smtp_mailbox, um ein Postfach oder bis zu 25 zu verbinden. Siehe Tools.

Nach dem Verbinden

Das Postfach versendet wie jedes andere. Setz sein Tageslimit und den Warm-up unter Postfächer oder mit PATCH /api/v1/inboxes/{email} und wähl es in jeder Kampagne als Absender. Follow-ups gehen im selben Verlauf raus, Antworten landen in deinem Posteingang in Argorant, und du beantwortest sie von dort im selben Verlauf. Antworten, die im Junk- oder Spam-Ordner landen, werden auch gelesen, aber nur von Personen, die du angeschrieben hast. Spam wird also ignoriert.