# Microsoft Teams Phone + Krokul CRM

Так. Krokul CRM інтегрується з Microsoft Teams Phone. Кожен телефонний дзвінок користувача Teams записується в контакт і відкриту угоду з напрямком, тривалістю й користувачем Teams, який говорив, а запис і транскрипт додаються, щойно вони готові. Клік на номер у Krokul починає дзвінок у Teams. Звʼязка працює на Microsoft Graph через API і вебхуки Krokul.

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

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

### Завершений дзвінок потрапляє в контакт

Microsoft Graph надсилає сповіщення про зміну communications/callRecords після кожного дзвінка. Krokul читає рядок журналу PSTN з номером того, хто дзвонить, номером того, кому дзвонять, типом дзвінка й тривалістю, знаходить контакт за зовнішнім номером і пише один запис про дзвінок у контакт і відкриту угоду. За userPrincipalName з рядка Krokul визначає менеджера.

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

Номери телефонів у Krokul відкривають посилання на дзвінок у Teams, у якому номер стоїть із префіксом PSTN. Teams Phone робить вихідний дзвінок з лінії користувача, і запис про дзвінок зʼявляється в угоді після розмови.

### Аудіозаписи й транскрипти приєднуються до дзвінка

Коли користувач Teams записує чи транскрибує ad hoc дзвінок, Graph надсилає сповіщення про новий запис чи транскрипт. Krokul додає посилання на запис до дзвінка, а текст транскрипта зберігає нотаткою під ним. Менеджер читає, що питав клієнт, без повторного прослуховування.

### Кожен користувач Teams відповідає користувачу Krokul

Адміністратор один раз зіставляє користувачів Teams з користувачами Krokul. Дзвінки зіставленого користувача йдуть до нього в Krokul, а дзвінки з невідомих номерів створюють контакт для чергового менеджера із задачею розібратися.

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

| Microsoft Teams Phone | Krokul | Напрям | Коли |
|---|---|---|---|
| Сповіщення про callRecord | Сигнал прочитати дзвінок | Teams Phone → Krokul | Дзвінок завершено |
| Рядок журналу PSTN (callerNumber, calleeNumber, duration) | Запис про дзвінок у контакті й відкритій угоді | Teams Phone → Krokul | Після кожного зовнішнього дзвінка |
| userPrincipalName у рядку журналу | Користувач Krokul, якому належить дзвінок | Teams Phone → Krokul | З кожним дзвінком |
| Аудіозапис ad hoc дзвінка | Посилання на запис у дзвінку | Teams Phone → Krokul | Запис готовий |
| Транскрипт ad hoc дзвінка | Нотатка з транскриптом під дзвінком | Teams Phone → Krokul | Транскрипт готовий |
| Посилання на дзвінок із префіксом PSTN і номером | Номер телефону в картці контакту | Krokul → Teams Phone | Менеджер клікає номер |
| Невідомий номер | Новий контакт і задача черговому менеджеру | Teams Phone → Krokul | Номер не збігся з жодним контактом |

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

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

1. Зареєструйте застосунок у Microsoft Entra ID з application-правами CallRecords.Read.All, CallRecordings.Read.All і CallTranscripts.Read.All, і нехай адміністратор тенанта надасть згоду. У Krokul видайте ключ API з правами на контакти, угоди, активності й задачі.
2. Створіть підписки Graph на communications/callRecords і communications/adhocCalls/getAllRecordings зі своєю адресою сповіщень і значенням clientState та дайте відповідь на запит валідації.
3. Для кожного дзвінка читайте рядок журналу PSTN, знаходьте контакт через contact/api-find за телефоном, пишіть дзвінок через activity/api-create і зберігайте id дзвінка через externalRef/api-upsert.
4. Показуйте номери телефонів у своїх поданнях Krokul як посилання на дзвінок у Teams з номером після 4:, щоб клік починав дзвінок у Teams.

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

Сповіщення про записи дзвінків підтримують лише application-права, тож адміністратор тенанта схвалює застосунок один раз. Вхід користувачів не потрібен. Запит до журналу PSTN охоплює щонайбільше 90 днів і повертає сторінки по 1 000 рядків. Підписки на аудіозаписи й транскрипти охоплюють увесь тенант або одного користувача. З боку Krokul id дзвінків живуть зовнішніми ключами, а підписані вебхуки Krokul із журналом доставок дають командному чату чи звіту реагувати на нові задачі за дзвінками.

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

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

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

Так. Krokul інтегрується з Microsoft Teams Phone через Microsoft Graph та API і вебхуки Krokul. Зовнішні дзвінки, записи й транскрипти потрапляють у контакт і угоду.

### Це та сама сторінка, що й Microsoft Teams?

Ні. Сторінка Microsoft Teams описує повідомлення в каналах і картки угод. Ця сторінка описує телефонні дзвінки, які робляться й приймаються через Teams Phone.

### Коли дзвінок Teams зʼявляється в Krokul?

Після завершення дзвінка. Microsoft Graph створює запис про дзвінок, коли розмова закінчилась, і Krokul пише його в угоду, щойно приходить сповіщення.

### Чи може Krokul читати транскрипти телефонних дзвінків Teams?

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

## Обмеження

Номери, тарифи дзвінків, черги, автосекретарі й політики запису налаштовуються в центрі адміністрування Teams. Microsoft Graph зберігає запис про дзвінок 30 днів, а аудіозаписи й транскрипти лишаються в Microsoft 365 з посиланням у Krokul.

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

- [Microsoft Teams](https://krokul.com/uk/integrations/microsoft-teams/index.md)
- [Zoom Phone](https://krokul.com/uk/integrations/zoom-phone/index.md)
- [RingCentral](https://krokul.com/uk/integrations/ringcentral/index.md)
- [Dialpad](https://krokul.com/uk/integrations/dialpad/index.md)
- [Aircall](https://krokul.com/uk/integrations/aircall/index.md)

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

Microsoft, Microsoft Teams і Teams Phone є торговими марками Microsoft Corporation. Krokul не афілійований з Microsoft.

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

---

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