---
title: "Σύνδεσμος Jira"
description: "Πλήρης οδηγός ενσωμάτωσης Jira Cloud για συγχρονισμό ζητημάτων, έργων και δεδομένων δραστηριότητας ομάδας με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/custom/jira/
markdown: https://tajo.io/gr/docs/connectors/custom/jira.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Jira

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε την περίπτωση Jira Cloud σας με το Brevo για παρακολούθηση ζητημάτων που αντιμετωπίζουν πελάτες, ορατότητα αιτημάτων υποστήριξης και ειδοποιήσεις ορόσημων έργου μέσω Tajo.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Jira Cloud |
| **Κατηγορία** | Προσαρμοσμένο |
| **Πολυπλοκότητα Ρύθμισης** | Μεσαία |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Ζητήματα, Έργα, Χρήστες, Εκδηλώσεις |
| **Τύπος API** | REST API v3 |
| **Πιστοποίηση** | OAuth 2.0 (3LO) / API Token (Basic Auth) |
| **Βασικό URL** | `https://your-domain.atlassian.net/rest/api/3/` |

## Χαρακτηριστικά

- **Συγχρονισμός εκδηλώσεων ζητήματος** - Προώθηση εκδηλώσεων δημιουργίας, ενημέρωσης και επίλυσης ζητημάτων στα χρονοδιαγράμματα επαφών Brevo
- **Παρακολούθηση αιτημάτων πελάτη** - Σύνδεση ζητημάτων Jira με επαφές Brevo για ορατότητα υποστήριξης
- **Ειδοποιήσεις ορόσημων έργου** - Ενεργοποίηση καμπανιών Brevo σε κυκλοφορίες εκδόσεων και ολοκληρώσεις sprint
- **Δεδομένα χωρητικότητας ομάδας** - Συγχρονισμός μετρήσεων φόρτου εργασίας για επιχειρησιακούς πίνακες εργαλείων
- **Εκδηλώσεις αλλαγής κατάστασης** - Παρακολούθηση μεταβάσεων ροής εργασίας ζητήματος ως εκδηλώσεις Brevo
- **Συγχρονισμός σχολίων** - Προώθηση σχολίων που αντιμετωπίζουν πελάτες σε αρχεία καταγραφής δραστηριότητας Brevo

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Περίπτωση Jira Cloud (Jira Software, Jira Service Management ή Jira Work Management)
2. Πρόσβαση διαχειριστή για δημιουργία εφαρμογών OAuth ή παραγωγή tokens API
3. Το email λογαριασμού Atlassian συσχετισμένο με το token API σας
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

## Πιστοποίηση

Το Jira Cloud υποστηρίζει πολλαπλές μεθόδους πιστοποίησης.

### Επιλογή 1: OAuth 2.0 (3LO) - Συνιστάται

1. Μεταβείτε στο [developer.atlassian.com](https://developer.atlassian.com/console/myapps/)
2. Κάντε κλικ στο **Create** > **OAuth 2.0 integration**
3. Ρυθμίστε URL callback: `https://app.tajo.io/callbacks/jira`
4. Προσθέστε αυτά τα scopes:

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

Η δομή URL API για OAuth 2.0:

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

### Επιλογή 2: API Token (Basic Auth)

1. Μεταβείτε στο [id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens)
2. Κάντε κλικ στο **Create API token**
3. Ονομάστε το “Tajo Integration”

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

Περιορισμοί API Token

Τα tokens API συνδέονται με μεμονωμένους λογαριασμούς χρήστη. Εάν ο χρήστης απενεργοποιηθεί, η ενσωμάτωση διακόπτεται. Χρησιμοποιήστε OAuth 2.0 για αναπτύξεις παραγωγής.

### Σύνδεση με Tajo

```bash
# 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 admin@example.com \
  --api-token $JIRA_API_TOKEN
```

## Διαμόρφωση

### Βασική Ρύθμιση

```yaml
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
```

### Αντιστοίχιση Πεδίων

Αντιστοιχίστε πεδία ζητήματος και χρήστη Jira σε χαρακτηριστικά Brevo:

```yaml
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
```

## Endpoints API

Το Tajo ενσωματώνεται με τα παρακάτω endpoints REST API v3 Jira Cloud:

| Endpoint | Μέθοδος | Σκοπός |
| --- | --- | --- |
| `/rest/api/3/search` | POST | Αναζήτηση ζητημάτων με JQL |
| `/rest/api/3/issue/{issueIdOrKey}` | GET | Λήψη λεπτομερειών ζητήματος |
| `/rest/api/3/issue` | POST | Δημιουργία ζητήματος |
| `/rest/api/3/project` | GET | Λίστα όλων των έργων |
| `/rest/api/3/project/{projectIdOrKey}` | GET | Λήψη λεπτομερειών έργου |
| `/rest/api/3/user/search` | GET | Αναζήτηση χρηστών |
| `/rest/api/3/myself` | GET | Λήψη τρέχοντος χρήστη |
| `/rest/api/3/issue/{issueIdOrKey}/comment` | GET | Λήψη σχολίων ζητήματος |
| `/rest/api/3/webhook` | POST | Εγγραφή webhooks |
| `/rest/api/3/status` | GET | Λήψη όλων των καταστάσεων |
| `/rest/api/3/priority` | GET | Λήψη όλων των προτεραιοτήτων |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου

```javascript
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
});
```

### Συγχρονισμός Ζητημάτων Υποστήριξης

```javascript
// 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
// }
```

### Χειρισμός Webhooks Jira

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

### Αναζήτηση Ζητημάτων ανά Πελάτη

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

## Όρια Ρυθμού

Το Jira Cloud επιβάλλει όρια ρυθμού για να εξασφαλίσει σταθερότητα πλατφόρμας:

| Πλαίσιο | Όριο Ρυθμού |
| --- | --- |
| **REST API** | ~100 αιτήματα ανά 10 δευτερόλεπτα ανά χρήστη |
| **Ταυτόχρονα αιτήματα** | 10 ταυτόχρονα μακρόχρονα αιτήματα |
| **Λειτουργίες μαζικής επεξεργασίας** | Ποικίλλει ανά endpoint |

Σελιδοποίηση

Το Jira χρησιμοποιεί σελιδοποίηση βάσει offset με παραμέτρους `startAt` και `maxResults`. Το προεπιλεγμένο μέγεθος σελίδας είναι 50, μέγιστο 100. Το Tajo χειρίζεται αυτόματα τη σελιδοποίηση.

Το Jira επιστρέφει απόκριση `429 Too Many Requests` όταν υπερβαίνονται τα όρια ρυθμού, με header `Retry-After` που υποδεικνύει πότε να επαναληφθεί η προσπάθεια.

## Αντιμετώπιση Προβλημάτων

### Συνηθισμένα Προβλήματα

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο token ή ληγμένο OAuth | Ανανέωση OAuth token ή αναγέννηση API token |
| 403 Forbidden | Ανεπαρκή δικαιώματα | Ελέγξτε ότι ο χρήστης έχει πρόσβαση στο ζητούμενο έργο |
| Σφάλματα JQL | Μη έγκυρη σύνταξη ερωτήματος | Επικυρώστε JQL στην αναζήτηση ζητημάτων Jira πρώτα |
| Δεν λαμβάνεται webhook | Αποκλεισμός firewall | Βεβαιωθείτε ότι το URL webhook είναι δημόσια προσβάσιμο |
| Λείπουν πεδία | Το πεδίο δεν υπάρχει στην απόκριση | Προσθέστε πεδίο στην παράμετρο `fields` ή χρησιμοποιήστε `expand` |

### Λειτουργία Εντοπισμού Σφαλμάτων

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

### Δοκιμή Σύνδεσης

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

## Βέλτιστες Πρακτικές

1. **Χρησιμοποιήστε OAuth 2.0 για παραγωγή** - Αποφεύγει εξάρτηση από μεμονωμένους λογαριασμούς χρηστών
2. **Φιλτράρετε με JQL** - Συγχρονίστε μόνο σχετικά ζητήματα για μείωση κλήσεων API
3. **Χρησιμοποιήστε webhooks για πραγματικό χρόνο** - Αποφύγετε polling· εγγράψτε webhooks για αλλαγές ζητημάτων
4. **Σεβαστείτε τη μορφή ADF** - Το Jira v3 χρησιμοποιεί Atlassian Document Format για πεδία μορφατισμένου κειμένου
5. **Αντιστοιχίστε έργο σε λίστα** - Δημιουργήστε ξεχωριστές λίστες Brevo ανά έργο Jira
6. **Χειριστείτε σελιδοποίηση** - Επαναλάβετε πάντα σε όλες τις σελίδες για πλήρη δεδομένα

## Ασφάλεια

- **OAuth 2.0 (3LO)** - Ασφαλής πιστοποίηση βάσει token με refresh tokens
- **API Token + Basic Auth** - Κωδικοποιημένα Base64 διαπιστευτήρια μέσω HTTPS
- **Μόνο HTTPS** - Όλη η επικοινωνία API κρυπτογραφημένη μέσω TLS 1.2+
- **Πρόσβαση βάσει scope** - Τα scopes OAuth περιορίζουν την πρόσβαση API στους απαιτούμενους πόρους
- **Ασφάλεια Atlassian Cloud** - Υποδομή πιστοποιημένη SOC 2 Type II
- **Κρυπτογραφημένη Αποθήκευση** - Τα διαπιστευτήρια κρυπτογραφούνται σε ηρεμία στο Tajo

## Σχετικοί Πόροι

- [Σύνδεσμος GitHub](https://tajo.io/gr/docs/connectors/custom/github)
- [Σύνδεσμος Linear](https://tajo.io/gr/docs/connectors/custom/linear)
- [Σύνδεσμος Gorgias](https://tajo.io/gr/docs/connectors/support/gorgias)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)