Σύνδεσμος Freshdesk

Συνδέστε το Freshdesk με το Brevo μέσω Tajo για ενοποίηση δεδομένων υποστήριξης και marketing. Συγχρονίστε εισιτήρια υποστήριξης πελατών, προφίλ επαφών και βαθμολογίες ικανοποίησης για να τροφοδοτήσετε στοχευμένες επικοινωνίες βάσει αλληλεπιδράσεων υποστήριξης.

Επισκόπηση

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

• Συγχρονισμός επαφών - Αμφίδρομος συγχρονισμός επαφών Freshdesk σε λίστες επαφών Brevo
• Παρακολούθηση εκδηλώσεων εισιτηρίων - Προώθηση εκδηλώσεων δημιουργίας, ενημέρωσης και επίλυσης εισιτηρίων στο Brevo
• Συγχρονισμός CSAT - Συγχρονισμός βαθμολογιών ικανοποίησης πελατών ως χαρακτηριστικά επαφών Brevo
• Συγχρονισμός εταιρειών - Αντιστοίχηση εταιρειών Freshdesk στη τμηματοποίηση επαφών Brevo
• Δεδομένα πράκτορα - Παρακολούθηση αναθέσεων πράκτορα για αυτοματισμό εσωτερικής ροής εργασίας
• Προσαρμοσμένα πεδία - Αντιστοίχηση προσαρμοσμένων πεδίων εισιτηρίων και επαφών Freshdesk σε χαρακτηριστικά Brevo

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

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

1. Λογαριασμό Freshdesk με πρόσβαση διαχειριστή
2. Το κλειδί API Freshdesk (βρίσκεται στις Ρυθμίσεις Προφίλ)
3. Τον τομέα Freshdesk σας (π.χ. yourcompany.freshdesk.com)
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

Πιστοποίηση με Κλειδί API

Το Freshdesk χρησιμοποιεί πιστοποίηση κλειδιού API μέσω HTTP Basic Auth. Το κλειδί API χρησιμοποιείται ως username με οποιαδήποτε συμβολοσειρά (συνήθως X) ως κωδικός.

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

Ή χρησιμοποιώντας κωδικοποίηση Base64 στην κεφαλίδα Authorization:

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

Εύρεση Κλειδιού API

1. Συνδεθείτε στον λογαριασμό Freshdesk
2. Κάντε κλικ στη φωτογραφία προφίλ πάνω δεξιά
3. Μεταβείτε στις Ρυθμίσεις Προφίλ
4. Το κλειδί API εμφανίζεται στη δεξιά πλευρά

Διαμόρφωση

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

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 σε triggers αυτοματισμού 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"

Endpoints 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. Χρησιμοποιήστε webhooks για συγχρονισμό σε πραγματικό χρόνο - Ρυθμίστε Automations Freshdesk για trigger webhooks σε εκδηλώσεις εισιτηρίων
2. Συγχρονίστε βαθμολογίες CSAT - Παρακολουθήστε βαθμολογίες ικανοποίησης πελατών ως χαρακτηριστικά Brevo για τμηματοποίηση
3. Αντιστοιχίστε κατάσταση εισιτηρίου σε λίστες - Μετακινήστε αυτόματα επαφές μεταξύ λιστών Brevo βάσει κατάστασης εισιτηρίου
4. Παρακολουθήστε μετρικά υποστήριξης - Συγχρονίστε αριθμό εισιτηρίων, μέσο χρόνο απόκρισης και ποσοστό επίλυσης ανά επαφή
5. Χρησιμοποιήστε το search API με φειδώ - Το search API έχει αυστηρότερα όρια ρυθμού· αποθηκεύστε αποτελέσματα όταν είναι δυνατό
6. Σελιδοποιήστε μεγάλες εξαγωγές - Χρησιμοποιήστε σελιδοποίηση με παραμέτρους page και per_page για αρχικό συγχρονισμό

Ασφάλεια

• Πιστοποίηση κλειδιού API - Απλή HTTP Basic Auth με κλειδί API
• Μόνο HTTPS - Όλη η επικοινωνία API απαιτεί κρυπτογράφηση TLS
• Λίστα επιτρεπόμενων IP - Διαθέσιμο σε πλάνα Estate και Forest
• Πρόσβαση βάσει ρόλου - Δικαιώματα κλειδιού API συνδεδεμένα με ρόλο πράκτορα
• SOC 2 Type II - Το Freshdesk είναι πιστοποιημένο SOC 2 Type II
• Συμμόρφωση GDPR - Υποστηρίζει αιτήματα εξαγωγής και διαγραφής δεδομένων

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

• Σύνδεσμος Brevo
• Δεξιότητα Συγχρονισμού Πελατών
• Σύνδεσμος Shopify
• API Επαφών Brevo