E-Mail zeitversetzt versenden
Diese Funktion versendet eine E-Mail nicht sofort, sondern zu einem von Ihnen festgelegten Zeitpunkt in der Zukunft. Sie übergeben Empfänger, Inhalt und Versandzeitpunkt in einer einzigen Anfrage; KIT übernimmt die Zustellung genau dann, ohne dass Sie selbst einen Cronjob oder Zeitplaner betreiben müssen.
Der Zeitpunkt gehört zur Nachricht
Statt eine Nachricht sofort zu verschicken, geben Sie zusätzlich zu Empfänger und Inhalt einen Versandzeitpunkt an – etwa fünf Minuten oder drei Tage in der Zukunft. KIT speichert die Anfrage und stellt die Nachricht exakt zum gewünschten Zeitpunkt zu, ohne dass ein eigener Dienst dafür laufen muss. Das eignet sich für Erinnerungen, verzögerte Bestätigungen oder Nachrichten, die erst nach Ablauf einer Frist relevant werden.
Typische Abstände
Ob eine Erinnerung 24 Stunden vor einem Termin, eine Zahlungsaufforderung nach Ablauf einer Frist oder eine Folgenachricht drei Tage nach einem Kontakt: Der Versandzeitpunkt lässt sich frei wählen, von wenigen Minuten bis zu mehreren Wochen im Voraus. Eine bereits geplante Nachricht lässt sich vor dem Versand noch stornieren, solange der Zeitpunkt nicht erreicht ist. Für regelmäßig wiederkehrende Versände zu festen Intervallen eignet sich stattdessen die Zusammenfassungsfunktion oder ein wiederkehrender Zeitplan.
Preis und Genauigkeit
Der Preis entspricht dem einfachen Versand: $0.002 pro Anfrage plus $0.0035 pro E-Mail, unabhängig davon, wie weit der Versandzeitpunkt in der Zukunft liegt. Die Zustellung erfolgt mit einer Genauigkeit im Minutenbereich um den angegebenen Zeitpunkt – für Anwendungsfälle, die eine Zustellung auf die Sekunde genau erfordern, ist diese Funktion nicht ausgelegt. Für die meisten Erinnerungen und Fristen genügt diese Genauigkeit vollständig.
Anwendungsfälle
Zahlungserinnerung nach Ablauf einer Frist
Schneider IT-Systeme GmbH & Co. KG plant eine Erinnerungsmail genau 14 Tage nach Rechnungsstellung, passend zur üblichen Zahlungsfrist.
Terminerinnerung 24 Stunden vorher
Eine Zahnarztpraxis plant bei jeder Buchung automatisch eine Erinnerungsmail für den Vortag des Termins, ohne dafür täglich manuell nachzusehen.
Verzögerte Willkommensnachricht
Ein Anbieter aus Hamburg verschickt drei Tage nach der Anmeldung eine zweite Nachricht mit weiterführenden Informationen, zeitversetzt zur ersten Begrüßung.
Häufige Fragen
Wie genau ist der Versandzeitpunkt?
Die Zustellung erfolgt im Minutenbereich um den angegebenen Zeitpunkt; für eine Zustellung auf die Sekunde genau ist die Funktion nicht gedacht.
Kann ich eine geplante Nachricht wieder stornieren?
Ja, solange der Versandzeitpunkt noch nicht erreicht ist, lässt sich eine geplante Nachricht zurückziehen.
Wie weit im Voraus kann ich planen?
Von wenigen Minuten bis zu mehreren Wochen; ein festes Höchstlimit ist aktuell nicht veröffentlicht.
Kostet ein zeitversetzter Versand mehr als ein sofortiger?
Nein, der Preis bleibt $0.0055 je zugestellter Nachricht, unabhängig vom gewählten Zeitpunkt.
Was passiert mit Inhalt und Zeitpunkt bis zum Versand?
Beides wird bis zur Zustellung gespeichert und danach nicht weiter aufbewahrt.
Eignet sich das für wiederkehrende Erinnerungen, etwa jeden Montag?
Für einen einzelnen zukünftigen Zeitpunkt ja; für regelmäßig wiederkehrende Versände eignet sich eher ein fester Zeitplan in Kombination mit dieser Funktion.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/notify/email-scheduled \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/email-scheduled", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/notify/email-scheduled",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email-scheduled", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email-scheduled", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"input": "…"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "notify.email_scheduled",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |