Інтеграція через API

Керуйте платформою зі своєї системи

Усе, що робиться в кабінеті, доступне через REST: зібрати аудиторію, оновити сценарій, запустити кампанію, забрати статистику й листування. Ключ випускається в кабінеті, права відмічаються за розділами — CRM, n8n чи ваш бекенд отримують рівно те, що ви дозволили.

Доступ до API входить в оренду акаунтів — окремо платити за нього не потрібно.

Що доступно через API

Не окремий урізаний інтерфейс, а ті самі розділи платформи, що ви бачите в кабінеті. Інтеграція через API потрібна там, де кампанії мають заводитись із вашої системи, а результат — повертатись у неї ж.

Аудиторії

Створити список, імпортувати контакти, поставити задачу розбору чату, прочитати зібраних людей і значення змінних. Звідси ж — статус задачі, поки збір триває.

Сценарії

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

Кампанії

Завести кампанію, зв'язати її з аудиторією, сценарієм і акаунтами, запустити й зупинити. Плюс статистика по днях, історія прогонів і звіт по кожному контакту.

Діалоги

Списки листувань і вміст конкретного діалогу зі статусом і конверсіями — щоб ліди та їхній контекст опинились у вашій CRM, а не лише в кабінеті.

Акаунти

Стан орендованих акаунтів: що готове до роботи, що готується, що під обмеженням. Зручно, коли обсяг планується на вашому боці.

Гаманець

Баланс та історія операцій. Потрібен, якщо ви стежите за витратами зі своєї системи або перепродаєте обсяг клієнтам.

Права відмічаєте самі

У ключа немає режиму «все дозволено за замовчуванням». Права видаються за розділами й окремо на читання та запис — інтеграція отримує рівно той шматок, який їй потрібен.

Ключів можна випустити скільки завгодно: окремий для CRM, окремий для сценарію в n8n, окремий для підрядника. Будь-який відкликається в кабінеті, і доступ зникає одразу — решта інтеграцій продовжують працювати.

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

Навіщо це зазвичай потрібно

Чотири зв'язки, заради яких до API приходять найчастіше.

Ліди одразу в CRM

Щойно в діалозі з'явилась потрібна конверсія, ваш бекенд забирає листування і контакт та заводить угоду — без ручного перенесення і без «забули вивантажити».

Кампанії з вашої системи

Новий список клієнтів з'явився в базі — запускається кампанія. Платформа тут виконавець, а рішення ухвалює ваш процес.

Сценарій із вашого репозиторію

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

Звітність поруч з іншими каналами

Статистика по днях та історія прогонів їдуть у BI, де Telegram стоїть в одному ряду з рекламою та поштою — і рахується за тими самими правилами.

Три способи керувати платформою

Обирайте за тим, хто ухвалює рішення: людина, ШІ-агент або ваш код.

Кабінет — усе те саме руками, якщо інтеграція вам не потрібна.
MCP-сервер — під'єднуєте платформу до Claude або ChatGPT і ставите задачі словами. Той самий ключ, ті самі права.
REST API — коли потрібно вбудувати платформу в чужий процес і рішення ухвалює він, а не людина.

Права в усіх трьох спільні: що заборонено ключу, того не зробить ні агент, ні скрипт.

Як під'єднатись

Окремої реєстрації для розробника не потрібно — ключ випускається в тому самому кабінеті.

01
Випустіть ключ

Розділ API в кабінеті. Один ключ на одну інтеграцію — так його потім не страшно відкликати.

02
Відмітьте права

Лише ті розділи, які потрібні цій інтеграції, і лише читання, якщо запис їй ні до чого.

03
Передайте заголовком

Ключ їде в заголовку Authorization звичайним Bearer-токеном. Жодних підписів запиту й обміну сертифікатами.

04
Викликайте методи

З CRM, з n8n, зі свого бекенду — звідусіль, звідки можна надіслати HTTP-запит.

Що поруч

Через API керують платформою. Самі дії в Telegram і робота словами живуть у сусідніх розділах.

Часті питання про API

Окремої плати немає — API входить в оренду акаунтів. Платите ви за те саме, що й у кабінеті: роботу акаунтів і звернення до ШІ.
Тут ви керуєте платформою: аудиторіями, сценаріями, кампаніями, звітами. Userbot API — поверхом нижче: він смикає сам Telegram-акаунт, щоб зібрати учасників чату або написати конкретній людині. Для другого потрібне окреме право accounts:actions.
Так, і так правильніше: свій ключ на CRM, свій на автоматизацію, свій на підрядника. У кожного свій набір прав, і будь-який відкликається окремо, не зачіпаючи решту інтеграцій.
Запит відхиляється, а не виконується частково. Права перевіряються на кожному методі, тому ключ «тільки на читання» не зможе нічого змінити навіть випадково.
Ні, ключ той самий — MCP-сервер ходить у платформу з ним же й підкоряється тим самим правам. Різниця лише в тому, хто викликає методи: ваш код чи ШІ-агент.
Платформа відповідає звичайним REST, тому підходить стандартний HTTP-вузол: ключ у заголовку, адреса методу, тіло запиту. Окремий плагін ставити не потрібно.

Вбудуйте платформу у свій процес

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