# impact.com + Krokul CRM

Так. Krokul CRM інтегрується з impact.com. Коли угоду, що прийшла від партнера, виграно чи оплачено, Krokul передає її в impact.com як конверсію із сумою замовлення та ідентифікатором кліку чи промокодом партнера. Програна угода або повернення коштів скасовує чи коригує дію, а impact.com повідомляє угоді її стан, тож відділ продажу бачить, які партнерські продажі очікують, затверджені чи скасовані.

**Статус:** Через API і вебхуки.

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

### Партнерський продаж, який закрив ваш менеджер

B2B-покупець переходить за посиланням партнера, заповнює вашу вебформу, і угода зберігає ідентифікатор кліку impact.com або промокод покупця. За кілька тижнів менеджер виграє угоду. Krokul надсилає в impact.com Conversion із CampaignId, номером угоди як OrderId, ідентифікатором контрагента Krokul як CustomerId і сумою угоди в її валюті, тож партнер отримує зарахування за продаж, закритий офлайн.

### Оплата вирішує, коли дія зараховується

Деякі програми винагороджують лише оплачені замовлення. Тоді Krokul чекає на `invoice.paid` в угоді й надсилає Conversion у цей момент, із рядками за SKU, коли програма платить за категоріями товарів. Виграна, але не оплачена угода дії не створює.

### Повернення й програні угоди змінюють дію

Часткове повернення, записане в Krokul, оновлює Action в impact.com із Reason ITEM_RETURNED і новою сумою Amount. Угода, скасована після конверсії, анулює Action з кодом на зразок REJECTED. impact.com приймає такі зміни до дати блокування дії.

### Стан дії видно в угоді

Постбек Action Lifecycle Event з impact.com повідомляє Krokul, що дію зафіксовано, змінено чи скасовано. Krokul записує стан і виплату партнеру активністю в угоді. Фінансист бачить партнерські витрати поруч із маржею угоди.

### Кожен партнер як джерело

Krokul читає партнерів програми зі списку MediaPartners impact.com і зберігає кожного як джерело угод з ідентифікатором партнера як зовнішнім ключем. Звіт за джерелами в Krokul показує конверсію й виручку кожного партнера.

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

| impact.com | Krokul | Напрям | Коли |
|---|---|---|---|
| Conversion (CampaignId, OrderId, CustomerId, ClickId чи PromoCode, Amount, CurrencyCode) | Виграна чи оплачена угода з ідентифікатором кліку | Krokul → impact.com | Угоду виграно або рахунок оплачено |
| Оновлення Action (Reason, нова Amount) | Часткове повернення в угоді | Krokul → impact.com | Повернення записано до дати блокування |
| Скасування Action (DispositionCode) | Програна чи скасована угода | Krokul → impact.com | Угода програна після конверсії |
| Action Lifecycle Event (стан, виплата) | Активність в угоді | impact.com → Krokul | impact.com фіксує, змінює чи скасовує дію |
| MediaPartner (Id, Name) | Джерело угод із зовнішнім ключем | impact.com → Krokul | Партнер приєднується до програми |

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

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

1. В impact.com відкрийте налаштування API акаунта бренду й скопіюйте Account SID та Auth Token. У Krokul видайте ключ API, що читає угоди й оплати та записує активності й джерела.
2. Підпишіть вебхук Krokul на card.won, card.lost і invoice.paid, перевіряйте x-crm-signature на кожній доставці, читайте угоду через card/api-read і надсилайте Conversion на /Advertisers/{AccountSID}/Conversions.
3. Зберігайте ідентифікатор дії impact.com в угоді через externalRef/api-upsert і використовуйте його для PUT чи DELETE на /Actions, коли настає повернення або програш.
4. В impact.com перейдіть у Menu → Settings → Event Notifications, спрямуйте Action Lifecycle Events на свій приймач, знайдіть угоду через externalRef/api-resolve і запишіть стан через activity/api-create.

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

Brand API impact.com приймає автентифікацію HTTP Basic з Account SID і Auth Token, а конверсії надходять полями форми. Постбеки Event Notifications є звичайними HTTP-викликами з макросами на зразок {ActionId}, {Status} і {Payout} в URL чи в тілі JSON. З боку Krokul ви отримуєте публічний REST API, підписані вебхуки з журналом доставок, зовнішні ключі для ідентифікаторів дій і партнерів та пісочницю для тестів.

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

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

### Чи інтегрується Krokul з impact.com?

Так. Krokul інтегрується з impact.com через свої API і вебхуки разом із Brand API impact.com та його сповіщеннями про події.

### Як impact.com дізнається, який партнер привів угоду?

За ідентифікатором кліку чи промокодом, які Krokul зберігає в угоді з першого візиту. Krokul надсилає їх разом із конверсією, і impact.com зараховує партнера за умовами його договору.

### Що відбувається, коли клієнт просить повернення?

Krokul зменшує суму дії в impact.com або скасовує дію, коли скасовано весь продаж. Зміна працює до дати блокування дії.

### Чи Krokul виплачує винагороди партнерам?

Ні. impact.com рахує й виплачує винагороди партнерам за своїми договорами. Krokul повідомляє про продажі, від яких ці винагороди залежать, і показує результат у кожній угоді.

## Обмеження

Договори з партнерами, умови виплат, трекінгові посилання й самі виплати лишаються в impact.com. Дію можна змінити лише до її дати блокування, яку задають налаштування програми в impact.com.

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

- [Stripe](https://krokul.com/uk/integrations/stripe/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)
- [Google Ads](https://krokul.com/uk/integrations/google-ads/index.md)

[Партнерські програми](https://krokul.com/uk/integrations/category/partners/index.md)

impact.com є торговою маркою Impact Tech, Inc. Krokul не афілійований з impact.com.

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

---

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