Справочник REST API Telepath

Scope: telegram.read · Только чтение

Найти чат по имени, username или числовому ID. Это не глобальный поиск по Telegram.

Параметры запроса

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

curl 'https://telepath.lemma.company/api/v1/chats/search?query=Example&limit=10' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

Ответ HTTP 200

count и chats; поиск может включать query. У чатов есть chat_id, name, type, username и поля охвата архива. Session добавляет source, coverage и partial.

{
  "count": 1,
  "chats": [
    {
      "chat_id": 123456789,
      "name": "Example contact",
      "type": "private",
      "username": null,
      "message_count": 1
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Поиск доступного текста сообщений. Можно ограничить чатом и начальной датой.

Параметры запроса

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

curl 'https://telepath.lemma.company/api/v1/messages/search?query=details&limit=20' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

Ответ HTTP 200

count и messages; чтение чата включает chat, поиск — query, фильтр по дате может добавить since. Сообщения содержат chat_id, message_id, date, direction, text, text_source, sender и доступные метаданные медиа/расшифровок.

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "chat_name": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "direction": "incoming",
      "text": "Could you send the details?",
      "text_source": "written",
      "message_type": "text"
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Читает ограниченное окно сообщений чата. REST-шлюз требует наличия чата в архиве аккаунта до передачи запроса на чтение.

Путь: chat_id — обязательный ненулевой безопасный целочисленный ID; чат должен быть в архиве аккаунта.

Параметры запроса

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

curl 'https://telepath.lemma.company/api/v1/chats/123456789/messages?limit=20' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

Ответ HTTP 200

count и messages; чтение чата включает chat, поиск — query, фильтр по дате может добавить since. Сообщения содержат chat_id, message_id, date, direction, text, text_source, sender и доступные метаданные медиа/расшифровок.

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "chat_name": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "direction": "incoming",
      "text": "Could you send the details?",
      "text_source": "written",
      "message_type": "text"
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Отправка в известный личный Business-чат или группу. Для Business нужны разрешение отвечать и входящее за последние 24 часа; в группе отправляет бот. Для каналов используйте операции постов. У обычной отправки нет ключа идемпотентности.

Путь: chat_id — обязательный ненулевой безопасный целочисленный ID; чат должен быть в архиве аккаунта.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/chats/123456789/messages' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Thanks for your message."}'

Ответ HTTP 200

Поля: sent, chat_id, chat_name, message_id, date и text.

{
  "sent": true,
  "chat_id": 123456789,
  "chat_name": "Example contact",
  "message_id": 43,
  "date": "2026-11-05T08:01:00.000Z",
  "text": "Thanks for your message."
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

До пяти фото из одного архивного чата. Возвращает данные фото и временные ссылки; n8n не отображает фотoвиджет ChatGPT.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/photos' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_ids":[42]}'

Ответ HTTP 200

count, bytes_per_photo и photos. Каждый элемент содержит message_id и поля фото либо свою ошибку; HTTP 200 не означает, что загрузились все фото.

{
  "count": 1,
  "bytes_per_photo": 250000,
  "photos": [
    {
      "message_id": 42,
      "data": "<base64 image bytes>",
      "mimeType": "image/jpeg",
      "bytes": 12345,
      "caption": null,
      "url": null
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Список архивных чатов, включая подключённые каналы. Пустой архив не доказывает отсутствие сообщений в Telegram.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/chats/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

Ответ HTTP 200

count и chats; поиск может включать query. У чатов есть chat_id, name, type, username и поля охвата архива. Session добавляет source, coverage и partial.

{
  "count": 1,
  "chats": [
    {
      "chat_id": 123456789,
      "name": "Example contact",
      "type": "private",
      "username": null,
      "message_count": 1
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Читает последние сохранённые сообщения разных чатов. Сбор начинается после подключения Telegram; старую историю нужно импортировать.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/recent' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":20}'

Ответ HTTP 200

count и messages; чтение чата включает chat, поиск — query, фильтр по дате может добавить since. Сообщения содержат chat_id, message_id, date, direction, text, text_source, sender и доступные метаданные медиа/расшифровок.

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "chat_name": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "direction": "incoming",
      "text": "Could you send the details?",
      "text_source": "written",
      "message_type": "text"
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Метаданные файла, временная ссылка и извлечённый текст, если поддерживается. Импортированные файлы без сохранённых Telegram file ID могут быть недоступны. Не передавайте ссылки другим пользователям.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/file' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42,"include_text":true}'

Ответ HTTP 200

filename, mimeType, bytes, message_type, caption, временный url и необязательный text. Проверяйте text_error, text_truncated и диапазоны строк; медиа из текстового экспорта могут быть недоступны.

{
  "filename": "example.txt",
  "mimeType": "text/plain",
  "bytes": 7,
  "message_type": "document",
  "caption": null,
  "url": null,
  "text": "Example",
  "text_truncated": false,
  "text_error": null
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Возвращает данные и метаданные фото через медиазагрузчик Telepath. Отображение и понимание изображения зависят от клиента; это не метод анализа изображений.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/photo' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42}'

Ответ HTTP 200

Base64, mimeType, bytes, caption и временный url при наличии. Метод получает изображение, но не анализирует его.

{
  "data": "<base64 image bytes>",
  "mimeType": "image/jpeg",
  "bytes": 12345,
  "caption": null,
  "url": null
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Подтвердите получателя и медиа. Укажите ровно один источник: публичный HTTP(S) URL либо from_chat_id вместе с from_message_id из вашего архива. В личных чатах действуют Business-разрешения, в группах отправляет бот. Не повторяйте автоматически при неопределённой доставке.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/send-media' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"url":"https://example.com/example.pdf","as_document":true}'

Ответ HTTP 200

sent, kind, chat_id, chat_name, message_id, filename, caption и sent_as. После тайм-аута доставка может быть неопределённой.

{
  "sent": true,
  "kind": "document",
  "chat_id": 123456789,
  "chat_name": "Example contact",
  "message_id": 44,
  "filename": "example.pdf",
  "caption": null,
  "sent_as": "you"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Подтвердите точную замену и адресата. Менять можно только подходящие исходящие сообщения. Для каналов есть отдельные инструменты постов.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/edit' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":43,"text":"Updated reply."}'

Ответ HTTP 200

edited, chat_id, message_id и новый text.

{
  "edited": true,
  "chat_id": 123456789,
  "message_id": 43,
  "text": "Updated reply."
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Отмечает Business-диалог прочитанным в Telegram до указанного или последнего известного сообщения. Это меняет статус непрочитанного; обычное чтение архива — нет.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/mark-read' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42}'

Ответ HTTP 200

Поля: marked_read, chat_id, chat_name и up_to_message_id.

{
  "marked_read": true,
  "chat_id": 123456789,
  "chat_name": "Example contact",
  "up_to_message_id": 42
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Подтвердите сообщение и эмодзи. Реагирует бот в поддерживаемой группе или разрешённом подключённом канале; реакции Business-чатов не поддерживаются. Для удаления реакции бота не передавайте emoji.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/messages/reaction' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":-1001234567890,"message_id":42,"emoji":"👍"}'

Ответ HTTP 200

Для группы: ok, chat_id, chat_name, message_id, reaction, removed и reacted_as. Для канала вместо этого используются emoji и sent_as.

{
  "ok": true,
  "chat_id": -1001234567890,
  "chat_name": "Example group",
  "message_id": 42,
  "reaction": "👍",
  "removed": false,
  "reacted_as": "the bot"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Чтение отдельного входящего ящика бота. Не смешивайте его с личными Business-чатами, даже при совпадении ID.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/bot/messages' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

Ответ HTTP 200

count, note и messages. У записей line=bot_dm, имя отправителя, date, text и also_has_business_chat. Этот ящик отделён от Business-чатов и личных сообщений каналу.

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "from": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "text": "Hello",
      "line": "bot_dm",
      "also_has_business_chat": false
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Разрешённый ответ от имени бота человеку из входящего ящика этого аккаунта. Не отвечает в Business-чате владельца. Не повторяйте автоматически при неопределённой доставке.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/bot/reply' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"text":"Thanks for your message."}'

Ответ HTTP 200

Поля: ok, chat_id, sent_as и message_id.

{
  "ok": true,
  "chat_id": 123456789,
  "sent_as": "the bot",
  "message_id": 43
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Реакция от имени бота на сообщение в отдельном входящем ящике этого аккаунта. Для удаления не передавайте emoji.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/bot/reaction' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42,"emoji":"👍"}'

Ответ HTTP 200

Поля: ok, chat_id, message_id, reaction, removed и reacted_as.

{
  "ok": true,
  "chat_id": 123456789,
  "message_id": 42,
  "reaction": "👍",
  "removed": false,
  "reacted_as": "the bot"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Безвозвратное удаление сообщений архива Telepath в указанной области, не из Telegram. Нужны разрешённое удаление архива в аккаунте и явное подтверждение. Укажите chat_id, before или оба.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/archive/forget' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"confirmed":true}'

Ответ HTTP 200

forgotten (число строк), chat_id или null, before или null и пояснение о сохранённых копиях. Удаляются данные архива, не переписка Telegram.

{
  "forgotten": 3,
  "chat_id": 123456789,
  "before": null,
  "note": "Removed from the archive. Telegram retains its copy."
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Поиск Notes этого аккаунта. Пустой запрос возвращает последние заметки. Необязательный фильтр по тегу.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/notes/search' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"query":"Follow up","limit":10}'

Ответ HTTP 200

count и notes; поиск также содержит query. Список/поиск возвращают сводки без полного body, links и backlinks; для них используйте notes/get.

{
  "count": 1,
  "notes": [
    {
      "id": 17,
      "title": "Follow up",
      "type": "note",
      "tags": [],
      "task_status": null,
      "reminder": null,
      "created_at": "2026-11-05T08:00:00.000Z",
      "updated_at": "2026-11-05T08:00:00.000Z"
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Чтение заметки, задачи, проекта или страницы человека со связями и обратными ссылками. Укажите ID или точное название.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/notes/get' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":17}'

Ответ HTTP 200

Объект заметки: id, title, body, tags, type, task_status, reminder, created_at, updated_at, links и backlinks.

{
  "id": 17,
  "title": "Follow up",
  "body": "Send the requested details.",
  "tags": [],
  "type": "note",
  "task_status": null,
  "reminder": null,
  "created_at": "2026-11-05T08:00:00.000Z",
  "updated_at": "2026-11-05T08:00:00.000Z",
  "links": [],
  "backlinks": []
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Последние заметки, задачи и проекты. При необходимости фильтруйте по тегу.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/notes/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

Ответ HTTP 200

count и notes; поиск также содержит query. Список/поиск возвращают сводки без полного body, links и backlinks; для них используйте notes/get.

{
  "count": 1,
  "notes": [
    {
      "id": 17,
      "title": "Follow up",
      "type": "note",
      "tags": [],
      "task_status": null,
      "reminder": null,
      "created_at": "2026-11-05T08:00:00.000Z",
      "updated_at": "2026-11-05T08:00:00.000Z"
    }
  ]
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Сохраняйте разрешённое пользователем содержимое. Названия уникальны; используйте ссылки [[Title]] и теги. Типы: note, project, person, task. Напоминание разрешено только для открытой задачи с явным согласием. Ошибка квоты означает, что сохранения не было. Перед созданием ищите дубликаты.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/notes/create' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"title":"Follow up","body":"Send the requested details."}'

Ответ HTTP 200

Объект заметки: id, title, body, tags, type, task_status, reminder, created_at, updated_at, links и backlinks.

{
  "id": 17,
  "title": "Follow up",
  "body": "Send the requested details.",
  "tags": [],
  "type": "note",
  "task_status": null,
  "reminder": null,
  "created_at": "2026-11-05T08:00:00.000Z",
  "updated_at": "2026-11-05T08:00:00.000Z",
  "links": [],
  "backlinks": []
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Сначала прочитайте заметку. При переименовании используйте ID; иначе title выбирает существующую заметку. Пропущенные поля сохраняются, append дописывает body, tags заменяет теги. reminder:null отменяет напоминание, завершение задачи тоже. Подтвердите замену содержимого. Не повторяйте append автоматически.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/notes/update' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":17,"body":"Updated details."}'

Ответ HTTP 200

Объект заметки: id, title, body, tags, type, task_status, reminder, created_at, updated_at, links и backlinks.

{
  "id": 17,
  "title": "Follow up",
  "body": "Send the requested details.",
  "tags": [],
  "type": "note",
  "task_status": null,
  "reminder": null,
  "created_at": "2026-11-05T08:00:00.000Z",
  "updated_at": "2026-11-05T08:00:00.000Z",
  "links": [],
  "backlinks": []
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Навсегда удаляет выбранную заметку после подтверждения пользователя. Отменяет её напоминание. Укажите ID или точное название.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/notes/delete' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":17}'

Ответ HTTP 200

Поля: deleted, id и title.

{
  "deleted": true,
  "id": 17,
  "title": "Follow up"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Разовое напоминание только владельцу авторизованного аккаунта. Уточните время, пояс и текст; создавайте только с разрешения. При повторе используйте тот же request_id и данные. Лимит общий с напоминаниями задач. Запланировано — не значит доставлено.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/reminders/create' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Follow up","at":"2027-01-15T09:00:00Z","timezone":"Europe/London","request_id":"reminder-example-001"}'

Ответ HTTP 200

reminder, created и quota. Повтор идентичного request_id возвращает created=false. Запланировано — не значит доставлено.

{
  "reminder": {
    "id": "r_example_reminder",
    "kind": "standalone",
    "note_id": null,
    "at": "2027-01-15T09:00:00.000Z",
    "timezone": "Europe/London",
    "text": "Follow up",
    "status": "scheduled"
  },
  "created": true
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.read · Только чтение

Отдельные напоминания и напоминания задач со статусами доставки. Доступно независимо от остатка квоты создания. По умолчанию без done/cancelled. Uncertain не означает доставку.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/reminders/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10,"offset":0}'

Ответ HTTP 200

count, total, reminders, next_offset (или null) и quota. Поддерживается пагинация по offset.

{
  "count": 1,
  "total": 1,
  "reminders": [
    {
      "id": "r_example_reminder",
      "kind": "standalone",
      "note_id": null,
      "at": "2027-01-15T09:00:00.000Z",
      "timezone": "Europe/London",
      "text": "Follow up",
      "status": "scheduled"
    }
  ],
  "next_offset": null
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Отмена по ID по запросу владельца; связанная задача сохраняется. Доступна даже при запрете создания Notes или исчерпанном лимите. Отмена не возвращает квоту и не отзывает отправленное сообщение.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/reminders/cancel' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":"r_example_reminder"}'

Ответ HTTP 200

reminder и cancelled. Проверяйте статус: отмена не отзывает доставленное сообщение.

{
  "reminder": {
    "id": "r_example_reminder",
    "kind": "standalone",
    "note_id": null,
    "at": "2027-01-15T09:00:00.000Z",
    "timezone": "Europe/London",
    "text": "Follow up",
    "status": "cancelled"
  },
  "cancelled": true
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Публикация в подключённом канале, которым вы сейчас владеете. Покажите канал, текст, все медиа и адреса кнопок и получите явное согласие. Текст, одно фото/документ или альбом из 2–10 элементов. У альбомов нет кнопок, документы нельзя смешивать с фото/видео. Подписи до 1024 символов. Нужны права Post messages. При идентичном повторе сохраняйте request_id; при неопределённой доставке не создавайте новый ID.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/channels/posts/create' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"request_id":"post-create-example-001","confirmed":true,"text":"Example announcement."}'

Ответ HTTP 200

ok, channel_id, channel_title, message_id и action. Создание альбома добавляет message_ids и media_group_id. Успешный идентичный повтор request_id возвращает сохранённый результат.

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_create_post"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Сначала прочитайте пост, подтвердите канал и замену. Пропущенные поля сохраняются, пустые buttons удаляют кнопки. Нужны актуальное владение и Edit messages. Меняется один элемент альбома, не весь. Идентичный повтор — с тем же request_id.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/channels/posts/edit' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"message_id":42,"request_id":"post-edit-example-001","confirmed":true,"text":"Updated announcement."}'

Ответ HTTP 200

ok, channel_id, channel_title, message_id и action. Создание альбома добавляет message_ids и media_group_id. Успешный идентичный повтор request_id возвращает сохранённый результат.

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_edit_post"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

После подтверждения безвозвратно удаляет один архивный пост из Telegram. Нужны актуальное владение, Delete messages и соблюдение окна удаления Telegram. Это не просто удаление из архива. Повторяйте идентичный запрос с тем же request_id.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/channels/posts/delete' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"message_id":42,"request_id":"post-delete-example-001","confirmed":true}'

Ответ HTTP 200

ok, channel_id, channel_title, message_id и action. Создание альбома добавляет message_ids и media_group_id. Успешный идентичный повтор request_id возвращает сохранённый результат.

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_delete_post"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.

Scope: telegram.write · Запись

Подтвердите канал, пост и нужное состояние. Меняется закрепление только этого поста; нужны владение и Edit messages. Идентичный повтор — с тем же request_id.

Тело JSON

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

curl 'https://telepath.lemma.company/api/v1/channels/posts/pin' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"message_id":42,"request_id":"post-pin-example-001","confirmed":true,"pinned":true}'

Ответ HTTP 200

ok, channel_id, channel_title, message_id и action. Создание альбома добавляет message_ids и media_group_id. Успешный идентичный повтор request_id возвращает сохранённый результат.

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_set_post_pinned"
}

См. общие ошибки и правила повторных попыток. Разрешения аккаунта и доступность функции проверяются для каждой операции.