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-ключ → Задать вопрос