Jira konnektor

Csatlakoztasd a Jira Cloud példányodat a Brevóhoz ügyfél-oldali hibajegy-követéshez, support jegy láthatósághoz és projekt mérföldkő-értesítésekhez a Tajo segítségével.

Áttekintés

Funkciók

• Hibajegy-esemény szinkronizáció – Hibajegy létrehozási, frissítési és megoldási események továbbítása Brevo kapcsolati idővonalakra
• Ügyfél jegykövetés – Jira hibajegyek összekapcsolása Brevo kapcsolatokkal support láthatóságért
• Projekt mérföldkő riasztások – Brevo kampányok indítása verziókon és sprint befejezéseken
• Csapatkapacitás-adatok – Munkaterhelési mutatók szinkronizálása operatív dashboardokhoz
• Státuszváltozási események – Hibajegy munkafolyamat-átmenetek követése Brevo eseményekként
• Megjegyzés-szinkronizáció – Ügyfél-oldali megjegyzések továbbítása Brevo tevékenységnaplókba

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Jira Cloud példánnyal (Jira Software, Jira Service Management vagy Jira Work Management)
2. Adminisztrátori hozzáféréssel OAuth alkalmazások létrehozásához vagy API tokenek generálásához
3. Az API tokenhez tartozó Atlassian fiók e-mail-jével
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

Hitelesítés

A Jira Cloud több hitelesítési módszert támogat.

1. lehetőség: OAuth 2.0 (3LO) – ajánlott

1. Menj a developer.atlassian.com oldalra
2. Kattints a Create > OAuth 2.0 integration gombra
3. Konfiguráld a callback URL-t: https://app.tajo.io/callbacks/jira
4. Add hozzá ezeket a hatóköröket:

read:jira-work
read:jira-user
write:jira-work
read:me

Az OAuth 2.0 API URL struktúra:

https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/{resource}

2. lehetőség: API Token (Basic Auth)

1. Menj az id.atlassian.com/manage/api-tokens oldalra
2. Kattints a Create API token gombra
3. Nevezd el „Tajo Integration”-nek

# Basic Auth: email as username, API token as password
curl -X GET "https://your-domain.atlassian.net/rest/api/3/myself" \
  -u "[email protected]:$JIRA_API_TOKEN" \
  -H "Accept: application/json"

Csatlakozás a Tajóhoz

# Using OAuth 2.0
tajo connectors install jira \
  --client-id $JIRA_CLIENT_ID \
  --client-secret $JIRA_CLIENT_SECRET \
  --cloud-id $JIRA_CLOUD_ID

# Using API Token
tajo connectors install jira \
  --site-url your-domain.atlassian.net \
  --email [email protected] \
  --api-token $JIRA_API_TOKEN

Konfiguráció

Alapbeállítás

connectors:
  jira:
    enabled: true
    site_url: "your-domain.atlassian.net"
    auth_type: "oauth2"  # or "basic"

    sync:
      issues: true
      projects: true
      users: true
      comments: true
      worklogs: false

    projects:
      - key: "SUPPORT"
        sync_to_list: 22
      - key: "PRODUCT"
        sync_to_list: 23

    issue_types:
      - Bug
      - Story
      - Task
      - Support Request

Mezőleképezés

Képezd le a Jira hibajegy és felhasználói mezőket Brevo attribútumokhoz:

field_mapping:
  # User fields
  accountId: JIRA_ACCOUNT_ID
  emailAddress: email
  displayName: FIRSTNAME

  # Issue fields mapped to contact events
  issue_key: LAST_TICKET_KEY
  issue_status: LAST_TICKET_STATUS
  issue_priority: LAST_TICKET_PRIORITY
  issue_created: LAST_TICKET_DATE
  resolution: LAST_TICKET_RESOLUTION

API végpontok

A Tajo az alábbi Jira Cloud REST API v3 végpontokkal integrálódik:

Kódpéldák

A konnektor inicializálása

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('jira', {
  clientId: process.env.JIRA_CLIENT_ID,
  clientSecret: process.env.JIRA_CLIENT_SECRET,
  cloudId: process.env.JIRA_CLOUD_ID
});

Support hibajegyek szinkronizálása

// Sync Jira support issues to Brevo contacts
await tajo.connectors.sync('jira', {
  type: 'incremental',
  resources: ['issues'],
  jql: 'project = SUPPORT AND updated >= -24h',
  batchSize: 50
});

const status = await tajo.connectors.status('jira');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T12:00:00Z',
//   issuesTracked: 4560,
//   projectsMonitored: 3,
//   usersLinked: 890
// }

Jira webhookok kezelése

app.post('/webhooks/jira', async (req, res) => {
  const event = req.body;

  await tajo.connectors.handleWebhook('jira', {
    event: event.webhookEvent,
    payload: {
      issueKey: event.issue?.key,
      issueType: event.issue?.fields?.issuetype?.name,
      status: event.issue?.fields?.status?.name,
      reporter: event.issue?.fields?.reporter?.emailAddress,
      assignee: event.issue?.fields?.assignee?.emailAddress
    }
  });

  res.status(200).send('OK');
});

Hibajegyek keresése ügyfél szerint

// Find all issues reported by a specific customer
const issues = await tajo.connectors.query('jira', {
  jql: 'reporter = "[email protected]" ORDER BY created DESC',
  maxResults: 20,
  fields: ['summary', 'status', 'priority', 'created']
});

Ráta-korlátok

A Jira Cloud ráta-korlátokat alkalmaz a platform stabilitása érdekében:

A Jira 429 Too Many Requests választ ad vissza a ráta-korlátok túllépésekor, a Retry-After fejléc jelzi az újrapróbálkozás idejét.

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

connectors:
  jira:
    debug: true
    log_level: verbose
    log_api_calls: true

Kapcsolat tesztelése

tajo connectors test jira
# ✓ API authentication successful
# ✓ Project access verified
# ✓ Issue search operational
# ✓ User lookup available
# ✓ Webhook registration active

Legjobb gyakorlatok

1. Éles alkalmazásokhoz használj OAuth 2.0-t – Elkerüli az egyéni felhasználói fióktól való függést
2. Szűrj JQL-lel – Csak a releváns hibajegyeket szinkronizáld az API hívások csökkentéséhez
3. Valós idejűséghez használj webhookokat – Kerüld a lekérdezést; regisztrálj webhookokat a hibajegy-változásokhoz
4. Tartsd tiszteletben az ADF formátumot – A Jira v3 Atlassian Document Formatot használ a formázott szöveges mezőkhöz
5. Képezd le projektet listára – Hozz létre különálló Brevo listákat Jira projektenként
6. Kezelj oldalazást – Mindig iterálj az összes oldalon az adatok teljességéhez

Biztonság

• OAuth 2.0 (3LO) – Biztonságos token alapú hitelesítés refresh tokenekkel
• API Token + Basic Auth – Base64 kódolt hitelesítő adatok HTTPS-en keresztül
• Csak HTTPS – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
• Hatókörrel korlátozott hozzáférés – Az OAuth hatókörök az API hozzáférést a szükséges erőforrásokra korlátozzák
• Atlassian Cloud biztonság – SOC 2 Type II tanúsított infrastruktúra
• Titkosított tárolás – A hitelesítő adatok titkosítva tárolódnak a Tajóban

Kapcsolódó források

• GitHub konnektor
• Linear konnektor
• Gorgias konnektor
• Brevo Contacts API