La puissance de modération,
appelable depuis votre code
Branchez Telm sur vos propres systèmes : vérifiez n'importe quel texte avec le moteur anti-spam de production, gérez les paramètres et règles de vos groupes depuis votre code, lisez le journal de décisions et l'analytique — le tout via une API REST claire, avec des clés que vous contrôlez.
- REST v1 stable
- Vérification anti-spam sur tous les plans
- Webhooks inclus
Votre premier appel en 30 secondes
Aucune cérémonie de SDK : un appel HTTPS avec votre clé suffit.
$ 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"]
}Une requête, un verdict du moteur de production — avec un score et les raisons qui se sont déclenchées. La réponse arrive en bien moins d'une seconde pour les vérifications basées sur des règles.
Ce que l'API permet de faire
Vérifications de spam et d'utilisateurs
Passez n'importe quel texte dans le moteur même qui protège les groupes Telm — appels unitaires, lots jusqu'à 20, et filtrage des utilisateurs face à CAS et au jeu de données propre à Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGroupes et paramètres
Lisez et modifiez les paramètres de protection, gérez vos règles de modération personnalisées et la liste blanche — pour un groupe ou pour une flotte entière.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistJournal et analytique
Lisez chaque décision du moteur avec son verdict, son score et les règles déclenchées, récupérez des séries analytiques quotidiennes et suivez votre propre consommation de quota.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageGestion des webhooks
Créez et gérez vos endpoints de webhook, envoyez des pings de test et inspectez l'historique de livraison — entièrement via l'API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesDes limites honnêtes, affichées sur l'emballage
| Plan | Appels par jour | Limite de débit | Accès API |
|---|---|---|---|
| Free | 100 | 60/min | Vérification anti-spam |
| Basic | 1 000 | 60/min | Vérification anti-spam |
| Pro | 10 000 | 600/min | API complète + webhooks |
| Business | 50 000 | 1 800/min | API complète + webhooks |
Les limites s'appliquent par compte, pas par clé. Chaque réponse transporte les en-têtes X-Quota-Limit, X-Quota-Used et X-Quota-Reset, et atteindre une limite renvoie un 429 propre avec Retry-After — sans mauvaise surprise.
Des clés conçues comme il se doit
Affichée une fois, stockée en hash
La clé complète n'apparaît qu'une seule fois, à la création. Telm ne stocke qu'un hash — personne, nous compris, ne peut relire votre clé.
Portées lecture/écriture
Les clés portent des portées (scopes) de lecture et d'écriture. Donnez à votre script de reporting une clé en lecture seule — elle ne peut physiquement modifier aucun paramètre.
Révocation instantanée
Révoquez n'importe quelle clé depuis le tableau de bord et elle cesse de fonctionner immédiatement. Un coupe-circuit par compte peut geler d'un coup tous les accès à l'API.
L'API complète et les webhooks sont inclus dans Pro et Business. La vérification anti-spam est disponible sur tous les plans — y compris Free — dans la limite du quota quotidien.
Le même moteur, désormais sous votre contrôle
L'API publique expose le moteur de modération même qui fait tourner le bot Telm — pas une imitation simplifiée. Envoyez un texte en POST à /spam/check et il traverse le pipeline identique à celui qu'utilisent vos groupes : signaux de réputation, règles et, en option, le classificateur IA. Vous pouvez ainsi intégrer le jugement de Telm partout : un formulaire de support, votre propre bot, une section de commentaires, un outil interne.
Au-delà des vérifications, l'API gère vos groupes sous forme de code. Lisez et modifiez les paramètres de protection, créez des règles de modération, entretenez des listes blanches — les mêmes opérations que le tableau de bord, mais scriptables. Les agences qui gèrent des dizaines de communautés peuvent déployer un changement de politique en une seule boucle plutôt qu'en des dizaines de clics.
L'historique est de premier plan : l'endpoint du journal renvoie chaque décision prise par le moteur — verdict, score, règles déclenchées, action appliquée — avec une pagination par curseur pensée pour l'archivage. Combiné à l'endpoint d'analytique, il permet de construire des archives de conformité, des tableaux de bord internes ou des alertes bâties sur les données réelles de votre groupe.
L'authentification est délibérément banale : des clés bearer créées dans votre tableau de bord, affichées une seule fois, stockées sous forme de hash, avec des portées (scopes) de lecture/écriture et une révocation instantanée. Chaque réponse transporte des en-têtes de quota, pour que votre intégration sache toujours où elle en est.
Frequently asked questions
Which plans include API access?
Spam checking (/spam/check) works on every plan, including Free, within the daily quota. The full API — group settings, rules, journal, analytics, user screening and webhooks — is included in Pro and Business.
What are the request limits?
Daily quotas by plan: Free 100, Basic 1,000, Pro 10,000, Business 50,000 calls. Rate limits: 60 requests per minute on Free and Basic, 600 on Pro, 1,800 on Business. Every response includes X-Quota-Limit, X-Quota-Used and X-Quota-Reset headers.
How do I get an API key?
In the dashboard under Settings → API & Webhooks. The key is shown once at creation — only its hash is stored. You can hold up to 10 active keys, scope them to read-only, and revoke any of them instantly.
Can the AI classifier be used through the API?
AI checks consume the plan’s separate daily AI quota: Basic 100, Pro 1,000, Business 10,000 (Free has none).
Is there an OpenAPI specification?
Yes, the full machine-readable OpenAPI 3.1 spec is published alongside the developer documentation, so you can generate clients or plug it into your tooling.
Fonctionnalités connexes
Découvrez d'autres façons dont Telm peut aider votre communauté