Moc moderacji,
wywoływalna z Twojego kodu
Wepnij Telm we własne systemy: sprawdzaj dowolny tekst produkcyjnym silnikiem antyspamowym, zarządzaj ustawieniami i regułami grup z poziomu kodu, odczytuj dziennik decyzji i analitykę — wszystko przez czyste REST API z kluczami, które kontrolujesz.
- Stabilne REST v1
- Sprawdzanie spamu w każdym planie
- Webhooki w komplecie
Twoje pierwsze wywołanie w 30 sekund
Bez ceregieli z SDK: wystarczy wywołanie HTTPS z Twoim kluczem.
$ 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"]
}Jedno żądanie, jeden werdykt z produkcyjnego silnika — z oceną i powodami, które się uruchomiły. Odpowiedź przychodzi grubo poniżej sekundy dla sprawdzeń opartych na regułach.
Co potrafi API
Sprawdzanie spamu i użytkowników
Przepuść dowolny tekst przez ten sam silnik, który chroni grupy Telm — pojedyncze wywołania, paczki do 20 pozycji oraz weryfikacja użytkowników wobec CAS i własnego zbioru danych Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkGrupy i ustawienia
Odczytuj i modyfikuj ustawienia ochrony, zarządzaj własnymi regułami moderacji i białą listą — dla jednej grupy lub całej ich floty.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistDziennik i analityka
Odczytuj każdą decyzję silnika wraz z werdyktem, oceną i uruchomionymi regułami, pobieraj dzienne serie analityczne i śledź własne zużycie limitu.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageZarządzanie webhookami
Twórz endpointy webhooków i zarządzaj nimi, wysyłaj testowe pingi i przeglądaj historię dostarczeń — w całości przez API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesUczciwe limity, wypisane wprost na opakowaniu
| Plan | Wywołań dziennie | Limit tempa | Dostęp do API |
|---|---|---|---|
| Free | 100 | 60/min | Sprawdzanie spamu |
| Pro | 10 000 | 600/min | Pełne API + webhooki |
| Business | 50 000 | 1 800/min | Pełne API + webhooki |
Limity obowiązują na konto, a nie na klucz. Każda odpowiedź niesie nagłówki X-Quota-Limit, X-Quota-Used i X-Quota-Reset, a przekroczenie limitu zwraca czyste 429 z Retry-After — żadnych niespodzianek.
Klucze zbudowane tak, jak być powinny
Pokazany raz, przechowywany jako hash
Pełny klucz pojawia się dokładnie raz, przy tworzeniu. Telm przechowuje tylko hash — nikt, łącznie z nami, nie odczyta Twojego klucza z powrotem.
Zakresy odczyt/zapis
Klucze niosą zakresy odczytu i zapisu. Daj swojemu skryptowi raportującemu klucz tylko do odczytu — fizycznie nie zdoła zmienić żadnych ustawień.
Natychmiastowe unieważnianie
Unieważnij dowolny klucz w panelu, a przestanie działać natychmiast. Wyłącznik awaryjny na poziomie konta potrafi zamrozić cały dostęp do API naraz.
Pełne API i webhooki są wliczone w plany Pro i Business. Sprawdzanie spamu jest dostępne w każdym planie — także we Free — w ramach dziennego limitu.
Ten sam silnik, teraz pod Twoją kontrolą
Publiczne API udostępnia dokładnie ten sam silnik moderacji, który napędza bota Telm — a nie jego uproszczoną imitację. Wyślij tekst metodą POST na /spam/check, a przejdzie on przez identyczny potok, z którego korzystają Twoje grupy: sygnały reputacyjne, reguły i opcjonalnie klasyfikator AI. Dzięki temu ocenę Telm możesz wpleść wszędzie: w formularz wsparcia, we własnego bota, w sekcję komentarzy czy narzędzie wewnętrzne.
Poza sprawdzaniem API zarządza Twoimi grupami jak kodem. Odczytuj i modyfikuj ustawienia ochrony, twórz reguły moderacji, utrzymuj białe listy — te same operacje co w panelu, ale skryptowalne. Agencje prowadzące dziesiątki społeczności mogą wdrożyć zmianę polityki jedną pętlą zamiast dziesiątkami kliknięć.
Historia to obywatel pierwszej kategorii: endpoint dziennika zwraca każdą decyzję silnika — werdykt, ocenę, które reguły się uruchomiły i jakie działanie podjęto — z paginacją kursorową stworzoną z myślą o archiwizacji. W połączeniu z endpointem analityki możesz budować archiwa zgodności, wewnętrzne pulpity czy alerty na podstawie rzeczywistych danych Twojej grupy.
Uwierzytelnianie jest celowo nudne: klucze bearer tworzone w panelu, pokazywane raz, przechowywane jako hash, z zakresami odczyt/zapis i natychmiastowym unieważnianiem. Każda odpowiedź niesie nagłówki limitów, więc Twoja integracja zawsze wie, na czym stoi.
Najczęściej zadawane pytania
Które plany obejmują dostęp do API?
Sprawdzanie spamu (/spam/check) działa w każdym planie, także w Free, w ramach dziennego limitu. Pełne API — ustawienia grup, reguły, dziennik, analityka, weryfikacja użytkowników i webhooki — jest dostępne w Pro i Business.
Jakie są limity żądań?
Dzienne limity według planu: Free 100, Pro 10 000, Business 50 000 wywołań. Limity częstotliwości: 60 żądań na minutę na Free, 600 na Pro, 1800 na Business. Każda odpowiedź zawiera nagłówki X-Quota-Limit, X-Quota-Used i X-Quota-Reset.
Jak uzyskać klucz API?
W panelu, w sekcji Settings → API & Webhooks. Klucz jest pokazywany tylko raz, przy tworzeniu — przechowujemy wyłącznie jego hash. Możesz mieć do 10 aktywnych kluczy, ograniczyć je do trybu tylko do odczytu i natychmiast unieważnić dowolny z nich.
Czy klasyfikatora AI można używać przez API?
Tak, w Pro i Business: dodaj include_ai do zapytania /spam/check, a każde sprawdzenie AI zużyje osobny dzienny limit API — 1000 w Pro, 10 000 w Business. W Free sprawdzanie spamu przez API działa wyłącznie na regułach. Ten limit dotyczy tylko wywołań API: moderacja AI w Twoich grupach Telegram jest dostępna w każdym planie.
Czy jest specyfikacja OpenAPI?
Tak, pełna, czytelna maszynowo specyfikacja OpenAPI 3.1 jest opublikowana razem z dokumentacją dla deweloperów, więc możesz wygenerować z niej klientów lub podłączyć ją do swoich narzędzi.
Powiązane funkcje
Odkryj więcej sposobów, w jakie Telm może pomóc Twojej społeczności