Σύνδεσμος Jira

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

Επισκόπηση

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

• Συγχρονισμός εκδηλώσεων ζητήματος - Προώθηση εκδηλώσεων δημιουργίας, ενημέρωσης και επίλυσης ζητημάτων στα χρονοδιαγράμματα επαφών 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
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
2. Κάντε κλικ στο Create API token
3. Ονομάστε το “Tajo Integration”

# 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"

Σύνδεση με Tajo

# 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

Διαμόρφωση

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

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:

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:

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

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

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

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

// 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

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

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

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

Όρια Ρυθμού

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

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

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

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

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

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

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

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
• Σύνδεσμος Linear
• Σύνδεσμος Gorgias
• API Επαφών Brevo