API Telecobra: создание задачи, запуск и чтение результата

Что подготовить#

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.

Запустить или остановить#

После команды прочитайте состояние. При сетевом тайм-ауте сначала выясните, принят ли запрос, прежде чем повторять действие. Автоответчик настраивается отдельным правилом — параметр 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 года. Запросы с действующим ключом при подготовке статьи не выполнялись.

Продолжить работу#