In dem Moment, in dem es passiert,
weiß es Ihr Server
Moderationsereignisse, an Ihren Server gepusht in dem Moment, in dem sie passieren: Spam-Erkennungen, Sperren, Beitritte und mehr — jede Zustellung HMAC-signiert, dedupliziert und nach einem Zeitplan wiederholt, bis Ihr Endpunkt sie bestätigt.
- Ereignisse in Echtzeit
- HMAC-signierte Payloads
- Wiederholungen bis zur Zustellung
Sieben Ereignisse, direkt aus der Engine
Abonnieren Sie pro Endpunkt genau die Ereignisse, die Sie brauchen — von Spam-Urteilen bis zu Mitgliedschaftsänderungen.
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftJedes Ereignis kommt in einem kompakten JSON-Umschlag: id, type, created_at, group_id und die Ereignisdaten — die id bleibt über Wiederholungen hinweg stabil, sodass Deduplizierung ein einziger Set-Lookup ist.
Der Wiederholungsplan, genau wie er läuft
Sechs Versuche über rund acht Stunden — genug, um ein Deployment, einen Neustart oder einen kompletten Ausfall auf Ihrer Seite zu überstehen.
0Sofort+1m+5m+30m+2h+6hLetzter VersuchZustellung, auf die Sie bauen können
Zustellung mindestens einmal
Jedes Ereignis wird mindestens einmal zugestellt. Ihr Endpunkt bestätigt mit einer beliebigen 2xx-Antwort — alles andere geht zurück in die Wiederholungswarteschlange.
Stabile ids zur Deduplizierung
Jedes Ereignis hat eine stabile id, die Wiederholungen übersteht. Deduplizierung auf Ihrer Seite ist ein einziger Lookup, keine Heuristik.
Keine Zombie-Endpunkte
Ein Endpunkt, der tagelang scheitert, wird automatisch deaktiviert — und Sie erhalten eine Telegram-DM statt einer stillen Lücke in Ihren Daten.
Test-Ping
Ein Testereignis per Klick, signiert wie das echte — prüfen Sie Ihren Handler, bevor ein einziges echtes Ereignis davon abhängt.
Einsehbarer Verlauf
Vollständiger Zustellverlauf pro Endpunkt: jeder Versuch, Status und Zeitstempel — das Debuggen Ihres Empfängers kommt ganz ohne Raten aus.
Nur HTTPS, immer signiert
Endpunkte müssen öffentliche HTTPS-URLs sein, und jedes Payload ist signiert. Transport und Urheberschaft sind beide abgedeckt.
Jede Zustellung verifizieren
Drei Zeilen auf Ihrer Seite — und niemand kann ein Ereignis fälschen oder erneut abspielen.
# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)Pushen statt pollen
Das Pollen einer API sagt Ihnen, was passiert ist, als Sie gefragt haben; Webhooks sagen es Ihnen in dem Moment, in dem es passiert. Registrieren Sie einen HTTPS-Endpunkt, wählen Sie die Ereignisse, die Sie interessieren, und Telm pusht sie als JSON an Ihren Server — eine Spam-Welle, eine Sperre, eine Beitrittswelle — in der Sekunde, in der die Engine handelt.
Jede Zustellung ist signiert. Der Header X-Telm-Signature trägt einen HMAC-SHA256 aus Zeitstempel und Body, berechnet mit dem Secret Ihres Endpunkts, sodass Ihr Server Urheberschaft und Aktualität in drei Zeilen Code prüfen kann. Payloads reisen ausschließlich über HTTPS.
Die Zustellung ist für das echte Internet gebaut, in dem Empfänger ausfallen. Ereignisse werden mindestens einmal zugestellt, mit einer stabilen id zur Deduplizierung; Fehlschläge werden nach einem wachsenden Zeitplan wiederholt — sofort, dann nach 1 und 5 Minuten, 30 Minuten, 2 und 6 Stunden. Ein Endpunkt, der tagelang scheitert, wird automatisch deaktiviert, und Sie erhalten dazu eine Telegram-Nachricht statt einer stillen Lücke.
Alles ist einsehbar: Senden Sie einen Test-Ping vor dem Livegang und durchstöbern Sie den Zustellverlauf — Versuch für Versuch, Status für Status — wann immer Sie Ihre Seite der Leitung debuggen müssen.
Häufig gestellte Fragen
Wie überprüfe ich, dass ein Ereignis wirklich von Telm stammt?
Jede Zustellung trägt einen X-Telm-Signature-Header: einen HMAC-SHA256 von "timestamp.body", berechnet mit dem Secret Ihres Endpunkts. Berechnen Sie ihn auf Ihrer Seite neu, vergleichen Sie in konstanter Zeit und weisen Sie alles zurück, was älter als ein paar Minuten ist, um Replays auszuschließen.
Was passiert, wenn mein Server ausgefallen ist, während ein Ereignis auslöst?
Telm wiederholt nach einem wachsenden Zeitplan — sofort, dann nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 6 Stunden. Jede 2xx-Antwort gilt als zugestellt. Ereignisse tragen eine stabile id, sodass eine Wiederholung in Ihrem System nie zum Duplikat wird.
Kann ein kaputter Endpunkt ewig fluten?
Nein. Ein Endpunkt, der rund zwanzig Mal in Folge scheitert und drei Tage lang keinen Erfolg hat, wird automatisch deaktiviert, und Sie erhalten eine Telegram-Benachrichtigung. Beheben Sie Ihre Seite und aktivieren Sie ihn mit einem Klick wieder.
Wie teste ich meine Integration vor dem Livegang?
Senden Sie einen Test-Ping an einen beliebigen Endpunkt direkt aus dem Dashboard oder der API — er kommt genau wie ein echtes Ereignis signiert an. Der Zustellverlauf zeigt jeden Versuch mit seinem Status.
Welche Tarife enthalten Webhooks?
Webhooks sind Teil des vollständigen API-Pakets und in den Tarifen Pro und Business enthalten.
Verwandte Funktionen
Entdecken Sie weitere Möglichkeiten, wie Telm Ihrer Community helfen kann