Putere de moderare,
apelabilă din codul tău
Conectează Telm în propriile tale sisteme: verifică orice text cu motorul anti-spam de producție, gestionează setările și regulile grupurilor din cod, citește registrul de decizii și analiza — totul printr-o API REST curată, cu chei pe care le controlezi.
- REST v1 stabilă
- Verificare spam pe orice plan
- Webhook-uri incluse
Primul tău apel în 30 de secunde
Fără ceremonie de SDK: un apel HTTPS cu cheia ta este tot ce trebuie.
$ 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"]
}O cerere, un verdict de la motorul de producție — cu un scor și motivele care s-au declanșat. Răspunsul sosește în mult sub o secundă pentru verificările bazate pe reguli.
Ce poate face API-ul
Verificări de spam și utilizatori
Treci orice text prin același motor care protejează grupurile Telm — apeluri individuale, loturi de până la 20 și verificarea utilizatorilor față de CAS plus setul de date propriu al Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGrupuri și setări
Citește și modifică setările de protecție, gestionează reguli de moderare personalizate și lista albă — pentru un singur grup sau o flotă întreagă.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistRegistru și analiză
Citește fiecare decizie a motorului cu verdict, scor și regulile declanșate, extrage serii de analiză zilnice și urmărește-ți propriul consum de cotă.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageGestionarea webhook-urilor
Creează și gestionează endpoint-uri de webhook, trimite ping-uri de test și inspectează istoricul livrărilor — în întregime prin API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesLimite oneste, scrise pe cutie
| Plan | Apeluri pe zi | Limită de rată | Acces API |
|---|---|---|---|
| Free | 100 | 60/min | Verificare spam |
| Basic | 1 000 | 60/min | Verificare spam |
| Pro | 10 000 | 600/min | API complet + webhook-uri |
| Business | 50 000 | 1 800/min | API complet + webhook-uri |
Limitele se aplică per cont, nu per cheie. Fiecare răspuns poartă anteturile X-Quota-Limit, X-Quota-Used și X-Quota-Reset, iar atingerea unei limite returnează un 429 curat cu Retry-After — fără surprize.
Chei construite așa cum trebuie
Afișată o dată, stocată ca hash
Cheia completă apare exact o dată, la creare. Telm stochează doar un hash — nimeni, inclusiv noi, nu îți poate citi cheia înapoi.
Domenii de citire/scriere
Cheile poartă domenii de citire și scriere. Dă-i scriptului tău de raportare o cheie doar-citire — fizic nu poate modifica nicio setare.
Revocare instantanee
Revocă orice cheie din panou și ea încetează să funcționeze imediat. Un întrerupător de urgență per cont poate îngheța tot accesul la API dintr-o dată.
API-ul complet și webhook-urile sunt incluse în Pro și Business. Verificarea spamului este disponibilă pe orice plan — inclusiv Free — în limita cotei zilnice.
Același motor, acum sub controlul tău
API-ul public expune același motor de moderare care rulează botul Telm — nu o imitație simplificată. Trimiți un text prin POST către /spam/check și acesta parcurge exact același flux pe care îl folosesc grupurile tale: semnale de reputație, reguli și, opțional, clasificatorul AI. Asta înseamnă că poți încorpora judecata Telm oriunde: un formular de suport, propriul tău bot, o secțiune de comentarii, un instrument intern.
Dincolo de verificări, API-ul îți gestionează grupurile ca pe cod. Citește și modifică setările de protecție, creează reguli de moderare, întreține liste albe — aceleași operațiuni ca în panou, dar programabile. Agențiile care administrează zeci de comunități pot aplica o schimbare de politică printr-o singură buclă, în loc de zeci de clicuri.
Istoricul este de prim rang: endpoint-ul registrului returnează fiecare decizie luată de motor — verdict, scor, ce reguli s-au declanșat, ce acțiune s-a aplicat — cu paginare pe cursor, construită pentru arhivare. Combinat cu endpoint-ul de analiză, poți construi arhive de conformitate, tablouri de bord interne sau alerte peste datele reale ale grupului tău.
Autentificarea este intenționat plictisitoare: chei de tip bearer create în panoul tău, afișate o singură dată, stocate ca hash, cu domenii de citire/scriere și revocare instantanee. Fiecare răspuns poartă anteturi de cotă, așa că integrarea ta știe mereu unde se află.
Întrebări frecvente
Ce planuri includ accesul la API?
Verificarea spamului (/spam/check) funcționează pe orice plan, inclusiv Free, în limita cotei zilnice. API-ul complet — setări de grup, reguli, registru, analiză, verificarea utilizatorilor și webhook-uri — este inclus în Pro și Business.
Care sunt limitele de cereri?
Cote zilnice pe plan: Free 100, Basic 1.000, Pro 10.000, Business 50.000 de apeluri. Limite de rată: 60 de cereri pe minut pe Free și Basic, 600 pe Pro, 1.800 pe Business. Fiecare răspuns include anteturile X-Quota-Limit, X-Quota-Used și X-Quota-Reset.
Cum obțin o cheie API?
În panou, la Settings → API & Webhooks. Cheia este afișată o singură dată la creare — se stochează doar hash-ul ei. Poți deține până la 10 chei active, le poți limita la doar citire și poți revoca oricare dintre ele instantaneu.
Poate fi folosit clasificatorul AI prin API?
Da — transmite include_ai în /spam/check și răspunsul adaugă verdictul AI. Verificările AI consumă dintr-o cotă AI zilnică separată, disponibilă pe Pro și Business.
Există o specificație OpenAPI?
Da, specificația OpenAPI 3.1 completă, citibilă de mașină, este publicată alături de documentația pentru dezvoltatori, așa că poți genera clienți sau o poți integra în instrumentele tale.
Unde folosesc echipele acest lucru
Tipuri reale de comunități unde această funcție face treaba grea.
Moderare profesională pentru grupuri de companie și comunități de clienți. Protecție puternică cu jurnale de audit detaliate.
Menține canalele de suport curate de spam în timp ce permiți utilizatorilor noi să pună întrebări. Modul de suport face integrarea ușoară.
Protejează-ți grupul cripto de escroci, airdropuri false și linkuri de phishing — inclusiv escrocheriile ascunse în imagini.
Funcții conexe
Explorați mai multe moduri în care Telm vă poate ajuta comunitatea