Telegram Userbot API · REST

Mijozlarga birinchi boʻlib yozing
jonli akkauntdan

Isitilgan akkauntlar puli ustidagi oʻn ikkita metod: chat ishtirokchilarini yigʻish, profilni tekshirish, suhbat boshlash va unda javob berish. CRM’dan, n8n’dan yoki istalgan HTTP-klientdan chaqiriladi — kalit va huquqlar kabinetda chiqariladi.

API-kalit olish → Metodlarni koʻrish

Chaqiruvlar uchun alohida toʻlov yoʻq — API akkauntlar ijarasiga kiradi, $90/oy

POST /public/methods/start_dialog

        POST https://api.intelgram.ai/api/v1/public/methods/start_dialog

        Authorization: Bearer igrm_ВАШ_КЛЮЧ

        {

          "account_id": "3fa85f64-…",

          "peer_id": 123456789,

          "text": "Salom! Bir daqiqangiz bormi?"

        }

        // job_id — chipta: natija ikkinchi soʻrov bilan olinadi

        { "job_id": "8f14e45f-…", "status": "pending" }

Qanday ishlaydi

4 qadamda ishga tushirish

Metodlarni server emas, jonli Telegram akkaunt bajaradi, shuning uchun chaqiruv va natija ajratilgan: vazifa navbatga turadi va odamnikidek pauzalar bilan boradi.

01 /

Kalit chiqarish

Kabinetda, API boʻlimida. Huquqlarni oʻzingiz belgilaysiz — bu sahifadagi metodlarga akkaunt harakatlari huquqi kerak.

02 /

Metodni chaqirish

Metod manziliga POST, tanasida parametrlar. Bitta akkaunt — soʻrov tanasida bitta account_id.

03 /

Chipta olish

Javobda job_id va pending statusi keladi: vazifa qabul qilindi va bajarilish navbatiga qoʻyildi.

04 /

Natijani olish

job_id boʻyicha soʻrov bilan. wait parametri javobni 30 soniyagacha ushlab turadi va tayyor boʻlgan zahoti qaytaradi.

API

Oʻn ikkita metod
akkaunt bilan ishlash uchun

Auditoriya va profillar

POSTresolve_username1000/kun

POSTresolve_post_author1000/kun

POSTget_entity_data30/kun

POSTget_personal_channel_data1000/kun

POSTsearch_entitieslimitsiz

POSTfetch_members_pagelimitsiz

POSTfetch_messages_pagelimitsiz

POSTlist_dialogslimitsiz

Suhbatlar

POSTstart_dialog30/12 soat

POSTsend_reply1000/kun

Akkaunt rasmiylashtirish

POSTset_name10/kun

POSTset_bio10/kun

Natija

GETjobs/{job_id}600/daq

Qanday chaqirish

cURLn8n Makeistalgan HTTP-klient

POST /public/methods/resolve_username

← Misolni koʻrish uchun metodni bosing

Ommaviy @username boʻyicha toʻliq profil: ism, tavsif, belgilar, premium, oxirgi tashrif.

Chaqiruv shartnomasi

Chaqiruv ulanishingizni ushlab turmaydi

Harakatni oʻz navbati va pauzalari bilan ijaraga olingan akkaunt bajaradi. Kodingiz uni kutmaydi: chipta oladi va natija uchun qulay paytda qaytadi.

🎫

Javob — chipta, natija emas

Metod job_id, metod nomi, akkaunt va pending statusini qaytaradi. Bu vazifa ishga qabul qilinganini tasdiqlaydi.

🔄

Natija soʻrov orqali

job_id boʻyicha soʻrov pending, done yoki error qaytaradi. wait parametri bilan ulanish 30 soniyagacha ushlanadi va aynan tayyor boʻlganda javob beradi.

📊

Limitlar har bir akkaunt boʻyicha hisoblanadi

Oʻn ikki soatda oʻttizta birinchi xabar, kuniga ming javob, oʻttizta toʻliq profil tekshiruvi, oʻnta ism oʻzgartirish. Hajm ijaraga olingan akkauntlar soni bilan yigʻiladi.

⚠️

Xato sabab bilan keladi

error statusi va sababi matn bilan: akkaunt cheklovga tushdi, suhbatdosh shaxsiy xabarlarni yopdi. Qayta urinishni siz hal qilasiz — platforma chaqiruvni qaytarmaydi.

Kirish

Kalit faqat belgilangan boʻlimlarni ochadi

Huquqlar platforma boʻlimlari boʻyicha va oʻqish hamda yozish uchun alohida beriladi. Kalitlar bir nechta boʻlishi mumkin — integratsiya uchun alohida, hisobot yuklash uchun alohida.

accounts:actions accounts:read audience:read audience:write campaigns:read campaigns:write flows:read flows:write wallet:read

Bu sahifadagi metodlarga bitta huquq kerak — accounts:actions, u natija soʻrovini ham ochadi. Kalit kabinetda istalgan vaqtda bekor qilinadi: kirish darhol yoʻqoladi, qolgan kalitlar ishlashda davom etadi.

Use cases

Bunda nima quriladi

Kabinetda qoʻlda ishlash oʻrniga metodlarga kirish olinadigan stsenariylar

⚙️

CRM’dan trigger boʻyicha murojaatlar

Bitim toʻxtab qoldi, buyurtma yetkazildi, obuna tugayapti — tizimingiz qachon yozishni oʻzi hal qiladi va metodni chaqiradi. Mijozlar javoblari kabinetda, kampaniya suhbatlarida koʻrinadi.

start_dialog Reaktivatsiya Trigger stsenariylari

🎯

Ishga tushirishdan oldin bazani tekshirish

Roʻyxatni profillar orqali oʻtkazib, oʻchirilganlarni, skam deb belgilanganlarni va yarim yildan beri kirmaganlarni saralab tashlash. Ularga birinchi xabar limitini sarflagandan koʻra tekshirish arzonroq.

resolve_username get_entity_data Skoring

🗂️

Auditoriyani oʻz tizimingizga yigʻish

Mavzuli chat ishtirokchilari, kanal postlari ostidagi izoh mualliflari, qidiruvdan olingan profillar — sahifama-sahifa, kursor bilan, toʻgʻridan-toʻgʻri bazangizga.

fetch_members_page resolve_post_author search_entities

🪪

Oʻz akkaunt rasmiylashtirishingiz

Har bir kampaniya uchun ishchi akkauntning oʻz ismi va tavsifi: xizmat bildirishnomalari va sovuq autrich bitta «menejer»dan kelmasligi kerak.

set_name set_bio Rasmiylashtirish

FAQ

Metodlar haqida tez-tez beriladigan savollar

Bot faqat oʻziga yozganlarga yozadi va suhbatni tugmalar bilan olib boradi. Bu yerda metodlarni platformada ijaraga olingan oddiy Telegram akkaunt bajaradi — u suhbatni birinchi boʻlib boshlashi mumkin va xabar odamdan kelgandek, bildirishnoma bilan keladi. Qatorma-qator taqqoslash bosh sahifada.

Xuddi shu API bilan. Ommaviy nik boʻyicha — resolve_username, chat ishtirokchilari boʻyicha — fetch_members_page, kanal posti muallifi boʻyicha — resolve_post_author. Har bir metod javobida telegram_id bor, u yuborish uchun peer_id ham hisoblanadi.

job_id boʻyicha soʻrov bilan. wait parametri ulanishni oʻttiz soniyagacha ushlab turadi va aynan tayyor boʻlganda javob beradi — bu soʻrovdan koʻra obunaga yaqinroq tuyuladi.

Chastota — daqiqasiga oltmish metod chaqiruvi va olti yuz status soʻrovi. Harakat limitlari har bir akkaunt boʻyicha hisoblanadi: oʻn ikki soatda oʻttizta birinchi xabar, kuniga ming javob, oʻttizta toʻliq profil tekshiruvi, oʻnta ism va tavsif oʻzgartirish. Koʻproq hajm kerak boʻlsa — u ijaraga olingan akkauntlar soni bilan yigʻiladi.

Metodlar platformada ijaraga olingan akkauntlarda ishlaydi — ularning identifikatori account_id’ga uzatiladi. Isitish, limitlar va akkaunt holati bizning zimmamizda, shaxsiy raqamingiz esa chetda qoladi.

Chaqiruvlar uchun alohida toʻlov yoʻq: API platformada ijaraga olingan oʻsha akkauntlarda ochiq, oyiga har biri $90 dan. Akkauntlar qancha koʻp boʻlsa, har birining narxi shuncha past — hajmni hisoblash mumkin bosh sahifada.

Mijozlarga birinchi boʻlib yozingjonli akkauntdan