---
title: "Σύνδεσμος Freshdesk"
description: "Πλήρης οδηγός ενσωμάτωσης Freshdesk για συγχρονισμό εισιτηρίων υποστήριξης, επαφών και δεδομένων πράκτορα με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/support/freshdesk/
markdown: https://tajo.io/gr/docs/connectors/support/freshdesk.md
lang: el-GR
robots: noindex
---

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

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

# Σύνδεσμος Freshdesk

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

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

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

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

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Freshdesk |
| **Κατηγορία** | Υποστήριξη |
| **Πολυπλοκότητα Ρύθμισης** | Εύκολη |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Εισιτήρια, Επαφές, Πράκτορες, Εταιρείες |
| **Διαθέσιμες Δεξιότητες** | 6 |

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

- **Συγχρονισμός επαφών** - Αμφίδρομος συγχρονισμός επαφών 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`) ως κωδικός.

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

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

```bash
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 εμφανίζεται στη δεξιά πλευρά

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

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

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

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

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

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/api/v2/tickets` | Λίστα όλων των εισιτηρίων |
| `POST` | `/api/v2/tickets` | Δημιουργία εισιτηρίου |
| `GET` | `/api/v2/tickets/{id}` | Λήψη συγκεκριμένου εισιτηρίου |
| `PUT` | `/api/v2/tickets/{id}` | Ενημέρωση εισιτηρίου |
| `DELETE` | `/api/v2/tickets/{id}` | Διαγραφή εισιτηρίου |
| `GET` | `/api/v2/contacts` | Λίστα όλων των επαφών |
| `POST` | `/api/v2/contacts` | Δημιουργία επαφής |
| `PUT` | `/api/v2/contacts/{id}` | Ενημέρωση επαφής |
| `GET` | `/api/v2/companies` | Λίστα όλων των εταιρειών |
| `GET` | `/api/v2/agents` | Λίστα όλων των πρακτόρων |
| `GET` | `/api/v2/surveys/satisfaction_ratings` | Λίστα βαθμολογιών CSAT |
| `GET` | `/api/v2/search/tickets?query=` | Αναζήτηση εισιτηρίων |

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

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

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

```javascript
// 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": "jane@example.com",
//   "phone": "+15551234567",
//   "company_id": 678,
//   "job_title": "Product Manager",
//   "created_at": "2024-01-15T10:30:00Z"
// }
```

### Παρακολούθηση Εκδηλώσεων Εισιτηρίων

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

### Αναζήτηση Εισιτηρίων κατά Πελάτη

```javascript
// Search for all tickets from a specific customer
const query = encodeURIComponent('"email:jane@example.com"');
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();
```

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

| Πλάνο | Όριο | Λεπτομέρειες |
| --- | --- | --- |
| **Sprout** | 50 αιτήματα/λεπτό | Δωρεάν πλάνο |
| **Blossom** | 200 αιτήματα/λεπτό | Starter πλάνο |
| **Garden** | 400 αιτήματα/λεπτό | Growth πλάνο |
| **Estate** | 700 αιτήματα/λεπτό | Pro πλάνο |
| **Forest** | 1.000 αιτήματα/λεπτό | Enterprise πλάνο |

Επιπλέον όρια:

| Πόρος | Όριο |
| --- | --- |
| **Endpoints λίστας** | 30 σελίδες ανά ερώτημα |
| **Ανά σελίδα** | Μέγιστο 100 εγγραφές |
| **Search API** | 2 αιτήματα/δευτερόλεπτο |
| **Μαζικές λειτουργίες** | 10 εγγραφές/αίτημα |

Κεφαλίδες Ορίου Ρυθμού

Το Freshdesk επιστρέφει πληροφορίες ορίου ρυθμού στις κεφαλίδες απόκρισης. Παρακολουθήστε το `X-RateLimit-Remaining` και υλοποιήστε καθυστέρηση κατά προσέγγιση ορίων.

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| `401 Unauthorized` | Μη έγκυρο κλειδί API | Επαληθεύστε κλειδί API στις Ρυθμίσεις Προφίλ Freshdesk |
| `403 Forbidden` | Ανεπαρκή δικαιώματα | Βεβαιωθείτε ότι το κλειδί API ανήκει σε λογαριασμό διαχειριστή |
| Οι επαφές δεν συγχρονίζονται | Λείπει πεδίο email | Οι επαφές Freshdesk απαιτούν διεύθυνση email |
| Τα εισιτήρια δεν εμφανίζονται | Λάθος τομέας | Επαληθεύστε ότι το URL τομέα Freshdesk είναι σωστό |
| Η αναζήτηση επιστρέφει κενά | Συντακτικό σφάλμα ερωτήματος | Χρησιμοποιήστε σύνταξη ερωτήματος αναζήτησης Freshdesk με διπλά εισαγωγικά |
| `429 Too Many Requests` | Υπέρβαση ορίου ρυθμού | Υλοποιήστε περιορισμό ρυθμού βάσει επιπέδου πλάνου |
| Λείπουν προσαρμοσμένα πεδία | Το πεδίο δεν είναι ενεργοποιημένο | Βεβαιωθείτε ότι τα προσαρμοσμένα πεδία είναι ενεργοποιημένα στο Freshdesk admin |

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

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](https://tajo.io/gr/docs/connectors/marketing/brevo)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [Σύνδεσμος Shopify](https://tajo.io/gr/docs/connectors/ecommerce/shopify)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)