La potenza della moderazione,
richiamabile dal tuo codice
Collega Telm ai tuoi sistemi: controlla qualsiasi testo con il motore anti-spam di produzione, gestisci le impostazioni e le regole dei gruppi da codice, leggi il registro delle decisioni e le analisi — tutto tramite una pulita API REST con chiavi che controlli tu.
- REST v1 stabile
- Controllo spam su ogni piano
- Webhook inclusi
La tua prima chiamata in 30 secondi
Nessuna cerimonia di SDK: basta una chiamata HTTPS con la tua chiave.
$ 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"]
}Una richiesta, un verdetto dal motore di produzione — con un punteggio e le ragioni che si sono attivate. La risposta arriva in ben meno di un secondo per i controlli basati su regole.
Cosa può fare l'API
Controlli su spam e utenti
Fai passare qualsiasi testo attraverso lo stesso motore che protegge i gruppi Telm — chiamate singole, batch fino a 20 e screening degli utenti su CAS più il dataset proprietario di Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGruppi e impostazioni
Leggi e modifica le impostazioni di protezione, gestisci le regole di moderazione personalizzate e la whitelist — per un gruppo o per una flotta di gruppi.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistRegistro e analisi
Leggi ogni decisione del motore con verdetto, punteggio e regole attivate, estrai le serie analitiche giornaliere e monitora il consumo della tua quota.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageGestione webhook
Crea e gestisci gli endpoint webhook, invia ping di prova e ispeziona lo storico delle consegne — interamente tramite API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesLimiti onesti, stampati sulla scatola
| Piano | Chiamate al giorno | Limite di frequenza | Accesso API |
|---|---|---|---|
| Free | 100 | 60/min | Controllo spam |
| Pro | 10 000 | 600/min | API completa + webhook |
| Business | 50 000 | 1 800/min | API completa + webhook |
I limiti si applicano per account, non per chiave. Ogni risposta porta con sé le intestazioni X-Quota-Limit, X-Quota-Used e X-Quota-Reset, e il raggiungimento di un limite restituisce un pulito 429 con Retry-After — nessuna sorpresa.
Chiavi costruite come si deve
Mostrata una volta, memorizzata come hash
La chiave completa appare esattamente una volta, alla creazione. Telm ne memorizza solo un hash — nessuno, noi compresi, può rileggere la tua chiave.
Ambiti di lettura/scrittura
Le chiavi portano ambiti di lettura e scrittura. Dai al tuo script di reportistica una chiave di sola lettura — non potrà fisicamente modificare alcuna impostazione.
Revoca immediata
Revoca una qualsiasi chiave dalla dashboard e smette di funzionare immediatamente. Un kill switch a livello di account può congelare tutto l'accesso API in una volta sola.
L'API completa e i webhook sono inclusi in Pro e Business. Il controllo spam è disponibile su ogni piano — incluso Free — entro la quota giornaliera.
Lo stesso motore, ora sotto il tuo controllo
L'API pubblica espone lo stesso motore di moderazione che fa girare il bot di Telm — non un'imitazione semplificata. Invia in POST un testo a /spam/check e passerà attraverso la pipeline identica che usano i tuoi gruppi: segnali di reputazione, regole e, facoltativamente, il classificatore IA. Questo significa che puoi incorporare il giudizio di Telm ovunque: un modulo di supporto, il tuo bot, una sezione commenti, uno strumento interno.
Oltre ai controlli, l'API gestisce i tuoi gruppi come codice. Leggi e modifica le impostazioni di protezione, crea regole di moderazione, mantieni le whitelist — le stesse operazioni della dashboard, ma programmabili. Le agenzie che gestiscono decine di community possono applicare un cambio di policy con un solo ciclo invece di decine di clic.
Lo storico è di prima classe: l'endpoint del registro restituisce ogni decisione presa dal motore — verdetto, punteggio, quali regole si sono attivate, quale azione è stata eseguita — con paginazione a cursore pensata per l'archiviazione. Combinato con l'endpoint di analisi puoi costruire archivi di conformità, dashboard interne o sistemi di alert sui dati reali del tuo gruppo.
L'autenticazione è volutamente noiosa: chiavi bearer create nella tua dashboard, mostrate una sola volta, memorizzate come hash, con ambiti (lettura/scrittura) e revoca immediata. Ogni risposta porta con sé le intestazioni di quota, così la tua integrazione sa sempre a che punto si trova.
Domande frequenti
Quali piani includono l'accesso all'API?
Il controllo spam (/spam/check) funziona su ogni piano, incluso Free, entro la quota giornaliera. L'API completa — impostazioni dei gruppi, regole, registro, analytics, verifica degli utenti e webhook — è inclusa in Pro e Business.
Quali sono i limiti di richieste?
Quote giornaliere per piano: Free 100, Pro 10.000, Business 50.000 chiamate. Limiti di frequenza: 60 richieste al minuto su Free, 600 su Pro, 1.800 su Business. Ogni risposta include gli header X-Quota-Limit, X-Quota-Used e X-Quota-Reset.
Come ottengo una chiave API?
Nella dashboard, in Impostazioni → API e Webhook. La chiave viene mostrata una sola volta alla creazione: ne viene salvato solo l'hash. Puoi avere fino a 10 chiavi attive, limitarle alla sola lettura e revocarne qualsiasi all'istante.
Il classificatore IA si può usare tramite l'API?
Sì, su Pro e Business: aggiungi include_ai a una richiesta /spam/check e ogni controllo IA consuma una quota API giornaliera separata — 1.000 su Pro, 10.000 su Business. Su Free, i controlli spam tramite API usano solo le regole. Questa quota riguarda solo le chiamate API: la moderazione IA all'interno dei tuoi gruppi Telegram è inclusa in ogni piano.
Esiste una specifica OpenAPI?
Sì, la specifica OpenAPI 3.1 completa e leggibile dalle macchine è pubblicata insieme alla documentazione per sviluppatori, così puoi generare client o collegarla ai tuoi strumenti.
Funzionalità correlate
Scopri altri modi in cui Telm può aiutare la tua community