# eSputnik + Krokul CRM

Так. Krokul CRM інтегрується з eSputnik. Контакти Krokul потрапляють в eSputnik із власним ID і сегментом за воронкою, зміна етапу угоди надсилає подію, яка запускає сценарій листів, SMS чи Viber, а відписки, скарги на спам, недоставлені листи й кліки повертаються в картку контакту. Звʼязку веде застосунок Krokul у Zapier чи Albato, а власні сценарії працюють через API і вебхуки Krokul.

**Статус:** Через API і вебхуки. **Платформи автоматизації:** Zapier, Albato.

## Що отримує команда

### Контакт потрапляє в eSputnik під тим самим ID

Коли в Krokul зʼявляється контакт із поштою чи телефоном, Krokul передає його методом /api/v1/contact і ставить UUID контакту в externalCustomerId. Пошук дубля в eSputnik спершу йде за цим ID, тож повторна передача оновлює ту саму людину. Сегмент обирається за воронкою, з якої прийшов контакт.

### Етап угоди запускає сценарій

Подія Krokul card.statusChanged стає викликом Generate event з eventTypeKey, який ви привʼязали до етапу, і параметрами угоди в params. Сценарій eSputnik стартує саме на цю подію й надсилає клієнтові лист, SMS чи повідомлення Viber. Етап «КП надіслано» отримує свій ланцюжок нагадувань.

### Виграна угода стає замовленням

Після card.won Krokul передає угоду методом Orders як замовлення зі статусом DELIVERED, сумою, валютою й позиціями. Номер угоди йде в externalOrderId, тож оновлення угоди перезаписує те саме замовлення. Скасована угода передає статус CANCELLED.

### Відписка й недоставлений лист видно в картці

Вебхук eSputnik приносить activityStatus UNSUBSCRIBED чи SPAM з адресою й externalCustomerId. Krokul знаходить контакт і ставить позначку про відмову від розсилок. UNDELIVERED з hardBounce означає, що адреса не існує, і менеджер контакту отримує задачу уточнити пошту.

### Клік у листі сигналить менеджерові

Статус CLICKED несе clickEventLink, тобто посилання, за яким перейшов клієнт. Krokul пише рядок у стрічку контакту й відкритої угоди. Якщо сценарій має блок Webhook, eSputnik сам викликає Krokul і створює задачу на дзвінок, коли клієнт відкрив сторінку цін.

## Що передається між системами

| eSputnik | Krokul | Напрям | Коли |
|---|---|---|---|
| Контакт (/api/v1/contact, externalCustomerId) | Контакт із поштою чи телефоном | Krokul → eSputnik | Контакт створено чи змінено |
| Сегмент (groups) | Воронка контакту | Krokul → eSputnik | Контакт створено |
| Generate event (eventTypeKey, params) | Етап угоди | Krokul → eSputnik | Угода переходить на привʼязаний етап |
| Замовлення (Orders, externalOrderId) | Виграна чи скасована угода з позиціями | Krokul → eSputnik | Угоду виграно або скасовано |
| UNSUBSCRIBED, SPAM | Позначка відмови від розсилок | eSputnik → Krokul | Людина відписалась чи скаржилась |
| UNDELIVERED із hardBounce | Задача уточнити пошту | eSputnik → Krokul | Адреса не приймає листи |
| CLICKED (clickEventLink) | Рядок у стрічці контакту й угоди | eSputnik → Krokul | Клієнт перейшов за посиланням |
| Блок Webhook у сценарії | Задача менеджерові | eSputnik → Krokul | Сценарій дійшов до блоку |

## Як підключити сьогодні

### Застосунок Krokul у Zapier чи Albato

1. Підключіть застосунок Krokul ключем API Krokul, а eSputnik ключем API з розділу «Налаштування → API» профілю.
2. Тригер Krokul New Contact поєднайте з дією eSputnik Add/Update Contact у Zapier чи New contact в Albato.
3. Тригер Krokul Deal Stage Changed поєднайте з дією Send Event у Zapier, щоб етап угоди запускав сценарій eSputnik.

### Власний потік через API і вебхуки Krokul

1. Випустіть у Krokul ключ API зі scope на контакти, угоди, активності й задачі.
2. Підпишіть вебхук Krokul на contact.created і card.statusChanged, перевіряйте x-crm-signature і викликайте /api/v1/contact чи Generate event з Basic-автентифікацією ключем eSputnik.
3. В eSputnik відкрийте «Експорт даних», створіть Webhook з адресою свого обробника й позначте статуси UNSUBSCRIBED, SPAM, UNDELIVERED і CLICKED.
4. Обробник розбирає масив подій, знаходить контакт через externalRef/api-resolve чи contact/api-find, оновлює його й пише рядок через activity/api-create.

**Тригери:** New Contact; New Contact in Segment.

**Дії:** Add/Update Contact; Subscribe Contact; Send Event; Send Email; Send SMS; New contact; Subscribe contact.

### Для інтеграторів

REST API eSputnik приймає Basic-автентифікацію, де ключ API стоїть у полі пароля. Вебхук активності надсилає масив JSON і може нести логін і пароль приймача та до пʼяти власних заголовків. Підпису тіла eSputnik не описує. Метод Generate event приймає тіло до 20 КБ, а повторна подія з тим самим eventTypeKey і keyValue перезаписує параметри. На боці Krokul UUID контакту зберігається в externalCustomerId, а вебхуки Krokul підписані HMAC і мають журнал доставок.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи працює Krokul з eSputnik?

Так. Krokul інтегрується з eSputnik через застосунок Krokul у Zapier і Albato, а також через свій API і вебхуки. Контакти, етапи угод і замовлення йдуть в eSputnik, а відписки, недоставлення й кліки повертаються в Krokul.

### Як етап угоди запускає сценарій eSputnik?

Krokul надсилає Generate event з eventTypeKey, привʼязаним до етапу. Сценарій eSputnik, що стартує на цю подію, бере параметри угоди з params і надсилає повідомлення.

### Як Krokul дізнається про відписку в eSputnik?

Із вебхука активності зі статусом UNSUBSCRIBED. Він несе адресу й externalCustomerId, тож Krokul знаходить саме той контакт.

### Чи бачить Krokul старі відкриття й кліки?

Ні. Вебхук eSputnik передає події з моменту налаштування. Історію за 90 днів eSputnik віддає окремим методом активності контактів, який вмикає підтримка.

## Обмеження

Шаблони повідомлень, сценарії (workflows), сегменти й статистика розсилок живуть в eSputnik. Вебхуки eSputnik передають лише події після налаштування, тож старіша активність у Krokul не потрапляє.

## Пов’язані сервіси

- [SendPulse](https://krokul.com/uk/integrations/sendpulse/index.md)
- [Mailchimp](https://krokul.com/uk/integrations/mailchimp/index.md)
- [Brevo](https://krokul.com/uk/integrations/brevo/index.md)
- [ActiveCampaign](https://krokul.com/uk/integrations/activecampaign/index.md)
- [TurboSMS](https://krokul.com/uk/integrations/turbosms/index.md)
- [Viber](https://krokul.com/uk/integrations/viber/index.md)

[Email-розсилки](https://krokul.com/uk/integrations/category/email-marketing/index.md)

eSputnik є торговою маркою її власника. Krokul не афілійований з eSputnik.

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs