telecobraПрактика Telecobra · 19 сентября 2026
API Telecobra: создание задачи, запуск и чтение результата
Публичный технический справочник по кампании: адреса API, обязательные поля и точное значение счётчиков.
Что подготовить
API-ключ создаётся в кабинете. Используйте заголовок Authorization: Bearer YOUR_API_KEY; ключ храните на своей стороне. В примерах ID 42, 7 и 101 — условные: замените их своими объектами.
Сначала изучите доступ, права и ограничения интеграции. Ответ API о создании объекта ещё не подтверждает выполнение действий в Telegram.
Создать кампанию
POST /api/campaigns. Обязательные поля: name и audience_id. Текст, аккаунты и параметры отправки задаются отдельно.
{
"name": "Проверка на своей аудитории",
"audience_id": 42,
"account_ids": [7],
"message_text": "Сообщение для согласованной проверки",
"delay_min": 30,
"delay_max": 60,
"limit_per_hour": 5
}Числа показывают формат запроса, а не безопасные квоты Telegram. Успех создания возвращает HTTP 201 и поля id, name, status.
Запустить или остановить
| Метод и путь | Назначение |
|---|---|
| POST /api/campaigns/{id}/start | Запуск выбранной кампании |
| POST /api/campaigns/{id}/pause | Запрос паузы |
| POST /api/campaigns/{id}/stop | Запрос остановки |
| GET /api/campaigns/{id}/status | Текущее состояние и счётчики |
После команды прочитайте состояние. При сетевом тайм-ауте сначала выясните, принят ли запрос, прежде чем повторять действие. Автоответчик настраивается отдельным правилом — параметр ai_reply не запускает его в запросе кампании.
Прочитать счётчики без подмены смысла
{
"id": 101,
"status": "done",
"sent": 8,
"errors": 2,
"total": 10,
"pct": 80.0
}Это учебный ответ со значениями для разбора. pct считается как sent / total × 100: здесь 8 / 10 × 100 = 80%. Значение не является долей прочитавших сообщение. Поля delivered, replies и goals в ответ этого метода не входят.
Ответы автоответчика и его целевой сигнал разбираются отдельно. Сигнал модели о достижении цели не доказывает оплату.
Другие задачи и интеграции
- Парсинг: создать задачу и получить результат
- Автопостинг: валидировать цели
- HTTP-запросы из n8n и Make
- Полная документация в кабинете
Справочник сверён с реализацией API 19 сентября 2026 года. Запросы с действующим ключом при подготовке статьи не выполнялись.