TakeUser

TakeUser — реакция загружает данные о пользователе.

📝 Назначение

Используется для загрузки информации о пользователе в целевые переменные для последующей обработки. После выполнения реакции данные доступны в переменной ${target.from}.

⚙️ Параметры

📍 Результат

После выполнения реакции данные становятся доступны в переменной:

${target.from}

Структура ${target.from}:

📝 Форматы указания пользователя

1. По ID

user_id: 123456789

2. По @username

user_id: @username

3. Через упоминание (text_mention)

Telegram предоставляет 3 способа указать пользователя:

Что такое text_mention?

text_mention — это специальная сущность в Telegram, которая позволяет ссылаться на пользователя без использования символа @. Она встречается в сообщениях, где пользователь упомянут через интерфейс Telegram (например, при вводе @username в поле ввода).

Где находится text_mention:

В отличие от ID и username, которые всегда находятся в update.message.from, text_mention находится внутри массива entities и его расположение не статично:

{
  "message": {
    "text": "Пример упоминания",
    "entities": [
      {
        "type": "text_mention",
        "offset": 0,
        "length": 7,
        "user": {
          "id": 7042623778,
          "first_name": "Example",
          "last_name": "07"
        }
      }
    ]
  }
}

⚠️ Важно: text_mention может находиться на любой позиции в массиве entities (не обязательно entities.0). Для поиска всех упоминаний используйте макрос !{list.find}.

Как получить ID из text_mention:

${update.message.entities.0.user.id}

Но так как индекс может быть любым, рекомендуется использовать цикл или макрос для поиска всех text_mention:

!{list.find|list: ${update.message.entities}; value: text_mention; key: type}

Сравнение способов

🔧 Опция «Устанавливать chat»

По умолчанию структура target выглядит так:

"target": {
  "chat": {
    "id": -1001798752916,
    "title": "Group Testing",
    "type": "supergroup",
    "username": "rdn123gd"
  },
  "from": {
    "first_name": "Example",
    "id": 7042623778,
    "is_bot": false,
    "language_code": "ru",
    "last_name": "07",
    "name": "Example 07",
    "type": "user"
  }
}

• ${target.chat} — информация о чате, где произошло событие
• ${target.from} — информация о пользователе

Если включить опцию «Устанавливать chat», ${target.chat} будет дублировать информацию из ${target.from}:

"target": {
  "chat": {
    "first_name": "Example",
    "id": 7042623778,
    "last_name": "07",
    "type": "user"
  },
  "from": {
    "first_name": "Example",
    "id": 7042623778,
    "is_bot": false,
    "language_code": "ru",
    "last_name": "07",
    "name": "Example 07",
    "type": "user"
  }
}

💡 Совет: Используйте эту опцию, если нужно отправить сообщение пользователю из ${target.chat} (например, при массовых операциях).

🧪 Примеры использования

Пример 1: Загрузка пользователя по ID

Параметры TakeUser:

• user_id: 123456789

Результат: ${target.from.id} = 123456789

Пример 2: Загрузка пользователя по @username

Параметры TakeUser:

• user_id: @username

Пример 3: Загрузка из упоминания

Задача: Извлечь пользователя, упомянутого в сообщении.

Реакции:

1. TakeUser → Упоминания: true
2. SendMessage → текст: Вы упомянули пользователя ${target.from.name}

Пример 4: Загрузка пользователя из команды

Задача: Извлечь пользователя из команды /ban @username.

Обработчик: Команда /ban @username

Реакции:

1. TakeUser → user_id: @username
2. BanChatMember → user_id: ${target.from.id}

🔄 Особенности поведения

🔗 Связанные реакции

🔗 Связанные разделы