eSputnik — CDP (Customer Data Platform) з фокусом на ecommerce: омніканальні ланцюжки, динамічні рекомендації, abandoned cart. Інтеграція з Бітрікс через REST API потребує розуміння подієвої моделі eSputnik — без чіткої схеми даних синхронізація швидко перетворюється на хаос. Ми — компанія з 5+ роками досвіду та 20+ реалізованих проєктів інтеграції Бітрікс з eSputnik. Сертифіковані партнери 1С-Бітрікс. За 5 років ми провели 20+ таких інтеграцій і напрацювали перевірені рішення. Вартість інтеграції стартує від 12 000 грн, середня економія часу на розсилках – до 50%. Типовий кейс: магазин з 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 — хвилини. За нашими спостереженнями, eSputnik обробляє події в 3 рази швидше, ніж SendPulse, що дозволяє запускати тригери без затримок.
Як синхронізувати контакти через 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' => 'UAH',
'items' => json_encode($orderItems),
]);
// Подія: товар додано до кошика
$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="UAH">1990.00</price>
<brand>Optimum Nutrition</brand>
</entry>
</feed>
Фід оновлюється кожні 60 хвилин через агент Бітрікс. eSputnik підтримує до 100 000 товарів у фіді — для великих каталогів використовуємо інкрементальне завантаження через API.
Групи контактів та сегментація
eSputnik підтримує сегментацію за полями контакту та подіями. З Бітрікс ми передаємо поля: дата останнього замовлення (для реактивації), загальна сума покупок (VIP-сегмент), категорії куплених товарів (тематичні розсилки). Приклад сегменту: «користувачі, які здійснили більше 3 покупок на суму > 10 000 грн. за останні 90 днів».
| Задача | Трудозатрати |
|---|---|
| API-клієнт + синхронізація контактів | 4–5 год |
| Події ecommerce (замовлення, кошик, перегляд) | 6–8 год |
| Товарний фід для рекомендацій | 4–6 год |
| Налаштування тригерних ланцюжків у eSputnik | 4–8 год |
Приклад обробки помилок при синхронізації
При мережевих збоях використовуємо ретраї з експоненційною затримкою (максимум 3 спроби). Логуємо невдалі виклики в таблицю b_esputnik_log для подальшого аналізу.
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.
Покрокова інструкція інтеграції
- Налаштування API-клієнта.
- Синхронізація контактів.
- Налаштування подій ecommerce.
- Генерація товарного фіду.
- Тестування та запуск.
Поширені запитання
Багато клієнтів запитують, які дані можна синхронізувати. Ми синхронізуємо контакти (email, ім'я, телефон), поля для сегментації (сума покупок, останнє замовлення), події ecommerce (замовлення, кошик, перегляд) та товарний фід для рекомендацій. eSputnik зберігає історію взаємодій та будує прогнозні моделі на основі цих даних. Щодо термінів: базова інтеграція (API-клієнт, синхронізація контактів, основні події) займає 4–8 годин, повний цикл з налаштуванням тригерних ланцюжків та рекомендацій — 2–5 днів залежно від складності каталогу. Підтримуються всі редакції Бітрікс на платформі 1С-Бітрікс з версії 17.0 і вище: Старт, Бізнес, Малий бізнес, Ентерпрайз. Для Бітрікс24 (On-Premise) потрібна хмарна або коробкова версія з увімкненим модулем REST API. eSputnik зберігає дані на серверах в ЄС, відповідає GDPR. В Україні обробка можлива за договором-офертою. Ми гарантуємо правильне налаштування політики згод у Бітрікс та передачу лише підтверджених контактів. Стандартні тригерні ланцюжки: вітальна серія, покинутий кошик, реактивація, post-purchase, cross-sell на основі рекомендацій. eSputnik підтримує омніканальні сценарії (email + SMS + push) та асинхронне виконання подій.
Документація API eSputnik: https://esputnik.com/api/v1/docs