Как изменить или удалить номера телефонов и email

# pip install b24pysdk
from b24pysdk import BitrixWebhook, Client

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.ru",
        webhook_token="USER_ID/TOKEN",  # только user_id/token, без https://
    )
)

item = client.crm.item.add(
    3,  # 3 — контакт
    {
        "name": "Иван",
        "lastName": "Иванов",
        "fm": [
            {"typeId": "EMAIL", "valueType": "WORK", "value": "work_email@nomail.com"},
            {"typeId": "EMAIL", "valueType": "HOME", "value": "home_email@nomail.com"},
            {"typeId": "PHONE", "valueType": "WORK", "value": "+79991234567"},
            {"typeId": "PHONE", "valueType": "MOBILE", "value": "+79997654321"},
        ],
    },
).response.result["item"]

contact_id = item["id"]

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

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Psr\Log\NullLogger;

$sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
    ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');

$resultAdd = $sb->getCRMScope()->item()->add(
    3, // 3 — контакт
    [
        'name' => 'Иван',
        'lastName' => 'Иванов',
        'fm' => [
            [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'work_email@nomail.com' ],
            [ 'typeId' => 'EMAIL', 'valueType' => 'HOME', 'value' => 'home_email@nomail.com' ],
            [ 'typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => '+79991234567' ],
            [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+79997654321' ]
        ]
    ]
);

$contactId = $resultAdd->item()->id;

multifields = client.crm.item.get(
    3,
    contact_id,
).response.result["item"]["fm"]

$multifields = $sb->getCRMScope()->item()->get(3, $contactId)->item()->fm;

result_update = client.crm.item.update(
    3,
    contact_id,
    {
        "fm": {
            # ключ — id записи из шага 2
            "8553": {"typeId": "EMAIL", "valueType": "WORK", "value": "new_work_email@nomail.com"},  # меняем рабочую почту
            "8555": {"typeId": "EMAIL", "value": ""},  # пустое значение удаляет личную почту
            "8559": {"typeId": "PHONE", "valueType": "MOBILE", "value": "+79995554433"},  # меняем мобильный телефон
        },
    },
).response.result["item"]

$resultUpdate = $sb->getCRMScope()->item()->update(
    3,
    $contactId,
    [
        'fm' => [
            // ключ — id записи из шага 2
            8553 => [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'new_work_email@nomail.com' ], // меняем рабочую почту
            8555 => [ 'typeId' => 'EMAIL', 'value' => '' ], // пустое значение удаляет личную почту
            8559 => [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+79995554433' ] // меняем мобильный телефон
        ]
    ]
);

print(client.crm.item.get(3, contact_id).response.result["item"]["fm"])

print_r($sb->getCRMScope()->item()->get(3, $contactId)->item()->fm);

# pip install b24pysdk
from b24pysdk import BitrixWebhook, Client
from b24pysdk.errors import BitrixAPIError

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.ru",
        webhook_token="USER_ID/TOKEN",  # только user_id/token, без https://
    )
)

ENTITY_TYPE_ID = 3  # 3 — контакт, компания — 4, лид — 1


def find_id(multifields, type_id, value_type):
    """Находит id записи мультиполя по типу и подтипу значения."""
    for field in multifields:
        if field["typeId"] == type_id and field["valueType"] == value_type:
            return field["id"]
    return None


try:
    # Шаг 1: создаем контакт с почтой и телефонами
    created = client.crm.item.add(
        ENTITY_TYPE_ID,
        {
            "name": "Иван",
            "lastName": "Иванов",
            "fm": [
                {"typeId": "EMAIL", "valueType": "WORK", "value": "work_email@nomail.com"},
                {"typeId": "EMAIL", "valueType": "HOME", "value": "home_email@nomail.com"},
                {"typeId": "PHONE", "valueType": "WORK", "value": "+79991234567"},
                {"typeId": "PHONE", "valueType": "MOBILE", "value": "+79997654321"},
            ],
        },
    ).response.result["item"]
    contact_id = created["id"]
    print(f"Контакт создан, id: {contact_id}")

    # Шаг 2: читаем идентификаторы записей мультиполя
    multifields = client.crm.item.get(
        ENTITY_TYPE_ID,
        contact_id,
    ).response.result["item"]["fm"]

    work_email_id = find_id(multifields, "EMAIL", "WORK")
    home_email_id = find_id(multifields, "EMAIL", "HOME")
    mobile_phone_id = find_id(multifields, "PHONE", "MOBILE")

    if not all((work_email_id, home_email_id, mobile_phone_id)):
        print("У контакта нет нужных записей мультиполя")
    else:
        # Шаг 3: меняем одни значения и удаляем другие
        # typeId обязателен в каждом элементе, иначе операция молча не выполнится
        updated = client.crm.item.update(
            ENTITY_TYPE_ID,
            contact_id,
            {
                "fm": {
                    str(work_email_id): {"typeId": "EMAIL", "valueType": "WORK", "value": "new_work_email@nomail.com"},
                    str(home_email_id): {"typeId": "EMAIL", "value": ""},
                    str(mobile_phone_id): {"typeId": "PHONE", "valueType": "MOBILE", "value": "+79995554433"},
                },
            },
        ).response.result["item"]

        print("Контактные данные обновлены:")
        print(updated["fm"])
except BitrixAPIError as error:
    print(f"Контактные данные не обновлены: {error}")

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

use Bitrix24\SDK\Services\ServiceBuilderFactory;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Psr\Log\NullLogger;

$sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
    ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');

$entityTypeId = 3; // 3 — контакт, компания — 4, лид — 1
$item = $sb->getCRMScope()->item();

// находит id записи мультиполя по типу и подтипу значения
$findId = static function (array $multifields, string $typeId, string $valueType) {
    foreach ($multifields as $field) {
        if ($field['typeId'] === $typeId && $field['valueType'] === $valueType) {
            return $field['id'];
        }
    }
    return null;
};

try {
    // Шаг 1: создаем контакт с почтой и телефонами
    $contactId = $item->add(
        $entityTypeId,
        [
            'name' => 'Иван',
            'lastName' => 'Иванов',
            'fm' => [
                [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'work_email@nomail.com' ],
                [ 'typeId' => 'EMAIL', 'valueType' => 'HOME', 'value' => 'home_email@nomail.com' ],
                [ 'typeId' => 'PHONE', 'valueType' => 'WORK', 'value' => '+79991234567' ],
                [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+79997654321' ]
            ]
        ]
    )->item()->id;
    echo 'Контакт создан, id: ' . $contactId . PHP_EOL;

    // Шаг 2: читаем идентификаторы записей мультиполя
    $multifields = $item->get($entityTypeId, $contactId)->item()->fm;

    $workEmailId = $findId($multifields, 'EMAIL', 'WORK');
    $homeEmailId = $findId($multifields, 'EMAIL', 'HOME');
    $mobilePhoneId = $findId($multifields, 'PHONE', 'MOBILE');
    if ($workEmailId === null || $homeEmailId === null || $mobilePhoneId === null) {
        echo 'У контакта нет нужных записей мультиполя';
        return;
    }

    // Шаг 3: меняем одни значения и удаляем другие
    // typeId обязателен в каждом элементе, иначе операция молча не выполнится
    $updated = $item->update(
        $entityTypeId,
        $contactId,
        [
            'fm' => [
                $workEmailId => [ 'typeId' => 'EMAIL', 'valueType' => 'WORK', 'value' => 'new_work_email@nomail.com' ],
                $homeEmailId => [ 'typeId' => 'EMAIL', 'value' => '' ],
                $mobilePhoneId => [ 'typeId' => 'PHONE', 'valueType' => 'MOBILE', 'value' => '+79995554433' ]
            ]
        ]
    );

    echo 'Контактные данные обновлены:' . PHP_EOL;
    print_r($updated->item()->fm);
} catch (\Throwable $e) {
    echo 'Контактные данные не обновлены: ' . $e->getMessage();
}