Как встроить виджет в лид в виде пользовательского поля

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Core\Credentials\ApplicationProfile;
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\HttpFoundation\Request;
        
        $appProfile = ApplicationProfile::initFromArray([
            'BITRIX24_PHP_SDK_APPLICATION_CLIENT_ID' => 'local.xxxxxxxx.xxxxxxxx',
            'BITRIX24_PHP_SDK_APPLICATION_CLIENT_SECRET' => 'yyyyyyyy',
            'BITRIX24_PHP_SDK_APPLICATION_SCOPE' => 'crm,placement',
        ]);
        
        // Битрикс24 передает DOMAIN и токен приложения в запросе обработчика
        $b24 = ServiceBuilderFactory::createServiceBuilderFromPlacementRequest(
            Request::createFromGlobals(),
            $appProfile
        );
        

# pip install b24pysdk
        from b24pysdk import BitrixApp, BitrixToken, Client
        
        bitrix_app = BitrixApp(
            client_id="local.xxxxxxxx.xxxxxxxx",
            client_secret="yyyyyyyy",
        )
        
        # auth приходит в запросе установки или вызова приложения
        client = Client(BitrixToken(
            domain=auth["domain"],
            auth_token=auth["access_token"],
            refresh_token=auth["refresh_token"],
            bitrix_app=bitrix_app,
        ))
        

<?php
        $handlerUrl = 'https://your-domain.example/handler.php';
        $userTypeId = 'phone_data';
        
        // Типизированный аналог не принимает OPTIONS:
        // $b24->getPlacementScope()->userfieldtype()->add($userTypeId, $handlerUrl, 'Phone data', 'Lead phone data field');
        // Чтобы передать OPTIONS (height), вызываем метод напрямую через ядро:
        $response = $b24->core->call('userfieldtype.add', [
            'USER_TYPE_ID' => $userTypeId,
            'HANDLER' => $handlerUrl,
            'TITLE' => 'Phone data',
            'DESCRIPTION' => 'Lead phone data field',
            'OPTIONS' => ['height' => 60],
        ]);
        
        // core->call оборачивает скалярный результат в массив
        $isRegistered = $response->getResponseData()->getResult()[0];
        echo $isRegistered ? 'User field type registered' : 'Error';
        

bitrix_response = client.userfieldtype.add(
            "phone_data",
            "https://your-domain.example/handler.php",
            title="Phone data",
            description="Lead phone data field",
            options={"height": 60},
        ).response
        print("User field type registered" if bitrix_response.result else "Error")
        

<?php
        use Bitrix24\SDK\Core\Exceptions\BaseException;
        
        try
        {
            $applicationId = $b24->getMainScope()->main()->getApplicationInfo()->applicationInfo()->ID;
            $fullUserTypeId = 'rest_' . $applicationId . '_phone_data';
        
            echo 'Full user type ID: ' . $fullUserTypeId;
        }
        catch (BaseException $exception)
        {
            echo $exception->getMessage();
        }
        

from b24pysdk.errors import BitrixAPIError
        
        try:
            application_id = client.app.info().response.result["ID"]
            full_user_type_id = f"rest_{application_id}_phone_data"
        
            print("Full user type ID:", full_user_type_id)
        except BitrixAPIError as error:
            print(error)
        

<?php
        use Bitrix24\SDK\Core\Exceptions\BaseException;
        
        $applicationId = 123;
        $registeredUserTypeId = 'phone_data';
        $userTypeId = 'rest_' . $applicationId . '_' . $registeredUserTypeId;
        $fieldName = 'PHONE_DATA';
        
        try
        {
            $fieldId = $b24->getCRMScope()->leadUserfield()->add([
                'USER_TYPE_ID' => $userTypeId,
                'FIELD_NAME' => $fieldName,
                'XML_ID' => $fieldName,
                'MANDATORY' => 'N',
                'SHOW_IN_LIST' => 'Y',
                'EDIT_IN_LIST' => 'Y',
                'EDIT_FORM_LABEL' => 'Phone data',
                'LIST_COLUMN_LABEL' => 'Phone data',
                'SETTINGS' => [],
            ])->getId();
        
            echo 'Lead field created, ID: ' . $fieldId;
        }
        catch (BaseException $exception)
        {
            echo $exception->getMessage();
        }
        

from b24pysdk.errors import BitrixAPIError
        
        application_id = 123
        registered_user_type_id = "phone_data"
        user_type_id = f"rest_{application_id}_{registered_user_type_id}"
        field_name = "PHONE_DATA"
        
        try:
            bitrix_response = client.crm.lead.userfield.add(
                fields={
                    "USER_TYPE_ID": user_type_id,
                    "FIELD_NAME": field_name,
                    "XML_ID": field_name,
                    "MANDATORY": "N",
                    "SHOW_IN_LIST": "Y",
                    "EDIT_IN_LIST": "Y",
                    "EDIT_FORM_LABEL": "Phone data",
                    "LIST_COLUMN_LABEL": "Phone data",
                    "SETTINGS": {},
                },
            ).response
            print("Lead field created, ID:", bitrix_response.result)
        except BitrixAPIError as error:
            print(error)
        

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Core\Credentials\ApplicationProfile;
        use Bitrix24\SDK\Core\Exceptions\BaseException;
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\HttpFoundation\Request;
        
        $request = Request::createFromGlobals();
        
        $placement = (string)$request->request->get('PLACEMENT', '');
        $placementOptions = json_decode(
            (string)$request->request->get('PLACEMENT_OPTIONS', '{}'),
            true
        );
        
        if ($placement !== 'USERFIELD_TYPE' || !is_array($placementOptions))
        {
            exit;
        }
        
        $value = (string)($placementOptions['VALUE'] ?? '');
        $errorMessage = '';
        
        if (
            $value === ''
            && ($placementOptions['ENTITY_ID'] ?? '') === 'CRM_LEAD'
            && (int)($placementOptions['ENTITY_VALUE_ID'] ?? 0) > 0
        )
        {
            $appProfile = ApplicationProfile::initFromArray([
                'BITRIX24_PHP_SDK_APPLICATION_CLIENT_ID' => 'local.xxxxxxxx.xxxxxxxx',
                'BITRIX24_PHP_SDK_APPLICATION_CLIENT_SECRET' => 'yyyyyyyy',
                'BITRIX24_PHP_SDK_APPLICATION_SCOPE' => 'crm,placement',
            ]);
        
            try
            {
                // SDK возьмет DOMAIN и токен пользователя, открывшего карточку, из запроса
                $b24 = ServiceBuilderFactory::createServiceBuilderFromPlacementRequest(
                    $request,
                    $appProfile
                );
        
                $item = $b24->getCRMScope()->item()->get(
                    1,
                    (int)$placementOptions['ENTITY_VALUE_ID']
                )->item();
        
                $phone = '';
        
                foreach (($item->fm ?? []) as $field)
                {
                    if (
                        ($field['typeId'] ?? '') === 'PHONE'
                        && trim((string)($field['value'] ?? '')) !== ''
                    )
                    {
                        $phone = trim((string)$field['value']);
                        break;
                    }
                }
        
                $value = $phone !== '' ? 'Lead phone: ' . $phone : 'Phone is empty';
            }
            catch (BaseException $exception)
            {
                $errorMessage = $exception->getMessage();
            }
        }
        ?>
        <!DOCTYPE html>
        <html lang="ru">
            <head>
                <meta charset="UTF-8">
                <title>Phone data</title>
            </head>
            <body style="margin: 0; padding: 0; background-color: <?=($placementOptions['MODE'] ?? '') === 'edit' ? '#fff' : '#f9fafb'?>;">
                <?php if ($errorMessage !== ''): ?>
                    <div><?=htmlspecialchars($errorMessage, ENT_QUOTES, 'UTF-8')?></div>
                <?php endif; ?>
        
                <?php if (($placementOptions['MODE'] ?? '') === 'edit'): ?>
                    <input
                        id="phone-data"
                        type="text"
                        style="width: 90%;"
                        value="<?=htmlspecialchars($value, ENT_QUOTES, 'UTF-8')?>"
                    >
                    <script type="module">
                        // Значение в форму карточки записывает код внутри iframe поля
                        import { initializeB24Frame } from '@bitrix24/b24jssdk'
        
                        const $b24 = await initializeB24Frame()
                        const input = document.getElementById('phone-data')
        
                        input.addEventListener('keyup', () => $b24.placement.setValue(input.value))
                        $b24.placement.setValue(input.value)
                    </script>
                <?php else: ?>
                    <?=htmlspecialchars($value, ENT_QUOTES, 'UTF-8')?>
                <?php endif; ?>
            </body>
        </html>
        

# pip install b24pysdk flask
        from flask import Flask, request
        from b24pysdk import BitrixApp, BitrixToken, Client
        from b24pysdk.errors import BitrixAPIError
        from markupsafe import escape
        import json
        
        app = Flask(__name__)
        
        bitrix_app = BitrixApp(
            client_id="local.xxxxxxxx.xxxxxxxx",
            client_secret="yyyyyyyy",
        )
        
        
        @app.post("/handler")
        def handler():
            placement = request.form.get("PLACEMENT", "")
            options = json.loads(request.form.get("PLACEMENT_OPTIONS", "{}") or "{}")
        
            if placement != "USERFIELD_TYPE":
                return ""
        
            value = options.get("VALUE") or ""
            error_message = ""
            lead_id = int(options.get("ENTITY_VALUE_ID", 0))
        
            if value == "" and options.get("ENTITY_ID") == "CRM_LEAD" and lead_id > 0:
                # Битрикс24 передает обработчику домен и токен пользователя
                client = Client(
                    BitrixToken(
                        domain=request.args.get("DOMAIN", ""),
                        auth_token=request.form.get("AUTH_ID", ""),
                        bitrix_app=bitrix_app,
                    )
                )
        
                try:
                    item = client.crm.item.get(
                        entity_type_id=1,
                        bitrix_id=lead_id,
                    ).response.result["item"]
        
                    phone = next(
                        (
                            field["value"].strip()
                            for field in item.get("fm") or []
                            if field.get("typeId") == "PHONE" and (field.get("value") or "").strip()
                        ),
                        (item.get("phone") or "").strip(),
                    )
        
                    value = f"Lead phone: {phone}" if phone else "Phone is empty"
                except BitrixAPIError as error:
                    error_message = str(error)
        
            background = "#fff" if options.get("MODE") == "edit" else "#f9fafb"
        
            if options.get("MODE") == "edit":
                # Значение в форму карточки записывает код внутри iframe поля
                script = """<script type="module">
                        import { initializeB24Frame } from '@bitrix24/b24jssdk'
        
                        const $b24 = await initializeB24Frame()
                        const input = document.getElementById('phone-data')
        
                        input.addEventListener('keyup', () => $b24.placement.setValue(input.value))
                        $b24.placement.setValue(input.value)
                    </script>"""
        
                body = f"""
                    <input id="phone-data" type="text" style="width: 90%;" value="{escape(value)}">
                    {script}
                """
            else:
                body = escape(value)
        
            return f"""<!DOCTYPE html>
        <html lang="ru">
            <head><meta charset="UTF-8"><title>Phone data</title></head>
            <body style="margin: 0; padding: 0; background-color: {background};">
                {f'<div>{escape(error_message)}</div>' if error_message else ''}
                {body}
            </body>
        </html>"""