Freshdesk कनेक्टर

सपोर्ट और मार्केटिंग डेटा को एकीकृत करने के लिए Tajo के माध्यम से Freshdesk को Brevo से कनेक्ट करें। सपोर्ट इंटरैक्शन्स के आधार पर लक्षित संचार को सशक्त करने के लिए ग्राहक सपोर्ट टिकट्स, कॉन्टैक्ट प्रोफ़ाइल्स, और संतुष्टि स्कोर सिंक करें।

अवलोकन

विशेषताएं

• कॉन्टैक्ट सिंक - Brevo कॉन्टैक्ट lists के साथ Freshdesk कॉन्टैक्ट्स का द्विदिशीय sync
• टिकट इवेंट ट्रैकिंग - टिकट निर्माण, अपडेट, और resolution इवेंट्स को Brevo में फ़ॉरवर्ड करें
• CSAT सिंक - ग्राहक संतुष्टि स्कोर को Brevo कॉन्टैक्ट एट्रिब्यूट्स के रूप में सिंक करें
• कंपनी सिंक - Freshdesk कंपनियों को Brevo कॉन्टैक्ट सेगमेंटेशन में मैप करें
• एजेंट डेटा - आंतरिक workflow ऑटोमेशन के लिए एजेंट असाइनमेंट ट्रैक करें
• कस्टम फ़ील्ड्स - Freshdesk कस्टम टिकट और कॉन्टैक्ट फ़ील्ड्स को Brevo एट्रिब्यूट्स में मैप करें

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

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

1. admin एक्सेस के साथ एक Freshdesk खाता
2. आपकी Freshdesk API Key (Profile Settings में मिले)
3. आपका Freshdesk domain (जैसे, yourcompany.freshdesk.com)
4. API एक्सेस वाला एक Brevo खाता
5. API क्रेडेंशियल्स वाला एक Tajo खाता

प्रमाणीकरण

API Key प्रमाणीकरण

Freshdesk HTTP Basic Auth के माध्यम से API key प्रमाणीकरण का उपयोग करता है। API key को username के रूप में किसी भी string (आमतौर पर X) के साथ password के रूप में उपयोग किया जाता है।

curl -u "YOUR_API_KEY:X" \
  https://yourcompany.freshdesk.com/api/v2/tickets

या Authorization हेडर में Base64 encoding का उपयोग करके:

curl https://yourcompany.freshdesk.com/api/v2/tickets \
  -H "Authorization: Basic BASE64_ENCODED_API_KEY:X" \
  -H "Content-Type: application/json"

अपनी API Key खोजें

1. अपने Freshdesk खाते में लॉग इन करें
2. ऊपरी-दाएं कोने में अपनी प्रोफ़ाइल चित्र पर क्लिक करें
3. Profile Settings पर जाएं
4. आपकी API Key दाईं ओर प्रदर्शित होती है

कॉन्फ़िगरेशन

बुनियादी सेटअप

connectors:
  freshdesk:
    enabled: true
    domain: "yourcompany.freshdesk.com"
    api_key: "your-freshdesk-api-key"

    # Data sync options
    sync:
      contacts: true
      tickets: true
      companies: true
      satisfaction_ratings: true

    # Brevo list assignment
    lists:
      all_support_contacts: 30
      open_tickets: 31
      resolved_tickets: 32

कॉन्टैक्ट फ़ील्ड मैपिंग

Freshdesk कॉन्टैक्ट फ़ील्ड्स को Brevo एट्रिब्यूट्स में मैप करें:

contact_mapping:
  email: email
  name: FULLNAME
  phone: SMS
  company_id: COMPANY
  job_title: JOB_TITLE
  twitter_id: TWITTER
  language: LANGUAGE
  time_zone: TIMEZONE

  # Support metrics
  total_tickets: TICKET_COUNT
  open_tickets: OPEN_TICKETS
  avg_csat: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # Custom fields
  custom_fields.account_type: ACCOUNT_TYPE
  custom_fields.subscription_tier: PLAN

टिकट इवेंट मैपिंग

Freshdesk टिकट इवेंट्स को Brevo ऑटोमेशन ट्रिगर्स में मैप करें:

ticket_events:
  ticket_created: "support_ticket_created"
  ticket_updated: "support_ticket_updated"
  ticket_resolved: "support_ticket_resolved"
  ticket_closed: "support_ticket_closed"
  ticket_reopened: "support_ticket_reopened"
  satisfaction_rated: "csat_submitted"
  note_added: "support_note_added"

API एंडपॉइंट्स

कोड उदाहरण

Freshdesk कनेक्टर प्रारंभ करें

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

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

// Connect Freshdesk account
await tajo.connectors.connect('freshdesk', {
  domain: 'yourcompany.freshdesk.com',
  apiKey: process.env.FRESHDESK_API_KEY
});

Brevo में कॉन्टैक्ट्स सिंक करें

// Fetch Freshdesk contacts and sync to Brevo
const response = await fetch(
  'https://yourcompany.freshdesk.com/api/v2/contacts?page=1&per_page=100',
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`),
      'Content-Type': 'application/json'
    }
  }
);

const contacts = await response.json();
// Each contact:
// {
//   "id": 12345,
//   "name": "Jane Kim",
//   "email": "[email protected]",
//   "phone": "+15551234567",
//   "company_id": 678,
//   "job_title": "Product Manager",
//   "created_at": "2024-01-15T10:30:00Z"
// }

टिकट इवेंट्स ट्रैक करें

// Set up Freshdesk webhook to forward ticket events
// Configure in Freshdesk Admin > Automations > Webhook

// Webhook handler
app.post('/webhooks/freshdesk', async (req, res) => {
  const { ticket, event_type } = req.body;

  await tajo.connectors.handleWebhook('freshdesk', {
    topic: event_type,
    payload: {
      ticketId: ticket.id,
      subject: ticket.subject,
      status: ticket.status,
      priority: ticket.priority,
      requesterEmail: ticket.requester.email,
      createdAt: ticket.created_at
    }
  });

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

ग्राहक के अनुसार टिकट्स खोजें

// Search for all tickets from a specific customer
const query = encodeURIComponent('"email:[email protected]"');
const response = await fetch(
  `https://yourcompany.freshdesk.com/api/v2/search/tickets?query=${query}`,
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`)
    }
  }
);

const { results, total } = await response.json();

दर सीमाएं

अतिरिक्त सीमाएं:

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

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

1. रीयल-टाइम sync के लिए webhooks का उपयोग करें - टिकट इवेंट्स पर webhooks ट्रिगर करने के लिए Freshdesk Automations कॉन्फ़िगर करें
2. CSAT स्कोर सिंक करें - सेगमेंटेशन के लिए Brevo एट्रिब्यूट्स के रूप में ग्राहक संतुष्टि ratings ट्रैक करें
3. टिकट स्थिति को lists में मैप करें - टिकट स्थिति के आधार पर Brevo lists के बीच कॉन्टैक्ट्स को स्वचालित रूप से स्थानांतरित करें
4. सपोर्ट मेट्रिक्स ट्रैक करें - प्रति कॉन्टैक्ट टिकट गिनती, औसत प्रतिक्रिया समय, और resolution rate सिंक करें
5. search API का संयम से उपयोग करें - search API की दर सीमाएं अधिक सख्त हैं; जब संभव हो परिणाम cache करें
6. बड़े exports को paginate करें - प्रारंभिक sync के लिए page और per_page पैरामीटर के साथ pagination का उपयोग करें

सुरक्षा

• API key प्रमाणीकरण - API key के साथ सरल HTTP Basic Auth
• HTTPS only - सभी API संचार को TLS एन्क्रिप्शन की आवश्यकता है
• IP whitelisting - Estate और Forest प्लान्स पर उपलब्ध
• Role-based एक्सेस - API key अनुमतियां agent role से जुड़ी हैं
• SOC 2 Type II - Freshdesk SOC 2 Type II प्रमाणित है
• GDPR अनुपालन - डेटा निर्यात और deletion अनुरोधों का समर्थन करता है

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

• Brevo Connector
• Customer Sync Skill
• Shopify Connector
• Brevo Contacts API