botruntime
Данные

Теги

Метаданные для фильтрации пользователей, диалогов, сообщений и процессов.

Теги — это короткие пары ключ: значение. Они помогают группировать и фильтровать сущности через API.

Используйте теги для компактных признаков: тарифа, источника обращения или этапа обработки. Для больших объектов и выборок по нескольким полям подходят таблицы. Для памяти внутри одного бота — состояние.

Как работают теги

  • Набор доступных ключей задаётся в конфигурации бота.
  • Значения хранятся вместе с сущностью.
  • Пустое значение удаляет ключ.
  • Фильтры API принимают только объявленные теги.

Не помещайте в теги секреты, токены и персональные данные. Теги могут попадать в журналы и диагностические события.

Точные поля запросов и ответов смотрите в API Reference.

On this page