Telegram Userbot API · REST

Пишіть клієнтам першими
з живого акаунта

Дванадцять методів поверх пулу прогрітих акаунтів: зібрати учасників чату, перевірити профіль, почати діалог і відповісти в ньому. Викликається з вашої CRM, з n8n або будь-якого HTTP-клієнта — ключ і права випускаються в кабінеті.

Отримати API-ключ → Дивитись методи

Окремої плати за виклики немає — API входить в оренду акаунтів, від $90/міс

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": "Привіт! Є хвилина?"
}

// job_id — квиток: результат забирається другим запитом
{ "job_id": "8f14e45f-…", "status": "pending" }
Як працює

Запуск за 4 кроки

Методи виконує живий Telegram-акаунт, а не сервер, тому виклик і результат рознесені: задача стає в чергу й іде з паузами, як у людини.

01 /
Випустити ключ
У кабінеті, у розділі API. Права відмічаєте самі — методам цієї сторінки потрібне право на дії акаунтів.
02 /
Викликати метод
POST на адресу методу з тілом із параметрів. Один акаунт — один account_id у тілі запиту.
03 /
Отримати квиток
У відповідь приходить job_id і статус pending: задача прийнята і поставлена в чергу на виконання.
04 /
Забрати результат
Запитом за job_id. Параметр wait тримає відповідь до 30 секунд і віддає її в момент готовності.
API

Дванадцять методів
роботи з акаунтом

Аудиторія та профілі
POSTresolve_username1000/доба
POSTresolve_post_author1000/доба
POSTget_entity_data30/доба
POSTget_personal_channel_data1000/доба
POSTsearch_entitiesбез ліміту
POSTfetch_members_pageбез ліміту
POSTfetch_messages_pageбез ліміту
POSTlist_dialogsбез ліміту
Діалоги
POSTstart_dialog30/12 год
POSTsend_reply1000/доба
Оформлення акаунта
POSTset_name10/доба
POSTset_bio10/доба
Результат
GETjobs/{job_id}600/хв
Як викликати
cURLn8n Makeбудь-який HTTP-клієнт
POST /public/methods/resolve_username

← Натисніть на метод, щоб побачити приклад

Профіль за публічним @username цілком: ім'я, опис, мітки, преміум, останній візит.

Контракт виклику

Виклик не тримає ваше з'єднання

Дію виконує орендований акаунт зі своєю чергою і паузами. Ваш код не чекає його: отримує квиток і повертається за результатом, коли зручно.

🎫
Відповідь — квиток, а не результат

Метод повертає job_id, ім'я методу, акаунт і статус pending. Це підтвердження, що задача прийнята в роботу.

🔄
Результат — за опитуванням

Запит за job_id віддає pending, done або error. З параметром wait з'єднання тримається до 30 секунд і відповідає рівно в момент готовності.

📊
Ліміти рахуються на акаунт

Тридцять перших повідомлень за дванадцять годин, тисяча відповідей на добу, тридцять повних перевірок профілю, десять змін імені. Обсяг набирається кількістю орендованих акаунтів.

⚠️
Помилка приходить із причиною

Статус error і причина текстом: акаунт отримав обмеження, співрозмовник закрив особисті повідомлення. Повтор вирішуєте ви — платформа виклик не переграє.

Доступ

Ключ відкриває лише відмічені розділи

Права видаються за розділами платформи й окремо на читання та запис. Ключів може бути кілька — свій на інтеграцію, свій на вивантаження звітів.

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

Методам з цієї сторінки потрібне одне право — accounts:actions, воно ж відкриває запит результату. Ключ відкликається в кабінеті будь-якої миті: доступ зникає одразу, решта ключів продовжують працювати.

Use cases

Що на цьому будують

Сценарії, заради яких беруть доступ до методів, а не працюють руками в кабінеті

01
⚙️
Торкання за тригером із CRM

Угода зависла, замовлення доставлено, підписка закінчується — ваша система сама вирішує, коли написати, і викликає метод. Відповіді клієнтів видно в кабінеті, у діалогах кампанії.

start_dialog Реактивація Тригерні сценарії
02
🎯
Перевірка бази перед запуском

Прогнати список через профілі й відсіяти видалених, позначених як скам і тих, хто не заходив пів року. Дешевше перевірити, ніж витратити на них ліміт перших повідомлень.

resolve_username get_entity_data Скоринг
03
🗂️
Збір аудиторії у свою систему

Учасники тематичного чату, автори коментарів під дописами каналу, профілі з пошуку — сторінками, з курсором, просто у вашу базу.

fetch_members_page resolve_post_author search_entities
04
🪪
Своє оформлення акаунтів

Під кожну кампанію — своє ім'я та опис робочого акаунта: сервісні сповіщення і холодний аутріч не повинні приходити від одного й того самого «менеджера».

set_name set_bio Оформлення
FAQ

Часті питання про методи

Бот пише лише тим, хто сам йому написав, і веде розмову кнопками. Тут методи виконує звичайний акаунт Telegram, орендований у платформі, — він може почати діалог першим, і повідомлення приходить зі сповіщенням, як від людини. Порядкове порівняння є на головній.
Тим самим API. За публічним ніком — resolve_username, за учасниками чату — fetch_members_page, за автором допису в каналі — resolve_post_author. У відповіді кожного методу є telegram_id, він же peer_id для надсилання.
Запитом за job_id. Параметр wait тримає з'єднання до тридцяти секунд і відповідає рівно в момент готовності — за відчуттями це ближче до підписки, ніж до опитування.
Частота — шістдесят викликів методів на хвилину і шістсот запитів статусу. Ліміти дій рахуються на акаунт: тридцять перших повідомлень за дванадцять годин, тисяча відповідей на добу, тридцять повних перевірок профілю, десять змін імені та опису. Потрібен обсяг більший — він набирається кількістю орендованих акаунтів.
Методи працюють від акаунтів, орендованих у платформі, — їхній ідентифікатор і передається в account_id. Прогрів, ліміти та стан акаунта беремо на себе ми, а ваш особистий номер лишається осторонь.
Окремої плати за виклики немає: API відкритий на тих самих акаунтах, що орендовані в платформі, від $90 на місяць за акаунт. Що більше акаунтів, то нижча ціна кожного — порахувати обсяг можна на головній.

Зробіть перший виклик

Випустіть ключ у кабінеті й зробіть перший виклик — доступ до API входить в оренду акаунтів, від $90 на місяць. Порахувати обсяг

Отримати API-ключ → Поставити запитання