E-Mails empfangen
E-Mails mit der API lesen
Lesen Sie die E-Mails, die auf Ihrer Domain ankommen, aus Ihrem eigenen Code. Konversationen auflisten, Nachrichten öffnen, suchen, labeln, organisieren, senden und antworten, alles über einen einzigen Endpoint.
- REST
- JSON
- Threads und Suche
- Labels und Ordner
- Senden und antworten
https://g.sendcorex.comSo funktioniert es
Ein Token, ein Postfach
Ihr Token gehört zu einem Absender, und ein Absender ist ein Postfach. Kein Argument bestimmt, wessen E-Mails Sie lesen: Das entscheidet der Token.
Ein Endpoint für alles
Auflisten, lesen, suchen, markieren, verschieben, senden und antworten sind Befehle, die an POST /v1 gesendet werden. Bis zu 20 pro Anfrage.
Kurzlebige Tokens
Der Access Token gilt 1 Stunde, der Refresh Token 15 Tage. Der Refresh Token wird bei jeder Verwendung erneuert.
Postfach einrichten
Einmal erledigen. Danach braucht jede Anfrage nur noch Ihren Token.
- 1
Domain hinzufügen oder eine gemeinsame nutzen
Verifizieren Sie Ihre eigene Domain oder sparen Sie sich die DNS-Arbeit und nutzen Sie eine gemeinsame Domain.
- 2
Absender erstellen
Ein Absender ist ein Postfach. Erstellen Sie einen auf Ihrer verifizierten Domain oder auf einer gemeinsamen Domain: Auf einer gemeinsamen Domain wird mit dem Absender auch das Postfach erstellt.
Wenn Sie Ihre eigene Domain registriert und bereits eine E-Mail gesendet haben, wurde der Absender automatisch für Sie erstellt.
- 3
MX-Eintrag setzen
Nur nötig, wenn Sie E-Mails auf Ihrer eigenen Domain empfangen möchten. Lassen Sie den MX-Eintrag auf den Inbound-Host von Sendcorex zeigen.
- 4
Tokens erzeugen
Öffnen Sie das Webmail, gehen Sie zu Einstellungen und erzeugen Sie einen Access Token und einen Refresh Token für den Absender.
- 5
API aufrufen
Senden Sie Ihren Token im Authorization-Header und Ihren ersten Befehl an POST /v1.
MX-Eintrag
Um E-Mails auf Ihrer eigenen Domain zu empfangen, muss deren MX-Eintrag auf den Inbound-Host von Sendcorex zeigen. Fügen Sie diesen Eintrag bei Ihrem DNS-Anbieter hinzu.
- Typ
MX - Zeigt auf
bounce.emailsbit.com
Der MX-Eintrag dient nur dem Empfang auf Ihrer eigenen Domain. Ohne ihn können Sie trotzdem senden und die Bounces und Beschwerden lesen, die in Ihr Postfach zurückkommen.
Was im Postfach ankommt
Normale E-Mails
Alles, was an Ihre Absenderadresse gesendet wird, wie in jedem Postfach.
Return-Path-Nachrichten
Bounces und andere Nachrichten, die an den Return-Path zurückkommen, werden ebenfalls im Postfach gespeichert, sodass Sie sie über die API lesen können.
Beschwerden
Spam-Beschwerden werden ebenfalls im Postfach gespeichert. Sie kommen nur von Microsoft 365 und Microsoft-Diensten allgemein.
Ihre erste Anfrage
Listen Sie die ungelesenen Konversationen in Ihrer INBOX auf. Ersetzen Sie SENDCOREX_TOKEN durch den Access Token aus den Webmail-Einstellungen.
curl -X POST 'https://g.sendcorex.com/v1' \
-H "Authorization: $SENDCOREX_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "list_threads", "args": { "folder": "INBOX", "is_read": false, "limit": 10 } }
]
}'Jeder Thread hat eine last_message_uid. Übergeben Sie sie an Nachrichten abrufen, um die E-Mail zu lesen, oder an Antworten, um sie zu beantworten.
Vollständige Referenz
Alles mit CMD ist ein Befehl, der über POST /v1 gesendet wird, bis zu 20 pro Anfrage. Routen haben eigene Pfade.
Routen
4Identität
1Ordner und Zähler
5Lesen
5Flags und Labels
8- CMDFlags setzenGelesen, Stern, wichtig
- CMDLabels hinzufügenLabels ohne Groß-/Kleinschreibung
- CMDLabels entfernenLabels ohne Groß-/Kleinschreibung
- CMDBilder als geladen markierenFlag für externe Bilder entfernen
- CMDLabels auflistenNamen und Farben
- CMDLabel erstellenNeues Label
- CMDLabel-Farbe festlegenFarbe ändern
- CMDLabel löschenVon allen Nachrichten
Organisieren
4Senden und Vertrauen
9- CMDE-Mail sendenNeue Nachricht, unter Gesendet gespeichert
- CMDAntwortenGleiche Konversation, Labels bleiben
- CMDVertrauen abrufenVertrauensstatus eines Absenders
- CMDVertrauen festlegenStandard, vertrauenswürdig oder nicht
- CMDVertrauen auflistenAbsender mit einer Entscheidung
- CMDWeiterleitenOriginalanhänge inklusive
- CMDTracking abrufenÖffnungen und Klicks gesendeter E-Mails
- CMDAktivität auflistenWer geöffnet, geklickt oder sich abgemeldet hat
- CMDAktivitätszählerBadges der Aktivitätsordner
Anhänge
4Planen
3Entwürfe
5Regeln
10- CMDRegeln auflistenIn Ausführungsreihenfolge, mit Treffern
- CMDRegel abrufenEine Regel
- CMDRegel erstellenFilter für jede neue E-Mail
- CMDRegel aktualisierenRegel ersetzen
- CMDRegel löschenRegel entfernen
- CMDRegel aktivierenEin oder aus
- CMDRegeln neu ordnenAusführungsreihenfolge
- CMDRegeloptionenFelder, Operatoren, Aktionen
- CMDRegel testenProbelauf mit aktuellen E-Mails
- CMDRegel anwendenAuf vorhandene E-Mails anwenden
Templates
6Kontakt und Follow-up
5Kontakte und Zielgruppe
12- CMDKontakte auflistenPersonen, die mit diesem Postfach schreiben
- CMDKontakte zählenWie viele Personen einem Filter entsprechen
- CMDKontakt des Postfachs abrufenEin Kontakt mit Zählern und Vertrauen
- CMDKontaktnamen ändernNamen eines Kontakts ändern
- CMDKontakt taggenTags hinzufügen oder entfernen
- CMDKontaktverlauf abrufenÖffnungen, Klicks und E-Mails eines Kontakts
- CMDSegmente auflistenGespeicherte Segmente des Postfachs
- CMDSegment speichernSegment erstellen oder bearbeiten
- CMDSegment löschenSegment löschen
- CMDZielgruppe abrufenGröße einer Zielgruppe vor dem Senden
- CMDEmpfänger prüfenWer sich abgemeldet hat, vor dem Senden
- CMDZustellstatus abrufenZustellung pro Empfänger einer gesendeten E-Mail