V okamžiku, kdy nastane,
to váš server ví
Moderační události doručené na váš server v okamžiku, kdy nastanou: detekce spamu, bany, příchody a další — každé doručení podepsané HMAC, deduplikované a s opakováním podle rozvrhu, dokud váš endpoint nepotvrdí přijetí.
- Události v reálném čase
- Payloady podepsané HMAC
- Opakování až do doručení
Sedm událostí přímo z enginu
Přihlaste se na každém endpointu přesně k událostem, které potřebujete — od verdiktů o spamu po změny členství.
spam.detectedmessage.suspicioususer.banneduser.kickeduser.muteduser.joineduser.leftKaždá událost přichází v kompaktní JSON obálce: id, type, created_at, group_id a data události — id zůstává stabilní napříč opakováními, takže deduplikace je jediné vyhledání v množině.
Rozvrh opakování přesně tak, jak běží
Šest pokusů zhruba během osmi hodin — dost na to, aby přečkaly nasazení, restart nebo úplný výpadek na vaší straně.
0Okamžitě+1m+5m+30m+2h+6hPoslední pokusDoručování, na kterém lze stavět
Doručení alespoň jednou
Každá událost je doručena alespoň jednou. Váš endpoint potvrdí přijetí libovolnou odpovědí 2xx — cokoli jiného se vrací do fronty opakování.
Stabilní id pro deduplikaci
Každá událost má stabilní id, které přežije opakování. Deduplikace na vaší straně je jediné vyhledání, ne heuristika.
Žádné zombie endpointy
Endpoint, který selhává celé dny, se automaticky vypne — a vy dostanete Telegram DM místo tiché mezery ve vašich datech.
Testovací ping
Testovací událost na jedno kliknutí, podepsaná jako ta skutečná — ověřte si obsluhu dřív, než na ní bude záviset jediná reálná událost.
Prohlížitelná historie
Plná historie doručení pro každý endpoint: každý pokus, stav a časová značka — ladění vašeho příjemce se nikdy neopírá o dohady.
Pouze HTTPS, vždy podepsáno
Endpointy musí být veřejné HTTPS URL a každý payload je podepsaný. Pokrytý je jak přenos, tak autorství.
Ověřte každé doručení
Tři řádky na vaší straně — a nikdo nemůže událost zfalšovat ani přehrát.
# X-Telm-Signature: v1=<hex>
expected = hmac_sha256(secret, timestamp + "." + body)
valid = constant_time_eq("v1=" + hex(expected), header)Push, ne dotazování
Dotazování API vám řekne, co se stalo, když se zeptáte; webhooky vám to řeknou v okamžiku, kdy se to děje. Zaregistrujte HTTPS endpoint, vyberte události, na kterých vám záleží, a Telm je začne posílat na váš server jako JSON — vlnu spamu, ban, nálet příchozích — v sekundě, kdy engine zasáhne.
Každé doručení je podepsané. Hlavička X-Telm-Signature nese HMAC-SHA256 z časové značky a těla, spočítaný tajemstvím vašeho endpointu, takže váš server ověří autorství i čerstvost ve třech řádcích kódu. Payloady putují výhradně přes HTTPS.
Doručování je navržené pro skutečný internet, kde příjemci vypadávají. Události se doručují alespoň jednou se stabilním id pro deduplikaci; při selhání se opakují podle rostoucího rozvrhu — okamžitě, pak po 1 a 5 minutách, 30 minutách, 2 a 6 hodinách. Endpoint, který selhává celé dny, se automaticky vypne a vy dostanete zprávu na Telegramu místo tiché mezery.
Vše lze prohlížet: před ostrým provozem pošlete testovací ping a kdykoli potřebujete ladit svou stranu potrubí, procházejte historii doručení — pokus po pokusu, stav po stavu.
Často kladené dotazy
Jak ověřím, že událost opravdu přišla od Telm?
Každé doručení nese hlavičku X-Telm-Signature: HMAC-SHA256 z "timestamp.body" spočítaný tajemstvím vašeho endpointu. Přepočítejte jej na své straně, porovnejte v konstantním čase a odmítněte cokoli staršího než pár minut, abyste vyloučili replay útoky.
Co se stane, když je můj server při vzniku události nedostupný?
Telm opakuje podle rostoucího rozvrhu — okamžitě, pak po 1 minutě, 5 minutách, 30 minutách, 2 hodinách a 6 hodinách. Jakákoli odpověď 2xx se počítá jako doručeno. Události nesou stabilní id, takže se z opakování nikdy nestane duplicita ve vašem systému.
Může rozbitý endpoint zahltit systém navždy?
Ne. Endpoint, který selže zhruba dvacetkrát po sobě bez jediného úspěchu po tři dny, se automaticky vypne a vy dostanete oznámení na Telegramu. Opravte svou stranu a jedním kliknutím jej znovu zapněte.
Jak otestuji svou integraci před ostrým provozem?
Pošlete na kterýkoli endpoint testovací ping přímo z dashboardu nebo přes API — dorazí podepsaný přesně jako skutečná událost. Historie doručení ukáže každý pokus i jeho stav.
Které plány zahrnují webhooky?
Webhooky jsou součástí plného balíčku API, zahrnutého v plánech Pro a Business.
Kde to týmy používají
Skutečné typy komunit, kde tato funkce odvádí hlavní práci.
Udržujte podpůrné kanály čisté od spamu a umožněte novým uživatelům klást otázky. Režim podpory usnadňuje onboarding.
Profesionální moderování pro firemní skupiny a klientské komunity. Silná ochrana s podrobnými protokoly auditu.
Chraňte svou fanouškovskou základnu před podvodníky, kteří se za vás vydávají. Vytvořte bezpečný prostor pro vaši komunitu k propojení.
Související funkce
Prozkoumejte další způsoby, jak vám Telm může pomoci s vaší komunitou