# Tableau + Krokul CRM

Так. Krokul CRM інтегрується з Tableau. Krokul публікує угоди, оплати, документи й готові звіти на ваш сайт Tableau Cloud чи Tableau Server як джерела даних Hyper і за розкладом тримає їх актуальними. Аналітики відкривають їх у Tableau як будь-яке інше опубліковане джерело, а збій оновлення, про який повідомив Tableau, стає задачею в Krokul.

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

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

### Дані продажів як опубліковані джерела

Ви підключаєте Krokul до сайту Tableau через personal access token і вибираєте проєкт. Krokul збирає екстракт Hyper з угодами, контрагентами, оплатами й документами, де ID угоди є ключем звʼязку, і публікує його одним джерелом даних. Робочі книги на ньому показують підписані суми поруч із отриманими грошима за менеджером, воронкою й місяцем.

### Звіти Krokul приходять готовими таблицями

Конверсія етапів, час на етапі, DSO і сегменти ABC та XYZ приходять із двигуна звітів Krokul уже порахованими. Krokul пише кожен із них в окрему таблицю файла Hyper. Дашборд Tableau на цих таблицях показує ті самі цифри, що й дашборд Krokul.

### Нічна заміна, денне дописування

Раз на ніч Krokul замінює дані в опублікованому джерелі повним екстрактом. Удень він дописує нові оплати й закриті угоди невеликими файлами Hyper, тож дашборди майже не відстають від того, що бачать продажі. Файли понад ліміт одного запиту вантажаться частинами.

### Збій оновлення доходить до відповідального

Tableau надсилає вебхук DatasourceRefreshFailed чи WorkbookRefreshFailed, коли оновлення екстракту ламається. Krokul створює задачу людині, яка відповідає за звітність, з назвою ресурсу з тіла події. Задача закривається, коли для того самого джерела приходить DatasourceRefreshSucceeded.

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

| Tableau | Krokul | Напрям | Коли |
|---|---|---|---|
| Опубліковане джерело даних (.hyper) у проєкті | Угоди, контрагенти, контакти, оплати, документи | Krokul → Tableau | Повна заміна вночі |
| Додаткові таблиці в тому самому файлі Hyper | report/api-conversion, report/api-stageDuration, report/api-dso, report/api-segments | Krokul → Tableau | З кожною публікацією |
| Дописування в опубліковане джерело | Нові оплати й виграні чи програні угоди | Krokul → Tableau | За денним розкладом |
| Вхід через personal access token | Підключення Krokul до сайту Tableau | Krokul → Tableau | Перед кожною публікацією |
| Вебхук DatasourceRefreshFailed, WorkbookRefreshFailed | Задача відповідальному за звітність | Tableau → Krokul | Оновлення екстракту зламалось |
| Вебхук DatasourceRefreshSucceeded | Та сама задача закрита | Tableau → Krokul | Наступне оновлення вдалося |

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

### Застосунок Krokul у Zapier, Make чи n8n

1. Підключіть застосунок Krokul ключем API Krokul.
2. Почніть із тригера Tableau Datasource Refresh Event чи Workbook Refresh Event у Zapier або Watch Data Source Refresh Failed у Make і завершіть дією Krokul Create Task.
3. Поєднайте тригер Krokul Invoice Paid із дією Tableau Run Extract Refresh Task, коли дашборд читає екстракт, який ви оновлюєте з власного сховища.

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

1. Створіть ключ API Krokul з правом читання угод, контрагентів, оплат і звітів.
2. Читайте обʼєкти через card/api-readList, payment/api-readList і document/api-readList посторінково, а звіти через report/api-run, дотримуючись Retry-After на 429.
3. Запишіть рядки у файл .hyper через Hyper API на Python, Java чи C++.
4. Увійдіть у Tableau REST API через personal access token і опублікуйте файл у свій проєкт методом Publish Data Source: overwrite для першого прогону, append чи replace далі.

**Тригери:** Datasource Refresh Event; Workbook Refresh Event; Datasource Event; New Job; Watch Data Source Refresh Failed.

**Дії:** Run Extract Refresh Task; Create Workbook Refresh; Download View; Find Workbook; Find View.

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

Tableau REST API приймає до 64 МБ в одному запиті публікації, а більші файли через сесію завантаження файла. Overwrite, append і replace взаємовиключні. Append потребує однакових схем і не працює з екстрактами, збереженими з опцією кількох таблиць. Вхід через personal access token повертає токен для заголовка X-Tableau-Auth, типово дійсний 240 хвилин. Tableau тричі повторює невдалу доставку вебхука і може надіслати дублікат, тому обробник Krokul відкидає повтори за ресурсом і часом.

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

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

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

Так. Krokul публікує свої дані продажів і звіти в Tableau Cloud чи Tableau Server як джерела даних Hyper, а події оновлення Tableau повертаються задачами. Застосунок Krokul у Zapier, Make і n8n покриває ваші власні потоки.

### Чи потрібен Tableau Desktop, щоб працювати з даними?

Ні. Джерела живуть на вашому сайті Tableau, тому до них як до опублікованих джерел підключаються і вебредактор, і Tableau Desktop.

### Чи може Tableau записувати назад у Krokul?

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

### Які звіти Krokul видно в Tableau?

Конверсію етапів, час на етапі, DSO, сегменти ABC та XYZ і будь-який власний звіт, зібраний у двигуні звітів Krokul.

## Обмеження

Дані йдуть в один бік, із Krokul у Tableau. Робочі книги, обчислення, права й поширення дашбордів лишаються в Tableau, а опубліковані джерела містять те, що може читати ключ Krokul, на якому стоїть підключення.

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

- [Power BI](https://krokul.com/uk/integrations/power-bi/index.md)
- [Looker Studio](https://krokul.com/uk/integrations/looker-studio/index.md)
- [Google Sheets](https://krokul.com/uk/integrations/google-sheets/index.md)
- [Microsoft Excel](https://krokul.com/uk/integrations/microsoft-excel/index.md)
- [Google Analytics 4](https://krokul.com/uk/integrations/google-analytics-4/index.md)

[Аналітика й BI](https://krokul.com/uk/integrations/category/bi/index.md)

Tableau є торговою маркою Tableau Software, LLC. Krokul не афілійований із Tableau.

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

---

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