Telegram API

Этот раздел описывает API для отправки сообщений через подключенную Telegram-сессию.

1) Где взять ключ

• Откройте админку Catrina.
• Перейдите в раздел Telegram posting.
• В списке сессий нажмите кнопку API у нужной сессии.
• На странице API скопируйте токен. При необходимости нажмите Refresh token.

2) Эндпоинт отправки

Обязательные поля JSON:

• app — имя приложения-источника запроса
• key — идентификатор/ключ запроса
• token — токен с API-страницы сессии
• chat_id — Telegram ID чата/группы
• text — текст сообщения

3) Пример запроса

curl -X POST "https://catrina.one/api/mtproto/send" \
  -H "Content-Type: application/json" \
  -d '{
    "app":"my-app",
    "key":"request-42",
    "token":"YOUR_TOKEN",
    "chat_id":"-1001234567890",
    "text":"Привет из API"
  }'

4) Статус задачи

Отправка идёт через очередь задач. В ответе на отправку вы получите task_id.

Проверка статуса:

Статусы: queued, running, success, failed.