# Ringostat + Krokul CRM

Так. Krokul CRM інтегрується з Ringostat. Кожен дзвінок із коллтрекінгу Ringostat приходить у Krokul разом із рекламним джерелом і мітками UTM, тож угода одразу знає, яка кампанія привела клієнта. Запис і тривалість розмови лягають у стрічку контакту, а пропущений дзвінок стає задачею.

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

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

### Рекламне джерело переходить в угоду

Подія Ringostat «Incoming call» після дзвінка несе номер клієнта й мітки utm_source, utm_medium, utm_campaign. Krokul створює угоду, записує мітки на неї й ставить джерело. Звіт за джерелами в Krokul потім показує, скільки оплачених угод принесла кожна кампанія.

### Повторний дзвінок іде в ту саму угоду

Коли клієнт із відкритою угодою дзвонить удруге, Krokul не створює дубль. Дзвінок лягає в стрічку наявної угоди. Статус Ringostat REPEATED Krokul зберігає поруч, щоб маркетолог бачив перший і повторні дзвінки окремо.

### Пропущений дзвінок отримує відповідального

Статус NO ANSWER чи BUSY у події після дзвінка створює в Krokul задачу «Передзвонити» з номером клієнта. Задача потрапляє менеджеру контакту. Номер без контакту дістається черговому.

### Зворотний дзвінок з картки угоди

Менеджер натискає номер у картці, і Krokul викликає метод Ringostat для з’єднання двох номерів. Параметр caller несе номер клієнта, callee номер чи SIP-акаунт менеджера, а direction out робить дзвінок вихідним у журналі Ringostat. Розмова повертається в угоду подією «Outgoing call».

### Категорія дзвінка стає тегом

Подія «Call category set» приходить, коли хтось ставить категорію в картці дзвінка Ringostat. Krokul додає цю категорію тегом на угоду, і воронку можна фільтрувати за нею.

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

| Ringostat | Krokul | Напрям | Коли |
|---|---|---|---|
| Подія «Incoming call» після дзвінка (номер, статус, тривалість, запис, UTM) | Угода з джерелом і мітками, дзвінок у стрічці контакту | Ringostat → Krokul | Після кожного вхідного дзвінка |
| Подія «Outgoing call» після дзвінка | Дзвінок у стрічці угоди | Ringostat → Krokul | Після вихідного дзвінка |
| Статус NO ANSWER або BUSY | Задача «Передзвонити» | Ringostat → Krokul | Дзвінок без розмови |
| Статус REPEATED | Позначка повторного дзвінка в наявній угоді | Ringostat → Krokul | Повторний дзвінок клієнта |
| Подія «Call category set» | Тег на угоді | Ringostat → Krokul | Категорію поставили в картці дзвінка |
| Метод з’єднання двох номерів (caller, callee, direction) | Кнопка номера в картці угоди | Krokul → Ringostat | Менеджер натискає номер |
| Журнал дзвінків (calls/list) | Звірка дзвінків за період | Ringostat → Krokul | Раз на добу |

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

### Застосунок Krokul в Albato

1. Підключіть Ringostat в Albato і застосунок Krokul ключем API Krokul.
2. Тригер Ringostat «Incoming call» у варіанті after the call з’єднайте з дією Krokul «Створити угоду» і передайте номер та мітки UTM.
3. Тригер «Outgoing call» у варіанті after the call з’єднайте з дією Krokul «Додати активність» на контакті, знайденому за телефоном.

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

1. Випустіть у Krokul ключ API зі scope на угоди, контакти, активності й задачі.
2. У кабінеті Ringostat відкрийте «Інтеграція» → «Webhooks», натисніть «Add event», виберіть «Incoming call» після дзвінка і вкажіть URL свого обробника з методом POST і форматом json.
3. Обробник знаходить людину через `contact/api-find` за номером, створює угоду через `card/api-create` з мітками UTM і пише дзвінок через `activity/api-create`.
4. Кнопкою «Execute and show sample» у Ringostat надішліть пробну подію й перевірте, що угода з’явилась у Krokul.

**Тригери:** Incoming call — before the call; Incoming call — after the call; Incoming call — after the answer; Outgoing call — before the call; Outgoing call — after the call.

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

Вебхуки Ringostat збираються в кабінеті з будь-яким набором параметрів, методом GET, POST чи PUT і форматом json, raw, Json-rpc або Form. Журнал дзвінків віддає GET-запит до https://api.ringostat.net/calls/list із заголовком Auth-key. На боці Krokul ідентифікатор дзвінка Ringostat зберігається як `externalRef`, тож повторна доставка не створює другий запис, а власні вебхуки Krokul підписані HMAC і мають журнал доставок.

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

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

### Чи бачить Krokul, з якої реклами подзвонив клієнт Ringostat?

Так. Мітки UTM і джерело з коллтрекінгу Ringostat записуються на угоду, тому звіти Krokul за джерелами рахують дзвінки разом із продажами.

### Які події Ringostat потрібні для Krokul?

Головна подія «Incoming call» після дзвінка. Для повної картини додають «Outgoing call» після дзвінка й «Call category set», якщо команда ставить категорії дзвінкам.

### Що буде з дзвінком, якщо Krokul тимчасово недоступний?

Ringostat позначить вебхук як «with error» і покаже його на сторінці перевірки помилок. Автоматичного повтору Ringostat не робить, а пропущені дзвінки Krokul добирає з журналу calls/list.

### Чи може менеджер подзвонити клієнту з Krokul через Ringostat?

Так. Krokul викликає метод Ringostat для з’єднання двох номерів. Спершу дзвонить менеджер, потім клієнт, і розмова повертається в угоду.

## Обмеження

Номери підміни, проєкти, віджет зворотного дзвінка й аналітика рекламних каналів живуть у Ringostat. Ringostat не повторює вебхук, на який приймач не відповів 200 OK, тому Krokul приймає подію одразу, а обробляє її після відповіді.

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

- [Binotel](https://krokul.com/uk/integrations/binotel/index.md)
- [RingCentral](https://krokul.com/uk/integrations/ringcentral/index.md)
- [Aircall](https://krokul.com/uk/integrations/aircall/index.md)
- [Google Ads](https://krokul.com/uk/integrations/google-ads/index.md)
- [Google Analytics 4](https://krokul.com/uk/integrations/google-analytics-4/index.md)

[Телефонія](https://krokul.com/uk/integrations/category/telephony/index.md)

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

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

---

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