# GitHub + Krokul CRM

Так. Krokul CRM інтегрується з GitHub. Запит клієнта, записаний у Krokul, відкриває issue в потрібному репозиторії. Issues, які створив клієнт, стають зверненнями Krokul з терміном SLA, а закритий issue чи злитий pull request закриває відповідну задачу чи звернення. Команди налаштовують це через застосунок Krokul у Zapier, Make чи n8n або через вебхук репозиторію й API Krokul.

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

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

### Запит на зміну стає Issue

Менеджер клієнта записує запит на зміну як задачу Krokul, привʼязану до угоди клієнта. GitHub App відкриває Issue в репозиторії, зіставленому з цим клієнтом, з назвою, терміном, міткою для таких запитів і посиланням назад у Krokul. Номер issue лишається в задачі, тож обидві сторони вказують на один запис.

### Звіти клієнтів про помилки рахуються за SLA

Деякі клієнти повідомляють про помилки прямо в спільному репозиторії. Issue, відкритий там з їхнього акаунта, стає зверненням Krokul на контрагенті з терміном відповіді з ваших налаштувань SLA. Підтримка бачить відлік часу в Krokul, а розробники далі працюють у GitHub.

### Злитий Pull Request закриває запит

Коли зливають Pull Request з посиланням на issue або закривають сам issue, привʼязана задача Krokul переходить у `done`, а звернення в `resolved`. Якщо issue знову відкривають, звернення повертається в `in_progress`, і звіт SLA далі рахує його час.

### Релізи відмічені в угоді клієнта

Опублікований Release у репозиторії клієнта додає в угоду клієнта коментар із тегом і посиланням. Відділ продажу знає, що вийшло, ще до наступного дзвінка, і не читає нотатки до релізу в GitHub.

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

| GitHub | Krokul | Напрям | Коли |
|---|---|---|---|
| Issue | Задача | Krokul → GitHub | Запит клієнта записано як задачу |
| Issue (відкритий клієнтом) | Звернення з терміном SLA | GitHub → Krokul | Подія `issues`, дія `opened` |
| Issue (закритий чи знову відкритий) | Статус задачі, статус звернення | GitHub → Krokul | Подія `issues`, дії `closed`, `reopened` |
| Pull Request (злитий) | Задача `done`, звернення `resolved` | GitHub → Krokul | Подія `pull_request`, дія `closed` з `merged: true` |
| Коментар в issue | Коментар у зверненні чи угоді | GitHub ↔ Krokul | Коментар додано з будь-якого боку, і він пройшов фільтр |
| Release (опублікований) | Коментар в угоді | GitHub → Krokul | Подія `release`, дія `published` |

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

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

1. Підключіть застосунок Krokul із ключем API.
2. Зʼєднайте тригер Krokul Task Created з діями GitHub Create Issue і Add Labels to Issue.
3. Для зворотного шляху візьміть тригер GitHub Issue Closed чи New Release і дію Krokul, наприклад Update Task, Update Ticket чи Create Comment.

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

1. Створіть ключ API Krokul із правами на задачі, звернення й активності.
2. Підпишіть вебхук Krokul на `task.created`, перевіряйте його заголовок `x-crm-signature`, відкривайте Issue через API GitHub і зберігайте номер issue в задачі через `externalRef/api-upsert`.
3. Додайте вебхук репозиторію чи організації на `issues`, `issue_comment`, `pull_request` і `release` із секретом.
4. Перевіряйте `X-Hub-Signature-256`, беріть подію з `X-GitHub-Event` і викликайте роути Krokul, наприклад `ticket/api-create`, `ticket/api-update` чи `task/api-updateStatus`.

**Тригери:** New Issue; Issue Closed; New Pull Request; New Release; New Mention.

**Дії:** Create Issue; Update Issue; Create Comment; Add Labels to Issue; Find or Create an Issue.

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

Обидві сторони підписують вебхуки HMAC-SHA256. GitHub кладе підпис у `X-Hub-Signature-256`, а Krokul у `x-crm-signature` над часовою міткою й тілом, з `x-crm-delivery` для дедуплікації та журналом доставок із повторним надсиланням. Зовнішні ключі Krokul зберігають номер issue з GitHub для задач, звернень і проєктів, тож сервіс знаходить запис, перш ніж писати. Тестова компанія (пісочниця) з ключем API створюється одним викликом.

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

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

### Чи можна звʼязати issues з GitHub із Krokul CRM?

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

### Які події GitHub використовує Krokul?

Основні події: `issues` (opened, closed, reopened), `issue_comment`, `pull_request` (closed і merged) і `release` (published).

### Чи читає Krokul наш код?

Ні. Застосунок просить доступ до issues, pull requests і releases у вибраних вами репозиторіях. Код і диффи лишаються в GitHub.

### Чи може issue з GitHub списувати години на проєкт Krokul?

В issues GitHub немає поля для часу. Години надходять із вашого трекера часу, і Krokul привʼязує їх до звернення, яке закрив цей issue.

### Чи потрібен для цього Zapier?

Ні. Вебхук репозиторію з невеликим сервісом і API Krokul покривають звичні потоки. Застосунок Krokul у Zapier, Make чи n8n позбавляє потреби хостити такий сервіс.

## Обмеження

Код, гілки, рев’ю й CI лишаються в GitHub. Krokul читає події issues, pull requests і releases з репозиторіїв, до яких ви дали доступ, і веде клієнтський бік кожного запиту: хто попросив, до якого терміну й що випущено.

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

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

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

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

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

---

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