Salt la conținutul principal
Evenimente în timp real

În clipa în care se întâmplă,
serverul tău află

Evenimente de moderare împinse pe serverul tău în clipa în care se întâmplă: detecții de spam, interdicții, intrări și altele — fiecare livrare semnată HMAC, deduplicată și reîncercată după un program până când endpoint-ul tău o confirmă.

  • Evenimente în timp real
  • Sarcini utile semnate HMAC
  • Reîncercări până la livrare
Eveniment în grupul tăuX-Telm-SignaturePlic semnatServerul tăuProgram de reîncercare

Șapte evenimente, direct din motor

Abonează-te per endpoint exact la evenimentele de care ai nevoie — de la verdicte de spam la schimbări de apartenență.

spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.left

Fiecare eveniment călătorește într-un plic JSON compact: id, type, created_at, group_id și datele evenimentului — id-ul rămâne stabil între reîncercări, așa că deduplicarea este o singură căutare în set.

Programul de reîncercare, exact așa cum rulează

Șase încercări pe parcursul a aproximativ opt ore — suficient pentru a depăși un deploy, o repornire sau o pană completă de partea ta.

1
0Instantaneu
2
+1m
3
+5m
4
+30m
5
+2h
6
+6hÎncercare finală

Livrare pe care poți construi

Livrare cel puțin o dată

Fiecare eveniment este livrat cel puțin o dată. Endpoint-ul tău confirmă cu orice 2xx — orice altceva revine în coada de reîncercări.

Id-uri stabile pentru deduplicare

Fiecare eveniment are un id stabil care supraviețuiește reîncercărilor. Deduplicarea de partea ta este o singură căutare, nu o euristică.

Fără endpoint-uri zombi

Un endpoint care eșuează zile la rând este dezactivat automat — iar tu primești un mesaj direct pe Telegram în loc de o lipsă tăcută în datele tale.

Ping de test

Un eveniment de test dintr-un singur clic, semnat ca cel real — verifică-ți handlerul înainte ca un singur eveniment real să depindă de el.

Istoric inspectabil

Istoric complet al livrărilor per endpoint: fiecare încercare, stare și marcaj temporal — depanarea receptorului tău nu implică niciodată presupuneri.

Doar HTTPS, mereu semnat

Endpoint-urile trebuie să fie URL-uri HTTPS publice, iar fiecare sarcină utilă este semnată. Transportul și autoria sunt ambele acoperite.

Verifică fiecare livrare

Trei linii de partea ta — și nimeni nu poate falsifica sau relua un eveniment.

# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)

Împinge, nu interoga

Interogarea unui API îți spune ce s-a întâmplat atunci când ai întrebat; webhook-urile îți spun în clipa în care se întâmplă. Înregistrează un endpoint HTTPS, alege evenimentele care te interesează, iar Telm începe să ți le trimită pe server ca JSON — un val de spam, o interdicție, un raid de intrări — în secunda în care motorul acționează.

Fiecare livrare este semnată. Antetul X-Telm-Signature poartă un HMAC-SHA256 al marcajului temporal și al corpului, calculat cu secretul endpoint-ului tău, așa că serverul tău poate verifica atât autoria, cât și prospețimea în trei linii de cod. Sarcinile utile circulă doar prin HTTPS.

Livrarea este proiectată pentru internetul real, unde receptorii cad. Evenimentele sunt livrate cel puțin o dată, cu un id stabil pentru deduplicare; eșecurile se reîncearcă pe un program crescător — imediat, apoi după 1 și 5 minute, 30 de minute, 2 și 6 ore. Un endpoint care continuă să eșueze zile la rând este dezactivat automat, iar tu primești un mesaj pe Telegram despre asta, în loc de o lipsă tăcută.

Totul este inspectabil: trimite un ping de test înainte de lansare și răsfoiește istoricul livrărilor — încercare cu încercare, stare cu stare — ori de câte ori ai nevoie să depanezi partea ta a conductei.

Întrebări frecvente

Cum verific că un eveniment a venit cu adevărat de la Telm?

Fiecare livrare poartă un antet X-Telm-Signature: un HMAC-SHA256 al „timestamp.body” calculat cu secretul endpoint-ului tău. Recalculează-l de partea ta, compară în timp constant și respinge orice mai vechi de câteva minute pentru a exclude reluările.

Ce se întâmplă dacă serverul meu este căzut când se declanșează un eveniment?

Telm reîncearcă pe un program crescător — imediat, apoi după 1 minut, 5 minute, 30 de minute, 2 ore și 6 ore. Orice răspuns 2xx contează ca livrat. Evenimentele poartă un id stabil, așa că o reîncercare nu devine niciodată un duplicat în sistemul tău.

Poate un endpoint stricat să inunde la nesfârșit?

Nu. Un endpoint care eșuează de aproximativ douăzeci de ori la rând, fără niciun succes timp de trei zile, este dezactivat automat, iar tu primești o notificare pe Telegram. Repară-ți partea și reactivează-l dintr-un singur clic.

Cum îmi testez integrarea înainte de lansare?

Trimite un ping de test către orice endpoint direct din panou sau din API — sosește semnat exact ca un eveniment real. Istoricul livrărilor arată fiecare încercare cu starea ei.

Ce planuri includ webhook-uri?

Webhook-urile fac parte din pachetul API complet, inclus în planurile Pro și Business.

Unde folosesc echipele acest lucru

Tipuri reale de comunități unde această funcție face treaba grea.

Gata să începeți?

Începeți să vă protejați comunitatea astăzi. Plan gratuit disponibil.