Konzept
So funktioniert Emailit
Das Grundmodell von Emailit auf einer Seite. Workspaces, Domains und API-Schlüssel, die Wege zum Senden und Empfangen, der Lebenszyklus einer E-Mail, Credits und Sandbox-Modus.
Diese Seite erklärt die wichtigsten Bausteine von Emailit und wie sie zusammenhängen. Lesen Sie sie einmal, bevor Sie etwas bauen. Der Rest der Doku setzt diese Begriffe voraus.
Konten und Workspaces
Ihr Konto, das sind Sie: eine E-Mail-Adresse, ein Passwort und optional Zwei-Faktor-Authentifizierung oder Passkeys. Alles, was Sie senden, liegt in einem WorkspaceWorkspaceEin Container für alles, was Sie versenden: Domains, API-Schlüssel, E-Mails, Kontakte, Vorlagen, Mitglieder und Abrechnung. Ein Konto kann zu mehreren Workspaces gehören.. Ein Konto kann mehreren Workspaces angehören, und Sie wechseln mit dem Workspace-Umschalter oben in der Seitenleiste zwischen ihnen. Üblich ist ein Workspace pro Produkt oder pro Umgebung, zum Beispiel Acme und Acme Staging.
Jeder Workspace hat eigene:
| Ressource | Was sie ist |
|---|---|
| Versanddomains | Domains, die Sie mit DNS-Einträgen verifizieren, damit Emailit für sie senden kann. Jede Absenderadresse muss auf einer verifizierten VersanddomainVersanddomainEine Domain, die Ihnen gehört und die Sie mit DNS-Einträgen verifizieren, damit Emailit mit SPF, DKIM und eigenem Return-Path E-Mails von ihr senden kann. liegen. |
| API-Schlüssel | Secrets, die mit secret_ beginnen. Sie authentifizieren die REST-API, den MCP-Server und das SMTP-Relay. Ein Schlüssel hat entweder Full Access oder Sending Only. |
| Mitglieder | Die Personen, die den Workspace öffnen können, als Admin oder Member. Admins verwalten außerdem Einstellungen, API-Schlüssel, Mitglieder und Abrechnung. |
| Abrechnung | Ein Tarif, ein Guthaben an CreditsCreditDie Einheit, in der Emailit abrechnet. Jede Aktion kostet eine feste Anzahl Credits, zum Beispiel 1 für eine E-Mail per API oder SMTP und 2 für eine Kampagnen-E-Mail., Einstellungen der automatischen Aufladung und Rechnungen. |
| Daten | E-Mails, Events, Logs, Kontakte, Kontaktlisten, Vorlagen, Webhooks und Sperrungen. |
API-Schlüssel, Domains, Kontakte und Credits gehören zu genau einem Workspace. Ein API-Schlüssel funktioniert nie in einem anderen Workspace.
Wege zum Senden und ein Weg zum Empfangen
| Kanal | Geeignet für | Wie |
|---|---|---|
| REST-API | Transaktionale E-Mails aus Ihrem Code: Registrierungen, Passwort-Resets, Belege | POST https://api.emailit.com/v2/emails mit einem API-Schlüssel oder einem SDK |
| SMTP-Relay | Apps, Frameworks und Tools, die bereits SMTP sprechen | Host smtp.emailit.com, Benutzername emailit, Ihr API-Schlüssel als Passwort |
| Kampagnen und Automatisierungen | Newsletter, Ankündigungen und Onboarding-Sequenzen an Ihre Kontakte | In der Weboberfläche unter Email Marketing erstellt |
| Eingehende E-Mails | Empfang von E-Mails auf Ihrer Domain, für Antworten oder Support | Ein MX-Eintrag auf inbound.<your domain>. Jede Nachricht löst email.received aus. |
Jeder Kanal verwendet dieselben verifizierten Domains und dieselbe Sperrliste. API und SMTP-Relay teilen sich außerdem API-Schlüssel, Anfrage-Logs und einen gemeinsamen Satz von Versandlimits. Wie Sie zwischen beiden wählen, erfahren Sie unter API oder SMTP.
Der Lebenszyklus einer E-Mail
Jede E-Mail durchläuft denselben Weg, egal wie Sie sie senden:
- Angenommen. API oder SMTP-Relay prüfen die Anfrage: einen gültigen API-Schlüssel, eine Absenderadresse auf einer verifizierten Domain, Sandbox-Regeln, Versandlimits und Credits. Jeder Empfänger wird zu einer eigenen E-Mail mit eigener
em_-ID und dem Statusaccepted, oderscheduled, wenn Sie einen Sendezeitpunkt festgelegt haben. Die API löstemail.acceptedoderemail.scheduledaus. - In der Warteschlange und geprüft. Ein Zustellprozess übernimmt die E-Mail und prüft sie erneut. Steht ein Empfänger auf Ihrer Sperrliste, wird die E-Mail
suppressed. Eine pausierte Domain, ein gesperrter Workspace oder ein leeres Credit-Guthaben setzen sie aufheld. - Signiert und bewertet. Emailit signiert die Nachricht mit DKIM für Ihre Domain und setzt den Return-Path auf
emailit.<your domain>. Ist Tracking aktiviert, schreibt Emailit Links um und fügt ein Öffnungs-Pixel hinzu. Dann führt es eine Spam-Prüfung durch. Eine Nachricht mit einem Score von 7 oder mehr wird aufheldgesetzt, und die zutreffenden Regeln erscheinen unter Spam Checks auf der Seite der E-Mail. - Zustellversuche. Emailit verbindet sich mit dem Mailserver des Empfängers. Eine dauerhafte Ablehnung (eine 5xx-Antwort) setzt die E-Mail auf
bounced. Ein vorübergehender Fehler (eine 4xx-Antwort oder ein Timeout) setzt sie aufattempted, und Emailit versucht es bis zu 7-mal über etwa 21 Stunden erneut, bevor es aufgibt und sie alsbouncedmarkiert. - Zugestellt. Der Empfangsserver hat die Nachricht angenommen, die E-Mail ist also
delivered. Ein später eintreffender Bounce-Bericht kann sie noch aufbouncedsetzen, und eine Spam-Beschwerde vom Postfachanbieter setzt sie aufcomplained. Gebouncte Adressen und Adressen mit Beschwerden können automatisch auf Ihre Sperrliste gesetzt werden. - Geöffnet und geklickt. Hat die Domain eine verifizierte Tracking-Subdomain, setzen Öffnungen die E-Mail auf
loadedund Klicks aufclicked.
Jede Statusänderung wird als Event erfasst. Events erscheinen auf der Seite der E-Mail und unter Email APIEvents. Sie werden außerdem als signiertes JSON an Ihre Webhooks gesendet, in Batches von bis zu 100 Events pro Anfrage.
| Gruppe | Status |
|---|---|
| Unterwegs | accepted, scheduled, attempted |
| Angekommen | delivered, loaded, clicked, received (eingehend) |
| Gestoppt | bounced, failed, rejected, suppressed, complained, canceled, held |
Sie können eine E-Mail stornieren, solange sie scheduled, accepted oder attempted ist. Eine E-Mail mit held, bounced, failed oder suppressed können Sie erneut senden, nachdem Sie die Ursache behoben haben. Was jeder Status bedeutet, erfahren Sie unter E-Mail-Status.
Credits
Emailit rechnet in Credits ab. Jeder Workspace hat ein Guthaben aus den Credits, die jeden Monat im Tarif enthalten sind, plus allen Credits, die Sie kaufen. Inklusive Credits werden zuerst verbraucht. Gekaufte Credits verfallen nie.
| Aktion | Credits |
|---|---|
| E-Mail per API oder SMTP (pro Empfänger) | 1 |
| Empfangene E-Mail | 1 |
| Kampagnen-E-Mail (pro Empfänger) | 2 |
| Automatisierungsdurchlauf | 3 |
| E-Mail-Verifizierung (pro Adresse) | 5 |
Reicht das Guthaben für einen Versand nicht aus, gibt die API 402 zurück, und nichts wird gesendet. E-Mails, die ohne genügend Credits die Zustellwarteschlange erreichen, werden auf held gesetzt, und Sie können sie erneut senden, nachdem Sie Credits hinzugefügt haben. Aktivieren Sie die automatische Aufladung, damit Ihre E-Mails im Produktivbetrieb nie stoppen. Tarife und Preise finden Sie unter Credits und auf der Preisseite.
Sandbox und Produktionszugang
Jeder neue Workspace startet im Sandbox-Modus. Im Sandbox-Modus können Sie nur an die Konto-E-Mail-Adressen der Workspace-Mitglieder senden, und Kampagnen sind blockiert. Das Senden an andere Adressen schlägt fehl: Die API gibt 403 unverified_workspace_recipient zurück, und das SMTP-Relay antwortet mit 550.
Um an echte Empfänger zu senden, verifizieren Sie mindestens eine Versanddomain. Dann beantragt ein Admin den Produktionszugang über das Sandbox-Banner oder unter WorkspaceSettingsRequests. Die Anfrage fragt, was Sie senden, welches Volumen Sie erwarten und wie Personen ihr Opt-in geben. Das Emailit-Team prüft sie und antwortet im selben Anfrageverlauf. Siehe Produktionszugang.
Jeder Workspace hat außerdem Versandlimits, gemeinsam für API und SMTP. Neue Workspaces können 2 E-Mails pro Sekunde und 5.000 E-Mails pro Tag senden. Workspaces mit Pro oder Business erhalten automatische Erhöhungen auf Basis der Versandgesundheit, und jeder Workspace kann über die Karte Sending Limits auf der Startseite der Weboberfläche mehr beantragen.
Die Weboberfläche
Die Weboberfläche unter dash.emailit.com folgt demselben Modell. Die Seitenleiste enthält diese Bereiche, von oben nach unten:
| Bereich | Seite | Wofür |
|---|---|---|
| Dashboard | Checkliste zur Einrichtung, Schnellaktionen, Credits, tägliches Volumen, Versandgesundheit und Versandlimits | |
| Email Marketing | Overview | Wachstum der Kontakte und aktuelle Marketing-Aktivität |
| Audiences | Benannte Listen von Abonnenten, an die Kampagnen gehen | |
| Contacts | Alle Personen im Workspace, mit eigenen Feldern, Import und Export | |
| Campaigns | Kampagnen erstellen, testen, planen und auswerten | |
| Templates | Wiederverwendbare Designs für API, Automatisierungen und Kampagnen | |
| Forms | Anmeldeformulare (Early Access) | |
| Automations | Workflows, ausgelöst durch Kontakte, Datumsangaben und E-Mail-Events (Beta) | |
| Email API | Emails | Jede ausgehende und eingehende E-Mail mit Status, Inhalt und Zustellversuchen |
| Analytics | Versände, Bounces, Beschwerden, Öffnungen und Klicks im Zeitverlauf | |
| Domains | Domains hinzufügen, DNS-Einträge anlegen, Verifizierung und Tracking prüfen | |
| DMARC reports | Wer E-Mails als Ihre Domain sendet (ab Pro) | |
| Events | Der Event-Stream des Workspaces, den Webhooks empfangen | |
| Logs | Jede Anfrage per API und SMTP, mit Statuscodes und Bodys | |
| API Keys | Schlüssel erstellen, umbenennen, neu generieren und löschen sowie SMTP-Einstellungen ansehen | |
| Webhooks | Endpunkte, Auswahl der Events und jeder Zustellversuch | |
| Suppressions | Adressen, an die Emailit nicht sendet, mit CSV-Import und -Export | |
| Email Verification | Emails | Eine einzelne Adresse vor dem Senden prüfen |
| Lists | Bis zu 10.000 Adressen auf einmal prüfen | |
| Workspace | Billing | Tarif, Credits, automatische Aufladung, Add-ons und Rechnungen |
| Settings | Name, Mitglieder, eigene Felder, Datenaufbewahrung, Einstellungen für Sperrungen und Anfragen |
Ihre Kontoeinstellungen (Profil, Passwort, Zwei-Faktor-Authentifizierung und Passkeys) und Ihr Empfehlungslink befinden sich im Kontomenü unten in der Seitenleiste.