Как встроить свой UI в параметры робота

# pip install b24pysdk
from flask import request
from b24pysdk import BitrixApp, BitrixToken, Client

APP = BitrixApp(client_id="local.xxxxxxxx.xxxxxxxx", client_secret="yyyyyyyy")

def make_client(auth: dict) -> tuple[Client, BitrixToken]:
    token = BitrixToken(
        domain=auth["domain"],
        auth_token=auth["access_token"],
        refresh_token=auth.get("refresh_token", ""),
        bitrix_app=APP,
    )
    return Client(token), token

auth = request.json["auth"]  # словарь auth из тела запроса обработчика
client, token = make_client(auth)

<?php
// composer require bitrix24/b24phpsdk:"^3.0"
require_once 'vendor/autoload.php';

use Bitrix24\SDK\Core\Credentials\ApplicationProfile;
use Bitrix24\SDK\Core\Credentials\AuthToken;
use Bitrix24\SDK\Core\Credentials\DefaultOAuthServerUrl;
use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Monolog\Handler\StreamHandler;
use Monolog\Logger;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\HttpFoundation\Request;

$request = Request::createFromGlobals();
$appProfile = ApplicationProfile::initFromArray([
    'BITRIX24_PHP_SDK_APPLICATION_CLIENT_ID' => 'local.xxxxxxxx.xxxxxxxx',
    'BITRIX24_PHP_SDK_APPLICATION_CLIENT_SECRET' => 'yyyyyyyy',
    'BITRIX24_PHP_SDK_APPLICATION_SCOPE' => 'bizproc',
]);

$authToken = AuthToken::initFromEventRequest($request);
$domain = (string)$request->request->all('auth')['domain'];

$log = new Logger('bizproc');
$log->pushHandler(new StreamHandler('php://stdout'));

$b24 = (new ServiceBuilderFactory(new EventDispatcher(), $log))
    ->init($appProfile, $authToken, $domain, DefaultOAuthServerUrl::default());

# client построен на токене приложения
result = client.bizproc.robot.add(
    code="robot",
    handler="https://your-domain.example/handler.php",
    name="Пример робота-встройки",
    auth_user_id=1,
    use_placement=True,
    placement_handler="https://your-domain.example/handler.php",
    properties={
        "string": {"Name": "Параметр 1", "Type": "string"},
        "stringm": {"Name": "Параметр 2", "Type": "string", "Multiple": "Y", "Default": ["value 1", "value 2"]},
    },
).response

print(result.result)

<?php
// $b24 построен на токене приложения

// Типизированный getBizProcScope()->robot()->add(...) принимает локализованные
// массивы. Для короткого примера вызываем метод напрямую через ядро.
$response = $b24->core->call('bizproc.robot.add', [
    'CODE' => 'robot',
    'HANDLER' => 'https://your-domain.example/handler.php',
    'AUTH_USER_ID' => 1,
    'NAME' => 'Пример робота-встройки',
    'USE_PLACEMENT' => 'Y',
    'PLACEMENT_HANDLER' => 'https://your-domain.example/handler.php',
    'PROPERTIES' => [
        'string' => ['Name' => 'Параметр 1', 'Type' => 'string'],
        'stringm' => ['Name' => 'Параметр 2', 'Type' => 'string', 'Multiple' => 'Y', 'Default' => ['value 1', 'value 2']],
    ],
]);

var_dump($response->getResponseData()->getResult());

# Список роботов приложения
codes = client.bizproc.robot.list().response.result
print(codes)

# Удалить робота по коду
client.bizproc.robot.delete(code="robot").response

// Список роботов приложения
$codes = $b24->getBizProcScope()->robot()->list()->getRobots();

// Удалить робота по коду
$b24->getBizProcScope()->robot()->delete('robot');

# Flask: сервер отдает HTML обработчика, PLACEMENT_OPTIONS приходит JSON-строкой
from flask import request
import json, html

options = json.loads(request.form.get("PLACEMENT_OPTIONS", "{}") or "{}")

rows = []
for prop_id, prop in (options.get("properties") or {}).items():
    multiple = prop.get("Multiple") is True or prop.get("Multiple") == "Y" or prop.get("MULTIPLE") == "Y"
    values = options.get("current_values", {}).get(prop_id, "")
    values = values if isinstance(values, list) else [values]
    name = f"{prop_id}[]" if multiple else prop_id
    inputs = "".join(
        f'<input name="{name}" value="{html.escape(str(v))}" '
        f'onchange="setPropertyValue(\'{prop_id}\', this.name, {int(multiple)})">'
        for v in values
    )
    rows.append(f'<label>{html.escape(prop.get("Name") or prop.get("NAME"))}:</label>{inputs}')

# JS держим в обычной строке без f-префикса — фигурные скобки остаются как есть
script = """<script type="module">
    import { initializeB24Frame } from 'https://esm.sh/@bitrix24/b24jssdk'
    const $b24 = await initializeB24Frame()
    window.setPropertyValue = (id, inputName, multiple) => {
        const data = new FormData(document.forms.props)
        const value = multiple ? data.getAll(inputName) : data.get(inputName)
        $b24.placement.call('setPropertyValue', { [id]: value })
    }
</script>"""

form_html = f'<form name="props">{"".join(rows)}</form>'
page = f"<!DOCTYPE html><html><body>\n{form_html}\n" + script + "</body></html>"

<?php
// Сервер отдает HTML-страницу обработчика. PLACEMENT_OPTIONS приходит JSON-строкой.
$options = json_decode($_POST['PLACEMENT_OPTIONS'] ?? '{}', true) ?: [];
?>
<!DOCTYPE html>
<html>
    <body>
        <form name="props">
        <?php foreach (($options['properties'] ?? []) as $id => $property):
            $multiple = ($property['Multiple'] ?? false) === true || ($property['Multiple'] ?? '') === 'Y' || ($property['MULTIPLE'] ?? '') === 'Y';
            $values = (array)($options['current_values'][$id] ?? '');
            $name = $multiple ? $id . '[]' : $id; ?>
            <label><?=htmlspecialchars($property['Name'] ?? $property['NAME'])?>:</label>
            <?php foreach ($values as $v): ?>
                <input name="<?=$name?>" value="<?=htmlspecialchars((string)$v)?>"
                       onchange="setPropertyValue('<?=$id?>', this.name, <?=(int)$multiple?>)">
            <?php endforeach; ?>
        <?php endforeach; ?>
        </form>
        <script type="module">
            // b24jssdk подключается ESM-сборкой или собирается сборщиком
            import { initializeB24Frame } from 'https://esm.sh/@bitrix24/b24jssdk'
            const $b24 = await initializeB24Frame()
            window.setPropertyValue = (id, inputName, multiple) => {
                const data = new FormData(document.forms.props)
                const value = multiple ? data.getAll(inputName) : data.get(inputName)
                $b24.placement.call('setPropertyValue', { [id]: value })
            }
        </script>
    </body>
</html>