Jira कनेक्टर

customer-facing issue tracking, support ticket visibility, और project milestone notifications के लिए अपने Jira Cloud instance को Tajo के माध्यम से Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• Issue event sync - issue create, update, और resolve events को Brevo contact timelines में forward करें
• Customer ticket tracking - support visibility के लिए Jira issues को Brevo contacts से link करें
• Project milestone alerts - version releases और sprint completions पर Brevo campaigns trigger करें
• Team capacity data - operational dashboards के लिए workload metrics sync करें
• Status change events - issue workflow transitions को Brevo events के रूप में ट्रैक करें
• Comment sync - customer-facing comments को Brevo activity logs में forward करें

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास हैं:

1. एक Jira Cloud instance (Jira Software, Jira Service Management, या Jira Work Management)
2. OAuth apps बनाने या API tokens generate करने के लिए admin access
3. आपके API token से जुड़ा Atlassian account email
4. API access वाला एक Brevo account
5. सक्रिय subscription वाला एक Tajo account

प्रमाणीकरण

Jira Cloud कई authentication methods को support करता है।

विकल्प 1: OAuth 2.0 (3LO) - अनुशंसित

1. developer.atlassian.com पर जाएं
2. Create > OAuth 2.0 integration पर क्लिक करें
3. callback URL कॉन्फ़िगर करें: https://app.tajo.io/callbacks/jira
4. ये scopes जोड़ें:

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

OAuth 2.0 के लिए API URL structure:

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: username के रूप में email, password के रूप में API token
curl -X GET "https://your-domain.atlassian.net/rest/api/3/myself" \
  -u "[email protected]:$JIRA_API_TOKEN" \
  -H "Accept: application/json"

Tajo से कनेक्ट करना

# OAuth 2.0 का उपयोग
tajo connectors install jira \
  --client-id $JIRA_CLIENT_ID \
  --client-secret $JIRA_CLIENT_SECRET \
  --cloud-id $JIRA_CLOUD_ID

# 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

Field Mapping

Jira issue और user fields को Brevo attributes से map करें:

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

  # contact events से mapped issue fields
  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 Endpoints

Tajo निम्नलिखित Jira Cloud REST API v3 endpoints के साथ integrate करता है:

कोड उदाहरण

कनेक्टर शुरू करें

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 Issues Sync करें

// Jira support issues को Brevo contacts से sync करें
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 Webhooks हैंडल करें

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

Customer द्वारा Issues खोजें

// किसी विशिष्ट customer द्वारा रिपोर्ट किए गए सभी issues खोजें
const issues = await tajo.connectors.query('jira', {
  jql: 'reporter = "[email protected]" ORDER BY created DESC',
  maxResults: 20,
  fields: ['summary', 'status', 'priority', 'created']
});

Rate Limits

Jira Cloud platform stability सुनिश्चित करने के लिए rate limits लागू करता है:

जब rate limits पार हो जाते हैं तो Jira 429 Too Many Requests response लौटाता है, जिसमें Retry-After header होता है जो दर्शाता है कि कब retry करना है।

समस्या निवारण

सामान्य समस्याएं

Debug Mode

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

Connection Test करें

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

सर्वोत्तम प्रथाएं

1. Production के लिए OAuth 2.0 का उपयोग करें - व्यक्तिगत user accounts पर निर्भरता से बचता है
2. JQL के साथ filter करें - API calls कम करने के लिए केवल प्रासंगिक issues sync करें
3. Real-time के लिए webhooks का उपयोग करें - polling से बचें; issue changes के लिए webhooks register करें
4. ADF format का सम्मान करें - Jira v3 rich text fields के लिए Atlassian Document Format का उपयोग करता है
5. Project-to-list map करें - प्रति Jira project अलग Brevo lists बनाएं
6. Pagination संभालें - पूर्ण data के लिए हमेशा सभी pages के माध्यम से iterate करें

सुरक्षा

• OAuth 2.0 (3LO) - refresh tokens के साथ सुरक्षित token-आधारित authentication
• API Token + Basic Auth - HTTPS पर Base64-encoded credentials
• HTTPS Only - सभी API communication TLS 1.2+ के माध्यम से encrypted
• Scoped Access - OAuth scopes API access को आवश्यक संसाधनों तक सीमित करते हैं
• Atlassian Cloud Security - SOC 2 Type II certified infrastructure
• Encrypted Storage - Credentials Tajo में at rest encrypted

संबंधित संसाधन

• GitHub कनेक्टर
• Linear कनेक्टर
• Gorgias कनेक्टर
• Brevo Contacts API