Інтеграція 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 з сайтами. Гарантуємо, що система не зламається при пікових навантаженнях. Хочете таку ж автоматизацію? Зв'яжіться з нами — за один день оцінимо ваш проект і запропонуємо архітектуру інтеграції.