Как использовать сквозную аналитику при создании лида

# pip install b24pysdk
from b24pysdk import Client, BitrixWebhook

client = Client(BitrixWebhook(
    domain="your-domain.bitrix24.ru",
    webhook_token="1/xxxxxxxxxxxxxxxx",
))

# name, last_name, phone приходят из данных формы
bitrix_response = client.crm.item.add(
    fields={
        "title": f"Feedback page: {name} {last_name}",
        "name": name,
        "lastName": last_name,
        "fm": [
            {"typeId": "PHONE", "valueType": "WORK", "value": phone},
        ],
    },
    entity_type_id=1,
).response
lead_id = bitrix_response.result["item"]["id"]

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

use Bitrix24\SDK\Services\ServiceBuilderFactory;

$b24 = ServiceBuilderFactory::createServiceBuilderFromWebhook(
    'https://your-domain.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/'
);

// $name, $lastName, $phone приходят из данных формы ($_POST)
$leadId = $b24->getCRMScope()->item()->add(1, [
    'title' => 'Feedback page: ' . $name . ' ' . $lastName,
    'name' => $name,
    'lastName' => $lastName,
    'fm' => [
        ['typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => $phone],
    ],
])->item()->id;

if trace:
    trace_id = client.crm.tracking.trace.add(
        trace=trace,
        entities=[
            {"TYPE": "LEAD", "ID": lead_id},
        ],
    ).response.result

if ($trace !== '') {
    // crm.tracking.* нет среди типизированных сервисов — вызываем напрямую через ядро
    $traceId = $b24->core->call('crm.tracking.trace.add', [
        'TRACE' => $trace,
        'ENTITIES' => [
            ['TYPE' => 'LEAD', 'ID' => $leadId],
        ],
    ])->getResponseData()->getResult()[0];
}

# pip install b24pysdk flask
import html

from flask import Flask, request
from b24pysdk import Client, BitrixWebhook

WEBHOOK_DOMAIN = "your-domain.bitrix24.ru"
WEBHOOK_TOKEN = "1/xxxxxxxxxxxxxxxx"

app = Flask(__name__)

PAGE = """<!DOCTYPE html>
<html lang="ru">
<head>
    <meta charset="UTF-8">
    <title>Обратная связь</title>
</head>
<body>
    <h1>Обратная связь</h1>
    <p id="message" aria-live="polite">__MESSAGE__</p>
    <form id="feedback-form" method="post" action="/">
        <input type="hidden" id="FORM_TRACE" name="TRACE">
        <label>Имя <input type="text" name="NAME" required></label>
        <label>Фамилия <input type="text" name="LAST_NAME" required></label>
        <label>Телефон <input type="tel" name="PHONE" required></label>
        <button type="submit">Отправить</button>
    </form>
    <!-- На странице должен быть установлен скрипт сквозной аналитики Битрикс24 -->
    <script>
        document.getElementById('feedback-form').addEventListener('submit', function() {
            var traceInput = document.getElementById('FORM_TRACE');
            var tracker = window.b24Tracker && window.b24Tracker.guest;
            if (tracker && typeof tracker.getTrace === 'function') {
                traceInput.value = tracker.getTrace();
            }
        });
    </script>
</body>
</html>"""


def form_page(message: str = "") -> str:
    return PAGE.replace("__MESSAGE__", html.escape(message))


@app.get("/")
def index():
    return form_page()


@app.post("/")
def submit():
    name = request.form.get("NAME", "").strip()
    last_name = request.form.get("LAST_NAME", "").strip()
    phone = request.form.get("PHONE", "").strip()
    trace = request.form.get("TRACE", "").strip()

    if not name or not last_name or not phone:
        return form_page("Заполните имя, фамилию и телефон")

    client = Client(BitrixWebhook(domain=WEBHOOK_DOMAIN, webhook_token=WEBHOOK_TOKEN))

    try:
        lead_id = client.crm.item.add(
            fields={
                "title": f"Feedback page: {name} {last_name}",
                "name": name,
                "lastName": last_name,
                "fm": [{"typeId": "PHONE", "valueType": "WORK", "value": phone}],
            },
            entity_type_id=1,
        ).response.result["item"]["id"]
    except Exception as error:
        return form_page(f"Лид не создан: {error}")

    if not trace:
        return form_page(f"Лид {lead_id} создан без трейса")

    try:
        trace_id = client.crm.tracking.trace.add(
            trace=trace,
            entities=[{"TYPE": "LEAD", "ID": lead_id}],
        ).response.result
    except Exception as error:
        return form_page(f"Лид {lead_id} создан, но трейс не привязан: {error}")

    return form_page(f"Лид {lead_id} создан и привязан к трейсу {trace_id}")


if __name__ == "__main__":
    app.run(port=3000)

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

use Bitrix24\SDK\Services\ServiceBuilderFactory;

$message = '';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $formValue = static fn (string $key): string => is_string($_POST[$key] ?? null) ? trim($_POST[$key]) : '';
    $name = $formValue('NAME');
    $lastName = $formValue('LAST_NAME');
    $phone = $formValue('PHONE');
    $trace = $formValue('TRACE');

    if ($name === '' || $lastName === '' || $phone === '') {
        $message = 'Заполните имя, фамилию и телефон';
    } else {
        $b24 = ServiceBuilderFactory::createServiceBuilderFromWebhook(
            'https://your-domain.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/'
        );
        $leadId = 0;

        try {
            $leadId = $b24->getCRMScope()->item()->add(1, [
                'title' => 'Feedback page: ' . $name . ' ' . $lastName,
                'name' => $name,
                'lastName' => $lastName,
                'fm' => [
                    ['typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => $phone],
                ],
            ])->item()->id;

            if ($trace === '') {
                $message = "Лид $leadId создан без трейса";
            } else {
                $traceId = $b24->core->call('crm.tracking.trace.add', [
                    'TRACE' => $trace,
                    'ENTITIES' => [
                        ['TYPE' => 'LEAD', 'ID' => $leadId],
                    ],
                ])->getResponseData()->getResult()[0];
                $message = "Лид $leadId создан и привязан к трейсу $traceId";
            }
        } catch (\Throwable $e) {
            $message = $leadId > 0
                ? "Лид $leadId создан, но трейс не привязан: " . $e->getMessage()
                : 'Лид не создан: ' . $e->getMessage();
        }
    }
}
?>
<!DOCTYPE html>
<html lang="ru">
<head>
    <meta charset="UTF-8">
    <title>Обратная связь</title>
</head>
<body>
    <h1>Обратная связь</h1>
    <p id="message" aria-live="polite"><?= htmlspecialchars($message, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') ?></p>
    <form id="feedback-form" method="post" action="">
        <input type="hidden" id="FORM_TRACE" name="TRACE">
        <label>Имя <input type="text" name="NAME" required></label>
        <label>Фамилия <input type="text" name="LAST_NAME" required></label>
        <label>Телефон <input type="tel" name="PHONE" required></label>
        <button type="submit">Отправить</button>
    </form>
    <!-- На странице должен быть установлен скрипт сквозной аналитики Битрикс24 -->
    <script>
        document.getElementById('feedback-form').addEventListener('submit', function() {
            var traceInput = document.getElementById('FORM_TRACE');
            var tracker = window.b24Tracker && window.b24Tracker.guest;
            if (tracker && typeof tracker.getTrace === 'function') {
                traceInput.value = tracker.getTrace();
            }
        });
    </script>
</body>
</html>