# Phonet + Krokul CRM

Так. Krokul CRM інтегрується з віртуальною АТС Phonet. На вхідний дзвінок Phonet питає Krokul, хто телефонує, і отримує ім’я клієнта, посилання на картку та внутрішній номер відповідального менеджера. Завершена розмова лягає в стрічку контакту й угоди з тривалістю та записом, а пропущена стає задачею.

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

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

### Ім’я й картка клієнта до того, як менеджер відповів

Phonet надсилає запит call.settings з номером клієнта (otherLegNum) і номером лінії, на яку прийшов дзвінок. Krokul знаходить контакт і повертає його ім’я, посилання на картку з підписом і пошту відповідального менеджера. Для номера, якого в базі немає, відповідь містить newEntry зі значенням true і посилання на створення контакту.

### Постійний клієнт потрапляє до свого менеджера

У тій самій відповіді Krokul передає responsibleEmployeeExt, тобто внутрішній номер менеджера, закріпленого за контактом. Phonet спрямовує дзвінок на цей номер. Клієнт говорить з людиною, яка веде його угоду, і не пояснює все спочатку.

### Розмова з записом у стрічці угоди

Phonet шле вебхуки call.dial, call.bridge і call.hangup для кожного дзвінка. Krokul чекає підсумкового call.hangup, групує ланцюжок за parentUuid і пише один дзвінок із напрямом, тривалістю й записом. Поле bridgeAt показує, чи з’єдналися сторони.

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

Якщо call.hangup прийшов без bridgeAt, розмови не було. Krokul ставить задачу «Передзвонити» менеджеру цього клієнта з номером і часом дзвінка. Пропущені за ніч дзвінки Krokul звіряє ще й зі списком missed.api, тож зранку жоден не загубиться.

### Дзвінок з картки й нотатки в Phonet

Менеджер натискає номер у картці, і Krokul викликає makeCall з його внутрішнім номером (legExt) і номером клієнта (otherLegNum). Phonet повертає uuid дзвінка, і результат розмови пізніше приходить у ту саму угоду. Новий контакт Krokul з’являється серед контактів Phonet з номером і нотаткою.

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

| Phonet | Krokul | Напрям | Коли |
|---|---|---|---|
| Запит call.settings (otherLegNum, trunkNum) | Ім’я контакту, посилання на картку, внутрішній номер відповідального | Phonet ↔ Krokul | У мить вхідного дзвінка |
| Вебхук call.hangup (parentUuid, dialAt, bridgeAt) | Дзвінок у стрічці контакту й угоди | Phonet → Krokul | Після кожного дзвінка |
| Запис /rest/public/calls/{uuid}/audio | Плеєр у записі дзвінка | Phonet → Krokul | Коли менеджер відкриває дзвінок |
| call.hangup без bridgeAt, список missed.api | Задача «Передзвонити» | Phonet → Krokul | Дзвінок без відповіді |
| Невідомий номер | Новий контакт і угода | Phonet → Krokul | Перший дзвінок клієнта |
| Метод makeCall (legExt, otherLegNum) | Номер у картці контакту | Krokul → Phonet | Менеджер натискає номер |
| Контакт (/rest/crm/contacts/v2) і нотатки | Контакт і відповідальний | Krokul → Phonet | Контакт створено чи змінено в Krokul |

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

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

1. Випустіть у Krokul ключ API зі scope на контакти, угоди, активності й задачі.
2. У кабінеті Phonet відкрийте розділ інтеграцій і вкажіть адресу свого обробника для вебхуків дзвінків і для запиту call.settings.
3. На call.settings знайдіть клієнта через `contact/api-find` за номером і поверніть ім’я, посилання на картку й внутрішній номер менеджера. На call.hangup запишіть дзвінок через `activity/api-create`, а без bridgeAt додайте `task/api-create`.
4. Підпишіть вебхук Krokul на `contact.created`, перевіряйте `x-crm-signature` і створюйте контакт у Phonet через /rest/crm/contacts/v2.

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

Phonet відкриває REST API на домені вашої АТС. Сесія починається з /rest/security/authorize, далі доступні makeCall, активні й пропущені дзвінки, користувачі та контакти з нотатками. Для подій дзвінка є вебхуки й окремий Websocket API. На боці Krokul `contact/api-find` шукає людину за телефоном, parentUuid дзвінка зберігається як `externalRef` і відсікає повтори, а вебхуки Krokul підписані HMAC і мають журнал доставок.

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

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

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

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

### Як Phonet дізнається, хто відповідальний за клієнта?

З відповіді на запит call.settings. Krokul повертає responsibleEmployeeExt і responsibleEmployeeEmail менеджера, закріпленого за контактом, і Phonet спрямовує дзвінок на його внутрішній номер.

### Чому з одного дзвінка Phonet приходить кілька подій?

Phonet повідомляє про набір (call.dial), з’єднання (call.bridge) і завершення (call.hangup). Дзвінок у стрічці Krokul пише за підсумковою подією, а проміжні лишаються в журналі.

### Де зберігаються записи розмов Phonet?

На сервері вашої АТС Phonet. Krokul тримає посилання на запис у дзвінку й відкриває його плеєром, копії аудіо у своїй базі не робить.

## Обмеження

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

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

- [UniTalk](https://krokul.com/uk/integrations/unitalk/index.md)
- [Binotel](https://krokul.com/uk/integrations/binotel/index.md)
- [Ringostat](https://krokul.com/uk/integrations/ringostat/index.md)
- [Aircall](https://krokul.com/uk/integrations/aircall/index.md)
- [RingCentral](https://krokul.com/uk/integrations/ringcentral/index.md)

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

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

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

---

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