# Microsoft Bookings + Krokul CRM

Так. Krokul CRM інтегрується з Microsoft Bookings. Кожен запис на вашій сторінці Bookings знаходить або створює контакт у Krokul, привʼязується до угоди й стає задачею-зустріччю для працівника, який її проводить. Менеджер також записує клієнта в Bookings з угоди, а скасування з будь-якого боку закриває задачу.

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

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

### Запис на консультацію відкриває угоду

Потенційний клієнт записується на консультацію на вашій сторінці Bookings. Krokul читає новий bookingAppointment, шукає customerEmailAddress серед контактів Krokul або створює контакт і відкриває угоду у воронці, яку ви призначили цьому bookingService. Задача-зустріч стає на час початку й дістається користувачеві Krokul, привʼязаному до працівника зі staffMemberIds.

### Посилання Teams їде разом із задачею

Коли послуга проходить онлайн, Bookings заповнює joinWebUrl посиланням на зустріч Teams. Krokul кладе посилання в задачу-зустріч, і менеджер відкриває дзвінок з угоди. Нотатки клієнта із запису потрапляють у стрічку угоди.

### Запис з угоди

Менеджер вибирає в Krokul послугу, працівника й вільний слот. Krokul створює bookingAppointment у потрібному bookingBusiness, де клієнтом стоїть контакт угоди. Bookings надсилає своє звичайне підтвердження, а ID запису лишається на задачі як зовнішній ключ.

### Перенесення й скасування збігаються

Новий час на боці Bookings переносить задачу в Krokul. Задача, скасована в Krokul, викликає cancel для запису з вашим cancellationMessage, і Bookings повідомляє клієнта й працівника. Запис, скасований у Bookings, скасовує задачу.

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

| Microsoft Bookings | Krokul | Напрям | Коли |
|---|---|---|---|
| bookingAppointment (calendarView) | Задача-зустріч на угоді | Bookings → Krokul | Читання за розкладом знаходить новий запис |
| bookingCustomer, customerEmailAddress | Контакт, знайдений за поштою чи створений | Bookings → Krokul | Разом із записом |
| bookingService | Воронка й джерело угоди | Bookings → Krokul | Зіставляється один раз під час налаштування |
| bookingStaffMember (staffMemberIds) | Виконавець задачі | Bookings → Krokul | Зіставляється один раз під час налаштування |
| joinWebUrl | Посилання на зустріч у задачі | Bookings → Krokul | Онлайн-послуги |
| Новий bookingAppointment | Задача, створена з угоди | Krokul → Bookings | Менеджер записує клієнта з Krokul |
| Час початку й кінця; cancel | Час задачі; задача скасована | Bookings ↔ Krokul | Будь-який бік переносить чи скасовує |

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

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

1. Зареєструйте застосунок у Microsoft Entra ID з дозволом Graph Bookings.Read.All (application) або Bookings.ReadWrite.All, якщо Krokul також записує й скасовує, і надайте згоду адміністратора.
2. Кожні кілька хвилин читайте /solutions/bookingBusinesses/{id}/calendarView з вікном start і end і порівнюйте з уже збереженими ID.
3. Для нового запису викликайте contact/api-find за поштою, потім card/api-create і task/api-create, а ID запису зберігайте через externalRef/api-upsert.
4. Щоб записувати з Krokul, підпишіть вебхук Krokul на task.created, перевіряйте x-crm-signature і надсилайте запис POST-запитом у bookingBusiness.

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

Microsoft Graph не надсилає сповіщень про зміни для ресурсів Bookings. Krokul читає calendarView за розкладом. Обʼєкт запису містить послугу, працівників, клієнта, часовий пояс і посилання на онлайн-зустріч, а дія cancel надсилає повідомлення клієнтові й працівникам. На боці Krokul ID запису служить зовнішнім ключем, а кожна доставка вебхука Krokul підписана HMAC-SHA256 і може бути повторена з журналу доставок.

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

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

### Чи інтегрується Krokul з Microsoft Bookings?

Так. Записи Bookings створюють у Krokul контакти, угоди й задачі-зустрічі, а менеджери записують клієнтів у Bookings і скасовують записи з угоди.

### Чи працюють особисті сторінки запису?

Ні. Microsoft Graph відкриває лише спільні сторінки Bookings, тому Krokul читає ті, що належать bookingBusiness.

### Як швидко новий запис зʼявляється в Krokul?

На наступному читанні календаря за розкладом. Graph не надсилає сповіщень для Bookings, тому Krokul опитує кожен підключений бізнес із коротким інтервалом.

### Хто отримує задачу-зустріч?

Користувач Krokul, якого ви привʼязали до працівника Bookings. Якщо в записі немає працівника, задача дістається власникові угоди.

## Обмеження

Microsoft Bookings веде доступність, послуги, графіки працівників, сторінки запису й нагадування клієнтам. Graph API працює лише зі спільними (shared) сторінками Bookings, тож особисті сторінки запису лишаються поза звʼязкою, а Microsoft вимагає для бізнесу підписку Microsoft 365 Business Premium.

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

- [Calendly](https://krokul.com/uk/integrations/calendly/index.md)
- [Cal.com](https://krokul.com/uk/integrations/cal-com/index.md)
- [Microsoft Teams](https://krokul.com/uk/integrations/microsoft-teams/index.md)
- [Outlook Calendar](https://krokul.com/uk/integrations/outlook-calendar/index.md)
- [Zoom](https://krokul.com/uk/integrations/zoom/index.md)

[Зустрічі й запис](https://krokul.com/uk/integrations/category/meetings/index.md)

Microsoft і Microsoft Bookings є торговими марками групи компаній Microsoft. Krokul не афілійований із Microsoft.

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

---

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