Разработка интеграции Битрикс24 с Kaiten: синхронизация задач и карточек

Разработка интеграции Битрикс24 с Kaiten

Мы часто встречаем ситуацию: менеджеры работают в Битрикс24, разработчики — в Kaiten, а задачи живут своей жизнью. Статусы расходятся, комментарии дублируются, сроки горят. В результате — потерянные заявки и лишние созвоны. Одна компания из финтеха теряла до 15% заявок из-за того, что менеджеры забывали обновлять статус в Kaiten после закрытия сделки. После интеграции время передачи задачи сократилось с 2 часов до 2 минут. Наш опыт показывает, что без синхронизации между CRM и системой управления проектами любой Kanban-инструмент теряет смысл.

Почему синхронизация между Битрикс24 и Kaiten — это проблема?

Kaiten — российский аналог Jira, популярный после ухода западных вендоров. Он предоставляет REST API и webhooks, но настройка двусторонней синхронизации требует глубокого понимания обоих продуктов. Типичные ошибки:

• Циклическое обновление: задача изменилась в Битрикс24 → обновилась в Kaiten → webhook вернул изменение назад, вызывая бесконечный цикл. Решение — блокировка через SYNC_LOCK в таблице маппинга.
• Потеря данных при масштабировании: при 1000+ задач в день синхронизация без очередей даёт race conditions. Используем блокировки и агенты.
• Разный понятийный аппарат: в Kaiten статусы — это колонки доски (column_id), а в Битрикс24 — числовые STATUS. Маппинг хранится в b_option и настраивается под конкретную доску.

Как мы реализуем интеграцию?

Мы разрабатываем решение на PHP 8.1+ с использованием Bitrix D7 ORM. Основой служит класс KaitenApiClient, который инкапсулирует HTTP-запросы к Kaiten (ключевые эндпоинты — таблица ниже).

Для хранения связей используем свою таблицу b_local_kaiten_task_map с полями BITRIX_TASK_ID, KAITEN_CARD_ID и SYNC_LOCK для блокировки.

class KaitenApiClient { private string $baseUrl; private string $token; public function __construct(string $baseUrl, string $token) { $this->baseUrl = rtrim($baseUrl, '/'); $this->token = $token; } public function createCard(array $data): array { return $this->request('POST', '/api/latest/cards', $data); } public function updateCard(int $cardId, array $data): array { return $this->request('PATCH', "/api/latest/cards/{$cardId}", $data); } public function addComment(int $cardId, string $text): array { return $this->request('POST', "/api/latest/cards/{$cardId}/comments", ['text' => $text]); } private function request(string $method, string $path, array $data = []): array { $ch = curl_init($this->baseUrl . $path); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => $method, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $this->token, 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => $method !== 'GET' ? json_encode($data) : null, ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode >= 400) { throw new \RuntimeException("Kaiten API error {$httpCode}: {$response}"); } return json_decode($response, true) ?? []; } } 

Что входит в работу?

• Аналитика и проектирование: описываем сценарии синхронизации (задачи, статусы, комментарии, файлы), согласовываем маппинг колонок.
• Разработка компонентов: клиент для Kaiten API, обработчики событий Битрикс24 (OnTaskUpdate, OnCrmDealUpdate), webhook-обработчик.
• Тестирование: проверка на тестовом контуре с эмуляцией нагрузки до 500 задач в час.
• Деплой и обучение: настройка на боевом сервере, передача документации по API эндпоинтам и инструкция для администраторов.
• Гарантийная поддержка: 1 месяц после сдачи — исправляем ошибки бесплатно. Сертификат соответствия и лицензия на решение предоставляются.

Двусторонняя синхронизация: карточки и webhook

При изменении задачи в Битрикс24 (событие OnTaskUpdate) срабатывает обработчик, который обновляет карточку Kaiten через PATCH /api/latest/cards/{id}. Чтобы избежать зацикливания, используем SYNC_LOCK:

public static function onTaskUpdate(int $taskId, array $arFields): void { $map = KaitenTaskMapTable::getByBitrixId($taskId); if (!$map || $map['SYNC_LOCK'] !== null) { return; } KaitenTaskMapTable::update($map['ID'], ['SYNC_LOCK' => uniqid()]); try { $client = self::getClient(); $kaitenData = []; if (isset($arFields['TITLE'])) { $kaitenData['title'] = $arFields['TITLE']; } if (isset($arFields['DESCRIPTION'])) { $kaitenData['description'] = strip_tags($arFields['DESCRIPTION']); } if (isset($arFields['DEADLINE'])) { $kaitenData['due_date'] = date('Y-m-d', strtotime($arFields['DEADLINE'])); } if (isset($arFields['STATUS'])) { $columnId = StatusMapper::b24StatusToKaitenColumn($arFields['STATUS']); $kaitenData['column_id'] = $columnId; } if (!empty($kaitenData)) { $client->updateCard($map['KAITEN_CARD_ID'], $kaitenData); } KaitenTaskMapTable::update($map['ID'], [ 'SYNC_LOCK' => null, 'LAST_SYNC_AT' => new \Bitrix\Main\Type\DateTime(), ]); } catch (\Exception $e) { KaitenTaskMapTable::update($map['ID'], ['SYNC_LOCK' => null]); \Bitrix\Main\Diag\Debug::addToLog('KaitenSync: ' . $e->getMessage()); } } 

Webhook из Kaiten в Битрикс24 принимает JSON с событием card.updated:

{ "event": "card.updated", "data": { "id": 12345, "title": "Новое название задачи", "column_id": 678, "assignees": [{"id": 99, "username": "[email protected]"}] } } 

Обработчик проверяет HMAC-подпись и, если блокировка не активна, обновляет статус задачи в Битрикс24 через CTasks::Update.

Маппинг колонок и автосоздание из CRM

Пример маппинга для доски «Разработка»:

Полезный кейс — автоматическое создание карточки Kaiten при переходе сделки CRM на стадию «Разработка». Реализуем через OnCrmDealUpdate:

if ($arFields['STAGE_ID'] === 'DEVELOPMENT') { $client = KaitenApiClientFactory::create(); $card = $client->createCard([ 'title' => 'Deal #' . $dealId . ': ' . $arFields['TITLE'], 'board_id' => KAITEN_DEV_BOARD_ID, 'column_id' => KAITEN_BACKLOG_COLUMN_ID, 'description' => $arFields['COMMENTS'], ]); \CCrmDeal::Update($dealId, ['UF_KAITEN_CARD_ID' => $card['id']], false); } 

Наш подход даёт экономию времени до 2 раз по сравнению с ручной синхронизацией. Компании с опытом интеграций подтверждают: автоматизация исключает человеческие ошибки и ускоряет передачу задач между отделами.

Сроки разработки

Стоимость рассчитывается индивидуально. Свяжитесь с нами — оценим проект бесплатно. Получите консультацию по архитектуре интеграции и срокам внедрения.

Более 5 лет опыта разработки интеграций для Битрикс24. Сертифицированные решения, гарантия качества.

Как проверить корректность синхронизации?

Рекомендуем настроить мониторинг: записывать в лог каждый вызов API и проверять отсутствие ошибок. Используйте агент, который раз в час сверяет количество задач в обеих системах. При расхождении отправляется уведомление администратору. Это позволяет быстро выявлять сбои и поддерживать актуальность данных.

Что даёт автоматизация вместо ручного переноса?

Ручное копирование задач занимает в среднем 10–15 минут на одну задачу. При 20 задачах в день это 3–4 часа работы. Автоматизация сокращает это время до секунд и исключает опечатки и пропуски. Кроме того, статусы в Kaiten меняются автоматически при изменении сделки — менеджеру не нужно заходить в другой интерфейс.