# Linear + Krokul CRM

Так. Krokul CRM інтегрується з Linear. Кожен контрагент у Krokul має відповідного Customer у Linear. Продуктовий запит, почутий в угоді, стає Customer Request на issue в Linear з посиланням на угоду, і менеджер клієнта бачить у Krokul, коли цю issue випустили. Задачі для продуктової команди перетворюються на issues у Linear і закриваються в Krokul, коли issue завершено. Підключають це через застосунок Krokul у Zapier, Make, n8n чи Albato або через API та вебхуки Krokul.

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

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

### Кожен контрагент є клієнтом у Linear

Коли в Krokul з’являється контрагент, конектор викликає `customerUpsert` з його доменами й ID компанії в Krokul як `externalId`. Linear об’єднує запис із клієнтом, який уже має той самий домен. Продакт-менеджери фільтрують запити за справжніми клієнтами, і дублікатів не з’являється.

### Запит із дзвінка доходить до продуктової команди

Менеджер чує в угоді запит на функцію й записує його з картки угоди. Krokul знаходить відповідну issue в Linear або створює нову, а далі додає Customer Request через `customerNeedCreate`, де клієнт стоїть у `customerExternalId`, а адреса угоди в `attachmentUrl`. Продуктова команда бачить, хто просив. Один клік відкриває угоду.

### Випущена issue повертається до менеджера клієнта

Linear надсилає вебхук `Issue` з дією `update`, коли issue переходить у завершений стан. Krokul знаходить угоди із запитом до цієї issue й додає в кожну коментар з ідентифікатором issue, а власнику угоди ставить задачу повідомити клієнта.

### Задачі для розробників стають issues у Linear

Менеджер клієнта створює в Krokul задачу для продуктової команди. Конектор відкриває Issue в Linear у зіставленій команді й зберігає її ID на задачі. Завершення в Linear переводить задачу Krokul у `done`, а скасування в `cancelled`.

### Коментарі, які можуть читати клієнти

Comment на пов’язаній issue з’являється в стрічці угоди з автором. Фільтр за мітками в налаштуваннях конектора лишає внутрішні обговорення в Linear.

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

| Linear | Krokul | Напрям | Коли |
|---|---|---|---|
| Customer (`customerUpsert`) | Контрагент | Krokul → Linear | Контрагента створено або змінився його домен |
| Customer Request (`customerNeedCreate`) | Запит, записаний в угоді | Krokul → Linear | Менеджер записує продуктовий запит |
| Стан issue (завершено) | Коментар у кожній угоді із запитом і задача власнику | Linear → Krokul | Issue завершено |
| Issue | Задача для продуктової команди | Krokul ↔ Linear | Задачу створено в Krokul; issue змінює стан у Linear |
| Comment | Коментар у стрічці угоди | Linear → Krokul | Коментар проходить фільтр за мітками |
| Вкладення issue | Посилання на угоду | Krokul → Linear | Разом із запитом |

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

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

1. Підключіть застосунок Krokul ключем API Krokul і увійдіть у Linear.
2. З’єднайте тригер Krokul Company Created з дією Linear Create Customer.
3. Візьміть тригер Krokul Task Created з Create Issue, а потім збережіть ID issue дією Krokul Set External Key.
4. Для зворотного шляху почніть з Updated Issue чи New Issue Comment і візьміть дії Krokul Update Task Status або Add Comment.

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

1. Створіть ключ API Krokul з доступом до контрагентів, угод і задач та вебхук Linear для Issues, Issue comments і Customer Requests.
2. Підпишіть вебхук Krokul на clientCompany.created і task.created, перевіряйте x-crm-signature і викликайте customerUpsert чи issueCreate на api.linear.app/graphql.
3. Зберігайте ID з Linear на записах Krokul через externalRef/api-upsert.
4. На кожну доставку від Linear перевіряйте заголовок Linear-Signature, знаходьте ID issue через externalRef/api-resolve і закривайте задачу через task/api-updateStatus.

**Тригери:** New Issue; Updated Issue; New Issue Comment; New Customer; Updated Customer; New Customer Need; New Project Update.

**Дії:** Create Issue; Update Issue; Create Comment; Create Customer; Create Customer Need; Create Issue Attachment; Find Issue by ID; Find Customer by ID.

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

Linear має один ендпоінт GraphQL і приймає особистий ключ API або токен OAuth2. Для застосунків, якими користуються інші робочі простори, Linear радить OAuth2. Вебхуки несуть дії create, update і remove та підписані HMAC-SHA256 у `Linear-Signature`. Доставка, що триває понад 5 секунд, вважається невдалою й повторюється до 3 разів, тому відповідайте швидко й обробляйте в черзі.

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

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

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

Так. Krokul інтегрується з Linear через застосунок Krokul у Zapier, Make, n8n і Albato, а також через свої API та вебхуки. Контрагенти, продуктові запити й задачі для розробки лишаються пов’язаними з обох боків.

### Як Krokul уникає дублікатів клієнтів у Linear?

Krokul викликає customerUpsert з доменами компанії та своїм ID як зовнішнім ID. У Linear один домен належить лише одному клієнту, тому збіг об’єднується з наявним клієнтом.

### Чи може одна issue в Linear нести запити з кількох угод?

Так. Кожен запит є окремим Customer Request на тій самій issue, і кожен веде до своєї угоди. Коли issue завершено, кожна з цих угод отримує коментар.

### Чи змінює завершення issue етап угоди?

Ні. Етап угоди лишається рішенням відділу продажів у Krokul. Завершення закриває пов’язану задачу й повідомляє менеджера клієнта.

## Обмеження

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

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

- [Jira](https://krokul.com/uk/integrations/jira/index.md)
- [GitHub](https://krokul.com/uk/integrations/github/index.md)
- [Asana](https://krokul.com/uk/integrations/asana/index.md)
- [ClickUp](https://krokul.com/uk/integrations/clickup/index.md)
- [Notion](https://krokul.com/uk/integrations/notion/index.md)
- [Zendesk](https://krokul.com/uk/integrations/zendesk/index.md)

[Проєкти й задачі](https://krokul.com/uk/integrations/category/project-management/index.md)

Linear є торговельною маркою Linear Orbit, Inc. Krokul не пов’язаний з Linear.

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

---

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