Интеграция Jira API с сайтом

Интеграция Jira API с сайтом

Jira API используется для создания задач из форм на сайте, отображения статуса тикетов клиентам, синхронизации статусов запросов поддержки, и построения порталов самообслуживания.

Аутентификация (Jira Cloud)

from jira import JIRA

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

Создание задачи из формы поддержки

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;
    }
}

Отображение статуса тикетов клиенту

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'] ?? []),
    ];
}

Webhooks для обновления статуса

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');
});

Сроки

Создание тикетов из форм + отображение статуса: 3–4 рабочих дня. С webhooks и уведомлениями: 5–6 дней.