Síla moderace,
volatelná z vašeho kódu
Zapojte Telm do vlastních systémů: prověřte libovolný text produkčním antispamovým enginem, spravujte nastavení a pravidla skupin z kódu, čtěte deník rozhodnutí i analytiku — to vše přes čisté REST API s klíči, které řídíte vy.
- Stabilní REST v1
- Kontrola spamu v každém plánu
- Webhooky v ceně
Vaše první volání za 30 sekund
Žádné SDK ceremonie: stačí HTTPS volání s vaším klíčem.
$ curl -X POST https://api.telm.com/api/public/v1/spam/check \
-H "Authorization: Bearer tk_live_..." \
-d '{"text": "Earn $500/day from home!! DM me now"}'
// HTTP 200
{
"verdict": "spam",
"score": 97,
"reasons": ["contact_flow", "money_lure"]
}Jeden požadavek, jeden verdikt z produkčního enginu — se skóre a důvody, které se spustily. U kontrol založených na pravidlech dorazí odpověď výrazně pod jednu sekundu.
Co API umí
Kontroly spamu a uživatelů
Prožeňte libovolný text stejným enginem, který chrání skupiny Telm — jednotlivá volání, dávky až po 20 a prověrku uživatelů proti CAS i vlastnímu datasetu Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkSkupiny a nastavení
Čtěte a upravujte nastavení ochrany, spravujte vlastní pravidla moderace i whitelist — pro jednu skupinu nebo celou flotilu.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistDeník a analytika
Čtěte každé rozhodnutí enginu s verdiktem, skóre a spuštěnými pravidly, stahujte denní analytické řady a sledujte vlastní spotřebu kvóty.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageSpráva webhooků
Vytvářejte a spravujte webhookové endpointy, posílejte testovací pingy a prohlížejte historii doručení — celé přes API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesPoctivé limity, vytištěné na krabici
| Plán | Volání za den | Rate limit | Přístup k API |
|---|---|---|---|
| Free | 100 | 60/min | Kontrola spamu |
| Basic | 1 000 | 60/min | Kontrola spamu |
| Pro | 10 000 | 600/min | Plné API + webhooky |
| Business | 50 000 | 1 800/min | Plné API + webhooky |
Limity platí na účet, ne na klíč. Každá odpověď nese hlavičky X-Quota-Limit, X-Quota-Used a X-Quota-Reset a při dosažení limitu vrátí čistou 429 s Retry-After — žádná překvapení.
Klíče postavené tak, jak mají být
Zobrazeno jednou, uloženo jako hash
Plný klíč se objeví přesně jednou, při vytvoření. Telm ukládá pouze hash — nikdo, včetně nás, váš klíč nepřečte zpět.
Rozsahy čtení/zápis
Klíče nesou rozsahy čtení a zápis. Dejte svému reportovacímu skriptu klíč jen pro čtení — fyzicky nemůže změnit žádné nastavení.
Okamžité odvolání
Odvolejte kterýkoli klíč z dashboardu a okamžitě přestane fungovat. Nouzový vypínač pro celý účet umí naráz zmrazit veškerý přístup k API.
Plné API a webhooky jsou součástí plánů Pro a Business. Kontrola spamu je dostupná v každém plánu — včetně Free — v rámci denní kvóty.
Tentýž engine, teď pod vaší kontrolou
Veřejné API zpřístupňuje tentýž moderační engine, který pohání bota Telm — ne zjednodušenou napodobeninu. Pošlete POST s textem na /spam/check a projde identickým procesem jako vaše skupiny: signály reputace, pravidla a volitelně AI klasifikátor. Znamená to, že úsudek Telm můžete zabudovat kamkoli: do podpůrného formuláře, vlastního bota, sekce komentářů nebo interního nástroje.
Kromě kontrol API spravuje vaše skupiny jako kód. Čtěte a upravujte nastavení ochrany, vytvářejte pravidla moderace, udržujte whitelisty — stejné operace jako v dashboardu, ale skriptovatelné. Agentury spravující desítky komunit tak zavedou změnu politiky jedním cyklem místo desítek kliknutí.
Historie je prvořadá: endpoint deníku vrací každé rozhodnutí, které engine učinil — verdikt, skóre, která pravidla se spustila i jakou akci provedl — s kurzorovým stránkováním připraveným k archivaci. Ve spojení s analytickým endpointem tak nad reálnými daty své skupiny postavíte archivy pro compliance, interní dashboardy nebo alerting.
Autentizace je záměrně nudná: bearer klíče vytvořené ve vašem dashboardu, zobrazené jen jednou, uložené jako hash, s rozsahy čtení/zápis a okamžitým odvoláním. Každá odpověď nese hlavičky kvóty, takže vaše integrace vždy ví, na čem je.
Často kladené dotazy
Které plány zahrnují přístup k API?
Kontrola spamu (/spam/check) funguje v každém plánu včetně Free, v rámci denní kvóty. Plné API — nastavení skupin, pravidla, deník, analytika, prověrka uživatelů a webhooky — je součástí plánů Pro a Business.
Jaké jsou limity požadavků?
Denní kvóty podle plánu: Free 100, Basic 1 000, Pro 10 000, Business 50 000 volání. Rate limity: 60 požadavků za minutu u Free a Basic, 600 u Pro a 1 800 u Business. Každá odpověď obsahuje hlavičky X-Quota-Limit, X-Quota-Used a X-Quota-Reset.
Jak získám API klíč?
V dashboardu v Nastavení → API a Webhooky. Klíč se při vytvoření zobrazí jen jednou — uloží se pouze jeho hash. Můžete mít až 10 aktivních klíčů, omezit je jen na čtení a kterýkoli z nich okamžitě odvolat.
Lze přes API použít AI klasifikátor?
Ano — předejte include_ai v /spam/check a odpověď doplní AI verdikt. AI kontroly čerpají ze samostatné denní AI kvóty dostupné v plánech Pro a Business.
Existuje specifikace OpenAPI?
Ano, plná strojově čitelná specifikace OpenAPI 3.1 je publikovaná spolu s vývojářskou dokumentací, takže si můžete generovat klienty nebo ji zapojit do svého nástrojového řetězce.
Kde to týmy používají
Skutečné typy komunit, kde tato funkce odvádí hlavní práci.
Profesionální moderování pro firemní skupiny a klientské komunity. Silná ochrana s podrobnými protokoly auditu.
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.
Ochraňte svou kryptoskupinu před podvodníky, falešnými airdropy a phishingovými odkazy — včetně podvodů skrytých uvnitř obrázků.
Související funkce
Prozkoumejte další způsoby, jak vám Telm může pomoci s vaší komunitou