Практика работы с Telegram
Публикация в выбранные чаты через API Telecobra
Как задать список чатов, выбрать аккаунты и проверить отправку. Разбираем отдельное создание и запуск задания, ротацию отправителей и журнал.
Какой сценарий подтверждён
В API Telecobra предусмотрено задание автопостинга: список целей, текст, подключённые аккаунты и задержка. Цель задаётся отдельной строкой. Отправка возможна там, где выбранный аккаунт имеет доступ и право писать. API-сценарий отличается от формы выбора управляемого канала в кабинете.
Инструкция сверена с текущим обработчиком API и worker. Боевые задания для подготовки статьи не создавались. Начинайте с одного своего тестового чата и одного аккаунта, затем расширяйте список после проверки результата.
Подготовьте список целей и отправителей
- Выберите собственный чат или сообщество, в котором вам разрешена публикация. Проверьте доступ каждого выбранного аккаунта.
- Укажите account_ids явно. Если список не задан, обработчик может выбрать все ваши активные аккаунты; это неудобно для точного контроля первого запуска.
- Удалите дубли и пустые строки из списка целей. Для одной цели оставьте одну строку.
- Подготовьте короткий текст без внешнего вложения для первого контроля.
Список подписок аккаунта доступен через GET /api/accounts/<id>/subscriptions. Он помогает выбрать сообщества, но не является доказательством права писать или администрировать каждое из них. Автоматического режима «разослать во все мои чаты» эта инструкция не обещает.
Создание и запуск — два разных запроса
Через авторизованный API-клиент отправьте POST /api/autopost с JSON. Получите ID созданного задания и прочитайте его параметры через GET. Значения ниже условные: замените их своими; способ авторизации указан в документации API вашего кабинета.
{
"name": "Проверка своего канала",
"channels": "@your_owned_channel",
"message_text": "Контрольная публикация",
"account_ids": [123],
"delay_between": 30
}Создание отвечает 201 и ID, но само по себе не запускает отправку. Запуск — отдельный POST /api/autopost/<id>/start. Это действие отправляет сообщения. Для наблюдения используйте GET /api/autopost/<id>/status; остановка — POST /api/autopost/<id>/stop. Пауза 30 секунд здесь лишь пример настройки, не гарантия отсутствия ограничений.
Как распределяются несколько аккаунтов
| Список целей | Аккаунты | Фактическое распределение |
|---|---|---|
| A | 1 | Аккаунт 1 → A |
| A, B, C | 1 | Аккаунт 1 → A, затем B, затем C |
| A, B, C | 1, 2 | Аккаунт 1 → A; аккаунт 2 → B; аккаунт 1 → C |
Это ротация отправителя по целям. Добавление второго аккаунта не означает, что оба опубликуют сообщение в каждом чате. Доступ к каждой цели должен иметь именно назначенный ей отправитель. Для предсказуемого первого задания используйте один аккаунт.
Проверка журнала и повторного запуска
Статус возвращает sent, errors и хвост журнала. Сверьте первую отправку с реальным сообщением в своём чате. При отказе проверьте цель, права и доступность аккаунта. Успех API не доказывает прочтение аудиторией.
Повторное нажатие start после окончания может запустить отправки заново: не используйте его как кнопку обновления статуса. После сетевого тайм-аута сначала выполните GET и проверьте журнал. Остановка не отзывает уже опубликованные сообщения и не обязательно прерывает текущий сетевой вызов мгновенно.
Одна платформа · разные задачи
Подписка Telecobra
Соберите инструменты для работы с Telegram в одном кабинете. Сроки доступа, цены и условия — на странице подписки.
В этой инструкции описана только часть возможностей платформы. Полный список доступен в разделе функций.