# UniTalk + Krokul CRM

Так. Krokul CRM має нативну інтеграцію з хмарною АТС UniTalk. Після кожної розмови UniTalk надсилає подію CALL_END, і Krokul записує дзвінок у стрічку контакту та відкриту угоду з напрямом, тривалістю й посиланням на запис. Дзвінок без відповіді стає задачею «Передзвонити», а номер з картки контакту набирається через API UniTalk.

**Статус:** Нативна.

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

### Кожна розмова видна в історії клієнта

Після завершення дзвінка UniTalk надсилає подію CALL_END з номерами, напрямом, станом і часом розмови в секундах. Krokul шукає контакт за номером клієнта. У вхідному дзвінку цей номер стоїть у полі from, у вихідному в полі to. Дзвінок лягає в стрічку контакту й угоди разом із тривалістю. Запис відкривається плеєром у тому самому записі.

### Пропущений дзвінок одразу стає задачею

Стан NOANSWER чи BUSY означає, що розмова не відбулась. Krokul ставить задачу «Передзвонити» з номером клієнта, прив’язану до контакту й угоди. Задача з’являється в списку менеджера, і вебхук task.created повідомляє про неї зовнішні системи.

### Новий номер отримує контакт і угоду

Якщо номера в базі немає, Krokul створює контакт і угоду «Дзвінок» з цим номером у воронці, яку ви вибрали під час підключення. Повторний дзвінок того самого клієнта чіпляється до вже відкритої угоди. Нових дублікатів угод від одного клієнта не з’являється.

### Вхідний дзвінок іде до відповідального менеджера

Коли у вхідному сценарії UniTalk увімкнено «Запит у Ваш API», АТС надсилає подію ROUTE з номером клієнта. Krokul знаходить контакт і повертає внутрішній номер його менеджера та ім’я клієнта для SIP-клієнта. Постійний клієнт потрапляє до свого менеджера, а якщо той зайнятий, UniTalk веде дзвінок далі за сценарієм.

### Дзвінок одним натиском з картки

Менеджер натискає номер у картці контакту, і Krokul викликає метод UniTalk /calls/originateC2c з номером клієнта та внутрішньою лінією менеджера як кроком переадресації. Розмова, яка відбулась, повертається в угоду тією самою подією CALL_END.

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

| UniTalk | Krokul | Напрям | Коли |
|---|---|---|---|
| Подія CALL_END (from, to, direction, secondsTalk, state) | Дзвінок у стрічці контакту й відкритої угоди | UniTalk → Krokul | Після кожного завершеного дзвінка |
| Поле link у CALL_END | Плеєр запису в дзвінку | UniTalk → Krokul | Розмова відбулась (стан ANSWER) |
| Стан NOANSWER, BUSY | Задача «Передзвонити» з номером | UniTalk → Krokul | Дзвінок без відповіді |
| Номер, якого немає в базі | Новий контакт і угода «Дзвінок» | UniTalk → Krokul | Перший дзвінок клієнта |
| Запит ROUTE (from, outerNumber) | Внутрішній номер відповідального й ім’я клієнта | UniTalk ↔ Krokul | У мить вхідного дзвінка |
| Метод /calls/originateC2c | Номер у картці контакту | Krokul → UniTalk | Менеджер натискає номер |
| Історія /history/get | Дзвінки, пропущені під час збою зв’язку | UniTalk → Krokul | Після відновлення з’єднання |

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

### Підключення в «Маркетплейсі» Krokul

1. У Krokul відкрийте «Маркетплейс» → «UniTalk», виберіть воронку, джерело й відповідального, потім скопіюйте адресу кнопкою «Скопіювати адресу».
2. У кабінеті UniTalk відкрийте «Інтеграції» → «Обробники подій» і створіть два обробники з методом POST і тілом JSON на цю адресу, для подій CALL_NEW і CALL_END. Шаблон тіла Krokul показує на сторінці підключення.
3. Щоб дзвонити з картки, створіть ключ у розділі «Інтеграції» → «API» кабінету UniTalk і вставте його в поле «Ключ API UniTalk».
4. Зробіть пробний дзвінок і перевірте його в стрічці контакту та в журналі інтеграції.

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

API UniTalk працює за адресою api.unitalk.cloud, приймає ключ у заголовку Authorization і обмежує частоту запитів (15 на секунду, 20 одночасних). Krokul зберігає ідентифікатор дзвінка UniTalk як зовнішній ключ, тож повторна доставка тієї самої події не створює другого запису. Для власних сценаріїв `contact/api-find` знаходить людину за телефоном, а підписані вебхуки `contact.created` і `task.created` передають результат далі.

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

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

### Чи є в Krokul інтеграція з UniTalk?

Так, нативна. Дзвінки UniTalk потрапляють у картки контактів і угод Krokul із тривалістю та записом, пропущені стають задачами, а менеджер дзвонить клієнту з картки.

### Які обробники подій створити в кабінеті UniTalk?

Два обробники з методом POST і тілом JSON, один на подію CALL_NEW, другий на подію CALL_END. Записує дзвінок CALL_END, а CALL_NEW лишається в журналі інтеграції.

### Чи потрібен ключ API UniTalk?

Для прийому дзвінків ключ не потрібен, вистачає адреси обробника. Ключ із розділу «Інтеграції» → «API» потрібен для дзвінка з картки й запитів до історії дзвінків.

### Як Krokul зіставляє дзвінок UniTalk із клієнтом?

За номером телефону клієнта. Для вхідного дзвінка це номер, з якого дзвонили, для вихідного номер, який набирав менеджер. Якщо контакту немає, Krokul створює новий.

## Обмеження

Номери, внутрішні лінії, вхідні сценарії, голосові меню й черги налаштовуються в кабінеті UniTalk. Аудіо розмови зберігається в UniTalk, а Krokul тримає посилання з поля link, яке UniTalk передає лише для стану ANSWER.

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

- [Binotel](https://krokul.com/uk/integrations/binotel/index.md)
- [Ringostat](https://krokul.com/uk/integrations/ringostat/index.md)
- [Phonet](https://krokul.com/uk/integrations/phonet/index.md)
- [RingCentral](https://krokul.com/uk/integrations/ringcentral/index.md)
- [Aircall](https://krokul.com/uk/integrations/aircall/index.md)
- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)

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

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

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

---

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