---
title: "Список Telegram-сообщений"
method: GET
path: "/telegrams"
tags: ["Telegram"]
---

# Список Telegram-сообщений

`GET /telegrams`

Возвращает постраничный список Telegram-сообщений.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Список Telegram-сообщений.

- object
  - `telegrams` TelegramMessage[], required — Список Telegram-сообщений.
    - `uuid` string, uuid, required — UUID в стандартном строковом формате.
    - `status` 'waiting' | 'sended' | 'failed', required — Статус Telegram-сообщения.
    - `created` string, nullable, required — Дата создания сообщения.
    - `sended` string, nullable — Дата отправки сообщения.
    - `tags` string[], required — Уникальные slug-метки.
    - `bot_id` string, required — Идентификатор Telegram-бота.
    - `bot_name` string, nullable, required — Имя Telegram-бота.
    - `bot_username` string, nullable, required — Username Telegram-бота.
    - `bot_token` string, required — Токен бота, сохраненный для сообщения.
    - `chat_id` string, required — Идентификатор Telegram-чата.
    - `chat_name` string, nullable — Имя Telegram-чата или пользователя.
    - `chat_username` string, nullable — Username Telegram-чата или пользователя.
    - `chat_type` string, required — Тип Telegram-чата.
    - `parse_mode` 'HTML' | 'MarkdownV2', nullable — Режим форматирования сообщения.
    - `preview` string, required — Текстовый предпросмотр сообщения.
    - `button` Button, required
      - `url` string, uri, required — URL кнопки.
      - `label` string, required — Текст кнопки.
    - `message_id` string, nullable — Идентификатор сообщения в Telegram.
  - `next` integer — Номер следующей страницы, если есть продолжение списка.

## Other responses

- `400` — Неправильный запрос.
- `401` — Пользователь не авторизован или токен не передан.
- `403` — Доступ запрещен.
- `500` — Внутренняя ошибка сервера.

---

[API](https://skmtc.net/smartofood/apis/smartofood-control-api.md) · [All operations](https://skmtc.net/smartofood/apis/smartofood-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartofood/smartofood-control-api/versions/b905fafbfc0a/schema)