# Box + Krokul CRM

Так. Krokul CRM інтегрується з Box. Кожен контрагент і кожна угода в Krokul мають свою теку в Box, рахунки й договори, видані в Krokul, зберігаються в неї, а файли, які туди завантажують колеги чи клієнти, зʼявляються в картці угоди як посилання. Доступ до вмісту й далі визначають права та правила зберігання Box. Звʼязку веде застосунок Krokul у Zapier, Make, n8n чи Albato, а власні збірки працюють через API і вебхуки Krokul.

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

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

### Дерево тек повторює перелік клієнтів

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

### Завантаження в теку угоди видно в картці

Box надсилає FILE.UPLOADED, коли файл завантажено чи переміщено в теку під наглядом. Krokul прикріплює його до відповідної угоди посиланням із назвою файла й автором завантаження. Інженер кладе в Box оновлене креслення, і менеджер бачить його в угоді тієї ж хвилини.

### Видані документи лягають у теку для бухгалтера

Коли Krokul видає рахунок, акт чи договір, конектор зберігає його PDF-файлом у теці угоди під номером документа. Метадані Box на файлі несуть угоду, контрагента й суму, тож фінансисти шукають у Box за цими полями.

### Клієнт завантажує файли без акаунта Box

З угоди менеджер створює запит файлів Box для її теки, копіюючи ваш шаблонний запит. Клієнт відкриває посилання й завантажує скани чи специфікації. Кожне завантаження викликає FILE.UPLOADED і потрапляє в угоду, як і будь-який інший файл теки.

### Підписаний договір рухає угоду

Договір із теки угоди можна надіслати на підпис через Box Sign. SIGN_REQUEST.COMPLETED переводить угоду на етап, обраний для підписаних договорів, і додає до неї підписаний файл. SIGN_REQUEST.DECLINED повертає угоду на попередній етап і ставить менеджерові задачу.

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

| Box | Krokul | Напрям | Коли |
|---|---|---|---|
| Тека | Контрагент | Krokul → Box | Створено контрагента |
| Підтека | Угода | Krokul → Box | Створено угоду |
| PDF-файл із метаданими | Виданий документ | Krokul → Box | Документ видано чи створено нову версію |
| FILE.UPLOADED | Посилання на файл в угоді | Box → Krokul | Файл завантажено чи переміщено в теку угоди |
| Запит файлів (копія шаблону) | Посилання для завантаження в угоді | Krokul → Box | Менеджер просить клієнта надіслати файли |
| SIGN_REQUEST.COMPLETED, SIGN_REQUEST.DECLINED | Етап угоди й підписаний файл | Box → Krokul | Підписант завершив чи відмовився |
| COMMENT.CREATED | Коментар у стрічці угоди | Box → Krokul | Хтось коментує файл у теці угоди |

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

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

1. Підключіть застосунок Krokul ключем API Krokul, а Box від імені користувача, який може створювати теки під обраним коренем.
2. Поєднайте тригер Krokul New Client Company чи Deal Won з діями Box Create Folder і Create Shared Link on Folder.
3. Зворотний шлях почніть із тригера Box New File у Zapier, New File Event у Make чи File uploaded (Beta) в Albato і додайте посилання в угоду Krokul.

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

1. Випустіть ключ API Krokul зі scope для контрагентів, угод і файлів.
2. Підпишіться на clientCompany.created і card.created через webhook/api-upsert, перевіряйте x-crm-signature, створіть теку Box і привʼяжіть її ID до запису через externalRef/api-upsert.
3. Створіть вебхук Box на кожну теку угоди для FILE.UPLOADED і перевіряйте BOX-SIGNATURE-PRIMARY чи BOX-SIGNATURE-SECONDARY у кожній доставці.
4. Знайдіть угоду за ID теки через externalRef/api-resolve і прикріпіть файл через file/api-create.

**Тригери:** New File; New Folder; New Comment; Task Assigned to You; New File Event; New Folder Event; File uploaded (Beta).

**Дії:** Create Folder; Upload File; Create Shared Link on File; Create Shared Link on Folder; Add Metadata to File; Add Comment to File; Find a File; Find a Folder; Find All Box Sign Requests.

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

Box підписує тіло вебхука як HMAC-SHA256 від сирого тіла й значення BOX-DELIVERY-TIMESTAMP двома ключами, основним і запасним, щоб їх можна було міняти по черзі. Доставки, старші за десять хвилин, слід відхиляти. FILE.UPLOADED і FOLDER.CREATED ставляться лише на теки, тож обробник підписується на кожну теку угоди. У Krokul file/api-create прикріплює посилання рівно до одного запису, а зовнішні ключі привʼязують кожен запис до ID його теки в Box.

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

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

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

Так. Krokul інтегрується з Box через застосунок Krokul у Zapier, Make, n8n і Albato, а також через свій API і вебхуки.

### Чи копіює Krokul файли з Box?

Ні. Файли лишаються в Box зі своїми правами. Krokul записує в Box власні видані документи й тримає посилання на решту.

### Яка подія Box додає новий файл в угоду?

FILE.UPLOADED. Box надсилає її для файлів, завантажених чи переміщених у теку під наглядом, а Krokul зіставляє теку з угодою за зовнішнім ключем.

### Чи може клієнт надіслати файли в угоду без входу в Box?

Так. Менеджер створює запит файлів Box для теки угоди, і завантажити може будь-хто з посиланням. Нові запити Box створює копіюванням наявного, тож в акаунті тримають один шаблонний запит.

## Обмеження

Вміст файлів, версії, співавтори, класифікація й строки зберігання живуть у Box. Krokul тримає для кожного файла посилання, назву й примітку, а перегляд відкриває в Box.

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

- [Dropbox](https://krokul.com/uk/integrations/dropbox/index.md)
- [Google Drive](https://krokul.com/uk/integrations/google-drive/index.md)
- [OneDrive і SharePoint](https://krokul.com/uk/integrations/onedrive-sharepoint/index.md)
- [DocuSign](https://krokul.com/uk/integrations/docusign/index.md)
- [Dropbox Sign](https://krokul.com/uk/integrations/dropbox-sign/index.md)
- [Notion](https://krokul.com/uk/integrations/notion/index.md)

[Файли й документи](https://krokul.com/uk/integrations/category/files-docs/index.md)

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

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

---

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