Интеграция Jira API с сайтом: тикеты, статусы, вебхуки

Клиенты теряются между формой обратной связи и статусом заявки — менеджеры тратят в среднем 2–3 часа в день на ручной перенос данных из веб-формы в Jira. В результате теряется до 15% заявок, а время реакции увеличивается на 40%. Поддержка работает вслепую, а руководство не видит реальную картину нагрузки. Наши инженеры решают эту проблему за 3–6 дней под ключ: интеграция Jira API с вашим сайтом, включая создание тикетов, синхронизацию статусов, вебхуки и портал самообслуживания для клиентов. В результате — нулевая потеря заявок, автоматизация рутины и прозрачность каждого шага.

Как аутентифицироваться в Jira API?

Jira Cloud использует Basic Auth с API-токеном. Токен создаётся в настройках аккаунта — никогда не используйте пароль напрямую. Для Jira Server применяется OAuth или личный токен (PAT). В примере ниже — аутентификация через Python-библиотеку jira:

from jira import JIRA jira = JIRA( server='https://your-company.atlassian.net', basic_auth=('[email protected]', JIRA_API_TOKEN) # API token, не пароль ) 

API-токен даёт доступ только к необходимым проектам. Храните его в переменных окружения, а не в коде.

Как создать задачу из формы на PHP?

Типичный сценарий — пользователь заполняет форму поддержки, и на сервере создаётся задача Jira. Используем HTTP-клиент Laravel для отправки POST-запроса к /rest/api/3/issue:

class JiraService { public function createIssue(SupportRequest $data): string { $resp = Http::withBasicAuth( config('services.jira.email'), config('services.jira.token') )->post(config('services.jira.url') . '/rest/api/3/issue', [ 'fields' => [ 'project' => ['key' => 'SUPPORT'], 'summary' => "[Web] {$data->subject}", 'description' => [ 'type' => 'doc', 'version' => 1, 'content' => [[ 'type' => 'paragraph', 'content' => [['type' => 'text', 'text' => $data->message]], ]], ], 'issuetype' => ['name' => 'Support'], 'priority' => ['name' => $data->priority ?? 'Medium'], 'labels' => ['website', 'customer-request'], 'customfield_10014' => $data->customer_email, // Кастомное поле email ], ]); $issueKey = $resp->json('key'); // SUPPORT-123 // Сохраняем привязку заявки к тикету SupportTicket::create([ 'user_id' => $data->userId, 'jira_key' => $issueKey, 'subject' => $data->subject, 'status' => 'open', ]); return $issueKey; } } 

Обратите внимание: поле issuetype должно соответствовать типу задачи в проекте. Кастомные поля (например, email клиента) передаются по ID — их нужно предварительно найти в настройках Jira.

Как отобразить статус тикета на сайте?

После создания задачи клиент хочет видеть её статус. GET-запрос к /rest/api/3/issue/{issueKey} возвращает все необходимые поля:

public function getTicketStatus(string $issueKey): array { $resp = Http::withBasicAuth($email, $token) ->get(config('services.jira.url') . "/rest/api/3/issue/{$issueKey}"); $issue = $resp->json(); return [ 'key': $issue['key'], 'summary': $issue['fields']['summary'], 'status': $issue['fields']['status']['name'], 'updated': $issue['fields']['updated'], 'comments': count($issue['fields']['comment']['comments'] ?? []), ]; } 

Выводите эту информацию в личном кабинете. Важно: кэшируйте ответы на 30–60 секунд, чтобы не превысить лимиты Jira API (обычно 5000 запросов в час).

Как настроить вебхуки для синхронизации статуса?

Вебхуки — это push-уведомления от Jira при изменении задачи. Они в 100 раз эффективнее, чем опрос статуса каждые 5 минут. В Jira Cloud создайте вебхук с событием jira:issue_updated и укажите URL вашего сайта. Обработчик на Laravel:

Route::post('/webhooks/jira', function (Request $request) { $event = $request->input('webhookEvent'); $issue = $request->input('issue'); $issueKey = $issue['key']; if ($event === 'jira:issue_updated') { $newStatus = $issue['fields']['status']['name']; SupportTicket::where('jira_key', $issueKey)->update([ 'status' => $this->mapJiraStatus($newStatus), 'updated_at' => now(), ]); // Уведомить клиента об изменении статуса $ticket = SupportTicket::where('jira_key', $issueKey)->first(); if ($ticket) { Mail::to($ticket->user->email)->send(new TicketStatusUpdatedMail($ticket)); } } return response('ok'); }); 

Не забудьте проверить X-Hub-Signature для безопасности (смотрите документацию Jira webhooks).

Пошаговый план интеграции Jira с сайтом

1. Настройте аутентификацию: создайте API-токен в Jira Cloud.
2. Реализуйте эндпоинт для создания тикета из веб-формы (POST /rest/api/3/issue).
3. Сохраните ключ тикета в локальной БД для отслеживания.
4. Настройте отображение статуса в личном кабинете (GET /rest/api/3/issue/{key}).
5. Создайте вебхук в Jira для push-уведомлений об изменении статуса.
6. Реализуйте обработчик вебхука на сервере с обновлением статуса и уведомлением клиента.
7. Протестируйте весь цикл: создание → изменение статуса → отображение.

Для крупных клиентов мы дополнительно разворачиваем портал самообслуживания, где можно просматривать историю тикетов и оставлять комментарии без входа в Jira. Это снижает нагрузку на поддержку на 40%.

Сколько времени занимает интеграция?

Стоимость рассчитывается индивидуально — зависит от сложности полей, количества проектов и необходимости кастомных веб-форм. В среднем, наши клиенты экономят от $3000 до $5000 в месяц после внедрения.

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

• Документация по интеграции (схема запросов, ключи, примеры).
• Исходный код с комментариями (PHP/Laravel или Python).
• Настройка вебхуков и тестирование на staging.
• Обучение команды поддержки работе с порталом.
• Гарантия стабильной работы в течение 30 дней.

Наш опыт: более 50 успешных интеграций Jira с сайтами. Гарантируем, что система не сломается при пиковых нагрузках. Хотите такую же автоматизацию? Свяжитесь с нами — за один день оценим ваш проект и предложим архитектуру интеграции. Закажите интеграцию Jira с сайтом у сертифицированных партнёров Atlassian.