Сила модерації,
викликана з вашого коду
Підключіть Telm до власних систем: перевіряйте будь-який текст бойовим антиспам-движком, керуйте налаштуваннями груп і правилами з коду, читайте журнал рішень та аналітику — усе через чистий REST API з ключами, якими володієте ви.
- Стабільний REST v1
- Перевірка спаму на кожному плані
- Webhooks у комплекті
Ваш перший виклик за 30 секунд
Жодних церемоній із SDK: достатньо HTTPS-виклику з вашим ключем.
$ 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"]
}Один запит — один вердикт від бойового движка, з оцінкою та причинами, що спрацювали. Для перевірок за правилами відповідь приходить значно менш ніж за секунду.
Що вміє API
Перевірка спаму та користувачів
Пропускайте будь-який текст через той самий движок, що захищає групи Telm, — поодинокі виклики, пакети до 20 і перевірка користувачів за CAS та власним датасетом Telm.
POST /spam/checkPOST /spam/check-batchPOST /users/checkГрупи та налаштування
Читайте й змінюйте налаштування захисту, керуйте власними правилами модерації та білим списком — для однієї групи чи цілого їх флоту.
GET/PATCH /groups/{id}/settingsCRUD /groups/{id}/rulesCRUD /groups/{id}/whitelistЖурнал та аналітика
Читайте кожне рішення движка — з вердиктом, оцінкою та спрацьованими правилами, витягуйте щоденні аналітичні ряди й відстежуйте власне використання квоти.
GET /groups/{id}/journalGET /groups/{id}/analyticsGET /usageКерування webhooks
Створюйте вебхук-ендпоінти й керуйте ними, надсилайте тестові пінги та переглядайте історію доставки — повністю через API.
CRUD /webhooksPOST /webhooks/{id}/testGET /webhooks/{id}/deliveriesЧесні ліміти, надруковані на коробці
| План | Викликів на день | Rate limit | Доступ до API |
|---|---|---|---|
| Free | 100 | 60/min | Перевірка спаму |
| Pro | 10 000 | 600/min | Повний API + webhooks |
| Business | 50 000 | 1 800/min | Повний API + webhooks |
Ліміти діють на акаунт, а не на ключ. Кожна відповідь несе заголовки X-Quota-Limit, X-Quota-Used та X-Quota-Reset, а досягнення ліміту повертає чистий 429 із Retry-After — без сюрпризів.
Ключі, зроблені як належить
Показано раз, збережено хешем
Повний ключ з'являється рівно один раз, під час створення. Telm зберігає лише хеш — ніхто, зокрема ми, не зможе прочитати ваш ключ назад.
Скоупи читання/запису
Ключі несуть скоупи читання й запису. Дайте своєму звітному скрипту ключ read-only — він фізично не зможе змінити жодне налаштування.
Миттєве відкликання
Відкличте будь-який ключ у кабінеті — і він одразу перестає працювати. Загальний kill switch на акаунт може заморозити весь доступ до API за раз.
Повний API та webhooks входять до Pro та Business. Перевірка спаму доступна на кожному плані — зокрема Free — у межах щоденної квоти.
Той самий движок — тепер під вашим контролем
Публічний API відкриває той самий движок модерації, що працює в боті Telm, — не спрощену імітацію. Надішліть текст POST-запитом на /spam/check, і він пройде через ідентичний конвеєр, яким користуються ваші групи: репутаційні сигнали, правила та, за потреби, AI-класифікатор. Це означає, що судження Telm можна вбудувати будь-куди: у форму підтримки, власного бота, секцію коментарів чи внутрішній інструмент.
Окрім перевірок, API керує вашими групами як кодом. Читайте й змінюйте налаштування захисту, створюйте правила модерації, ведіть білі списки — ті самі операції, що й у кабінеті, але скриптовані. Агенції, які ведуть десятки спільнот, можуть розкотити зміну політики одним циклом замість десятків кліків.
Історія — повноцінна частина: ендпоінт журналу повертає кожне рішення движка — вердикт, оцінку, які правила спрацювали, яку дію застосовано — з курсорною пагінацією, створеною для архівування. У парі з ендпоінтом аналітики ви побудуєте архіви для комплаєнсу, внутрішні дашборди чи алерти поверх реальних даних вашої групи.
Автентифікація навмисно нудна: bearer-ключі, створені у вашому кабінеті, показані один раз, збережені у вигляді хешу, зі скоупами читання/запису та миттєвим відкликанням. Кожна відповідь несе заголовки квоти, тож ваша інтеграція завжди знає, де вона стоїть.
Поширені запитання
На яких тарифах є доступ до API?
Перевірка спаму (/spam/check) працює на будь-якому тарифі, зокрема на Free, у межах денної квоти. Повний API — налаштування груп, правила, журнал, аналітика, перевірка користувачів і вебхуки — входить у Pro і Business.
Які ліміти на запити?
Денні квоти за тарифами: Free — 100, Pro — 10 000, Business — 50 000 викликів. Обмеження частоти: 60 запитів на хвилину на Free, 600 на Pro, 1 800 на Business. Кожна відповідь містить заголовки X-Quota-Limit, X-Quota-Used і X-Quota-Reset.
Як отримати API-ключ?
У кабінеті, в розділі Settings → API & Webhooks. Ключ показується один раз під час створення — зберігається лише його хеш. Можна мати до 10 активних ключів, обмежувати їх доступом лише на читання й миттєво відкликати будь-який із них.
Чи можна користуватися AI-класифікатором через API?
Так, на Pro і Business: додайте include_ai до запиту /spam/check, і кожна AI-перевірка витрачатиме окремий денний ліміт API — 1 000 на Pro, 10 000 на Business. На Free перевірки спаму через API працюють лише на правилах. Цей ліміт стосується лише викликів API: AI-модерація у ваших групах Telegram входить у будь-який тариф.
Чи є специфікація OpenAPI?
Так, повну машинозчитувану специфікацію OpenAPI 3.1 опубліковано разом із документацією для розробників — за нею можна згенерувати клієнти або підключити її до своїх інструментів.
Пов'язані функції
Дізнайтеся більше про те, як Telm може допомогти вашій спільноті