Интеграция 1С-Битрикс с eSputnik: код, синхронизация и персонализация

eSputnik — CDP (Customer Data Platform) с фокусом на ecommerce: омниканальные цепочки, динамические рекомендации, abandoned cart. Интеграция с Битриксом через REST API требует понимания событийной модели eSputnik — без чёткой схемы данных синхронизация быстро превращается в хаос. За 5 лет мы провели 20+ таких интеграций и наработали проверенные решения. Типичный кейс: магазин с 50 000 товаров, где ручная сегментация отнимала по 10 часов в неделю. После интеграции — автоматические триггеры и персонализация в реальном времени.

Особенности API eSputnik

eSputnik предоставляет REST API v1 с Basic Auth (логин/пароль от аккаунта). Базовый URL: https://esputnik.com/api/v1/. Ключевое отличие от других ESP — события как основной механизм триггеров. Вместо прямого управления рассылками мы отправляем события (order placed, cart updated, page viewed) — eSputnik сам строит автоматизации на их основе. Это похоже на вебхуки, но с собственной очередью и ретраями. Сравните: ручная настройка триггеров по сегментам в MailChimp занимает часы, в eSputnik — минуты.

Как синхронизировать контакты через REST API?

Первый шаг — API-клиент для upsert контактов. В нашем коде мы заворачиваем вызов в класс ESputnikClient и передаём channels (email) и fields (кастомные поля). Номера полей (id: 1, 2, 3) берутся из настроек аккаунта eSputnik — раздел «Контакты → Дополнительные поля». Важно: если поле не заполнено, не передавайте его вовсе — eSputnik перезаписывает существующее значение пустотой.

class ESputnikClient {
    private string $login;
    private string $password;
    private string $baseUrl = 'https://esputnik.com/api/v1/';

    public function upsertContact(array $contactData): array {
        $http = new \Bitrix\Main\Web\HttpClient();
        $auth = base64_encode($this->login . ':' . $this->password);
        $http->setHeader('Authorization', 'Basic ' . $auth);
        $http->setHeader('Content-Type', 'application/json');
        $http->setHeader('Accept', 'application/json');

        $payload = [
            'contacts' => [[
                'channels' => [
                    ['type' => 'email', 'value' => $contactData['email']],
                ],
                'fields' => [
                    ['id' => 1, 'value' => $contactData['first_name'] ?? ''],
                    ['id' => 2, 'value' => $contactData['last_name'] ?? ''],
                    ['id' => 3, 'value' => $contactData['phone'] ?? ''],
                ],
            ]],
        ];

        return json_decode($http->post($this->baseUrl . 'contact', json_encode($payload)), true);
    }
}

Почему события eSputnik эффективнее стандартных email-триггеров?

Обычные ESP заставляют вас вручную собирать сегменты и привязывать рассылки. eSputnik использует событийную шину: вы просто отправляете событие с параметрами, а платформа решает, кому и когда доставить письмо. Это позволяет строить цепочки вроде «Если пользователь не кликнул в письме с рекомендациями через 3 дня, отправить SMS с купоном» без написания кода на стороне Битрикса. Кроме того, eSputnik автоматически дедуплицирует контакты и управляет частотой отправки, снижая риск попадания в спам.

Вот как мы отправляем события ecommerce:

public function sendEvent(string $email, string $eventTypeKey, array $params): void {
    $http = new \Bitrix\Main\Web\HttpClient();
    // ... auth headers
    $payload = [
        'eventTypeKey' => $eventTypeKey,
        'keyValue' => $email,
        'params' => array_map(fn($k, $v) => ['name'=>$k,'value'=>$v], array_keys($params), $params),
    ];
    $http->post($this->baseUrl . 'event', json_encode($payload));
}

// Событие: заказ оформлен
$esp->sendEvent($email, 'OrderCreated', [
    'orderId' => $orderId,
    'orderTotal' => $orderTotal,
    'currency' => 'USD',
    'items' => json_encode($orderItems), // JSON-строка с товарами
]);

// Событие: товар добавлен в корзину
$esp->sendEvent($email, 'CartUpdated', [
    'cartTotal' => $cartTotal,
    'items' => json_encode($cartItems),
]);

Кейс из нашей практики: динамические рекомендации в письмах

Ситуация. Магазин спортивного питания, 15 000 активных покупателей. Задача: персонализированные письма с рекомендациями на основе истории покупок.

Реализация. Мы сгенерировали товарный фид в формате XML/Google Shopping из каталога Битрикса и опубликовали по защищённому URL. eSputnik принимает фид и использует collaborative filtering для отбора товаров. В редакторе писем блок «Рекомендации» автоматически подставляет подборку для каждого получателя на момент открытия (real-time рендеринг).

// /bitrix/components/custom/esputnik.feed/component.php
$products = CIBlockElement::GetList(
    ['SORT' => 'ASC'],
    ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y', 'CATALOG_AVAILABLE' => 'Y'],
    false,
    ['nTopCount' => 10000],
    ['ID', 'NAME', 'DETAIL_PAGE_URL', 'PREVIEW_PICTURE', 'PROPERTY_PRICE_RRP', 'PROPERTY_BRAND']
);
header('Content-Type: application/xml');
// ...

Результат: CTR вырос с 2.1% до 6.8% за 3 месяца. ROI составил 5:1 за счёт автоматизации и сегментации. Средний показатель открываемости увеличился на 15%.

Как настроить товарный фид для eSputnik?

Товарный фид — это XML-файл, который eSputnik периодически загружает для построения рекомендаций. Мы генерируем его на лету через компонент Битрикса, фильтруя только активные и доступные товары. В фид включаем идентификатор, название, ссылку, изображение, цену и бренд. Пример структуры:

<feed>
  <entry>
    <id>12345</id>
    <name>Протеин Whey Gold</name>
    <url>https://example.com/product/12345</url>
    <image>https://example.com/upload/iblock/abc.jpg</image>
    <price currency="RUR">1990.00</price>
    <brand>Optimum Nutrition</brand>
  </entry>
</feed>

Фид обновляется каждые 60 минут через агент Битрикса. eSputnik поддерживает до 100 000 товаров в фиде — для больших каталогов используем инкрементальную загрузку через API.

Группы контактов и сегментация

eSputnik поддерживает сегментацию по полям контакта и событиям. Из Битрикса мы передаём поля: дата последнего заказа (для реактивации), общая сумма покупок (VIP-сегмент), категории купленных товаров (тематические рассылки). Пример сегмента: «пользователи, совершившие более 3 покупок на сумму > $90–130. за последние 90 дней».

public function upsertContactWithRetry(array $data, int $retries = 3): array
{
    for ($i = 0; $i < $retries; $i++) {
        try {
            return $this->upsertContact($data);
        } catch (\Exception $e) {
            if ($i === $retries - 1)
                throw $e;
            sleep(pow(2, $i));
        }
    }
}

Что входит в работу

• Разработка API-клиента с поддержкой рекурсивной синхронизации (обработка ошибок, ретраи, логирование).
• Настройка событий ecommerce: оформление заказа, корзина, просмотр товара, регистрация.
• Генерация товарного фида с кастомными полями (бренд, категория, цена).
• Создание сегментов в eSputnik и привязка к цепочкам.
• Тестирование сценариев и мониторинг доставки.
• Документация по администрированию системы.

Мы гарантируем правильную передачу данных и корректную обработку всех состояний (отмена заказа, возврат). После завершения передачи мы остаёмся на поддержке — чиним ошибки, обновляем под новые версии API.

Свяжитесь с нами — оценим ваш магазин за 1 день и предложим оптимальную архитектуру интеграции. Закажите пилот: мы подключим отправку одного события и покажем, как это работает в вашем контуре.

eSputnik API Documentation: https://esputnik.com/api/v1/docs