ДокументацияСправочник APIБаза знаний

# Telegram-native AI payment actions

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

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

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

```text

Telegram user / chat

-> AI agent

-> ActionIntent

-> control check

-> allow / review / hold / block

-> wallet / bot / Mini App / executor

```

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

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

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

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

| --- | --- |

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

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

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

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

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

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

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

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

Например:

```text

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

```

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

```text

```

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

Где находится control check

Control check находится после формирования ActionIntent, но до подписи и исполнения.

```text

ActionIntent

-> control check

-> decision

-> execution layer

```

Control layer может вернуть:

| 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 | нормализованное описание намерения |

| Control layer | решение до исполнения |

| Wallet / custody layer | подпись, ключи и подтверждение |

| Executor | техническое выполнение |

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

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

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

Он не обязан:

```text

```

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

```text

AI agent prepares.

Control layer checks.

Wallet or executor executes.

Network settles.

```

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

Telegram-native AI payment action - это действие с активами, которое инициируется из Telegram-сценария AI-агентом и проходит через нормализованный ActionIntent и control check до исполнения wallet, bot, Mini App или другим executor.