DocsСправочник APIБаза знаний

Telegram-native AI payment actions

Telegram-native AI payment actions - это действия с активами, которые начинаются внутри Telegram-сценария: в чате, боте, Mini App или wallet-интерфейсе.

В такой схеме ИИ-агент может подготовить перевод, возврат, оплату, treasury-перемещение, payout или swap. Но само исполнение не должно происходить только потому, что агент предложил следующий шаг.

Перед исполнением действие удобно привести к нормализованному виду - ActionIntent.

``text Telegram user / chat -> AI agent -> ActionIntent -> контроль до исполнения -> allow / review / hold / block -> кошелёк / бот / Mini App / компонент исполнения ``

Что значит Telegram-native

Telegram-native не означает, что вся платежная логика должна жить внутри Telegram.

Это означает, что пользовательский сценарий начинается и управляется в Telegram-среде:

| Сценарий | Что происходит |

| --- | --- |

| Bot flow | пользователь пишет боту, агент готовит действие |

| Mini App | пользователь работает с интерфейсом внутри Telegram |

| Wallet interface | пользователь подтверждает действие через wallet-сценарий |

| Team workflow | оператор или агент готовит выплату, возврат или treasury-действие |

| Support flow | агент предлагает refund, adjustment или компенсацию |

Telegram в такой схеме является интерфейсом и контекстом, но не обязан быть владельцем подписи, хранения активов или финального расчёта.

Почему нужен ActionIntent

ИИ-агент часто работает с естественным языком и неполным контекстом.

Например:

``text Верни пользователю оплату за заказ 1842. ``

Для исполнения этого недостаточно. Нужно понять:

```text

```

ActionIntent превращает такую команду в структурированное намерение до исполнения.

Где находится контроль до исполнения

Контрольная проверка находится после формирования ActionIntent, но до подписи и исполнения.

``text ActionIntent -> контроль до исполнения -> decision -> слой исполнения ``

Слой контроля может вернуть:

| Decision | Значение |

| --- | --- |

| allow | действие можно продолжить |

| review | нужно ручное или дополнительное подтверждение |

| hold | действие временно удерживается |

| block | действие не должно исполняться |

Такой слой не заменяет wallet, bot, Mini App или платежную инфраструктуру. Он отвечает только за контроль до исполнения.

Примеры действий

| Действие | Пример |

| --- | --- |

| User payment | оплатить счет или invoice |

| Refund | вернуть оплату пользователю |

| Treasury transfer | переместить средства между рабочими кошельками |

| Payout | подготовить выплату партнеру или пользователю |

| Swap | обменять один актив на другой |

| Approval flow | отправить действие на review перед подписью |

Кто за что отвечает

| Слой | Ответственность |

| --- | --- |

| Telegram bot / Mini App | пользовательский интерфейс и сценарий |

| AI agent | подготовка действия и контекста |

| ActionIntent | нормализованное описание намерения |

| Слой контроля | решение до исполнения |

| Кошелёк / слой хранения активов | подпись, ключи и подтверждение |

| Компонент исполнения | техническое выполнение |

| Network / payment rail | финальное движение средств |

Что важно не смешивать

Слой контроля не должен становиться владельцем всех частей платёжного процесса.

Он не обязан:

```text

```

Правильное разделение:

``text ИИ-агент готовит действие. Слой контроля проверяет. Кошелёк или компонент исполнения выполняет действие. Сеть проводит финальный расчёт. ``

Короткое определение

Telegram-native AI payment action - это действие с активами, которое инициируется из Telegram-сценария ИИ-агентом и проходит через нормализованный ActionIntent и контроль до того, как его исполнит кошелёк, бот, Mini App или другой компонент исполнения.