---
title: "Freshdesk konnektor"
description: "Teljes Freshdesk integrációs útmutató támogatási jegyek, kapcsolatok és ügynök adatok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/support/freshdesk/
markdown: https://tajo.io/hu/docs/connectors/support/freshdesk.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Freshdesk konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Freshdesket a Brevóhoz a Tajo segítségével az ügyfélszolgálati és marketing adatok egységesítéséhez. Szinkronizálj ügyfélszolgálati jegyeket, kapcsolatprofilokat és elégedettségi pontszámokat a támogatási interakciókon alapuló célzott kommunikáció érdekében.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Freshdesk |
| **Kategória** | Ügyfélszolgálat |
| **Telepítés bonyolultsága** | Könnyű |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Jegyek, Kapcsolatok, Ügynökök, Vállalatok |
| **Elérhető Skillek** | 6 |

## Funkciók

- **Kapcsolat-szinkronizáció** – Kétirányú Freshdesk kapcsolat-szinkronizálás Brevo kapcsolatlistákkal
- **Jegy esemény-követés** – Jegy létrehozási, frissítési és megoldási események továbbítása a Brevóba
- **CSAT szinkronizáció** – Ügyfélelégedettségi pontszámok szinkronizálása Brevo kapcsolat-attribútumokba
- **Vállalat-szinkronizáció** – Freshdesk vállalatok leképezése Brevo kapcsolat-szegmentáláshoz
- **Ügynök adatok** – Ügynök hozzárendelések követése belső munkafolyamat-automatizáláshoz
- **Egyéni mezők** – Freshdesk egyéni jegy- és kapcsolat-mezők leképezése Brevo attribútumokhoz

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Freshdesk fiókkal adminisztrátori hozzáféréssel
2. A Freshdesk API kulcsoddal (a Profil beállításokban találod)
3. A Freshdesk domainneddel (pl. `cegednev.freshdesk.com`)
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal API hitelesítő adatokkal

## Hitelesítés

### API kulcs hitelesítés

A Freshdesk API kulcs hitelesítést használ HTTP Basic Auth-on keresztül. Az API kulcs a felhasználónévként kerül alkalmazásra bármilyen karakterlánccal (jellemzően `X`) jelszóként.

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

Vagy Base64 kódolással az Authorization fejlécben:

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

### Az API kulcs megtalálása

1. Jelentkezz be a Freshdesk fiókodba
2. Kattints a profilképedre a jobb felső sarokban
3. Menj a **Profil beállítások** menübe
4. Az API kulcsod a jobb oldalon jelenik meg

## Konfiguráció

### Alapbeállítás

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

### Kapcsolat-mezőleképezés

Képezd le a Freshdesk kapcsolat-mezőket Brevo attribútumokhoz:

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

### Jegy esemény-leképezés

Képezd le a Freshdesk jegy eseményeket Brevo automatizálási kiváltókhoz:

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

## API végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/api/v2/tickets` | Összes jegy listázása |
| `POST` | `/api/v2/tickets` | Jegy létrehozása |
| `GET` | `/api/v2/tickets/{id}` | Adott jegy lekérése |
| `PUT` | `/api/v2/tickets/{id}` | Jegy frissítése |
| `DELETE` | `/api/v2/tickets/{id}` | Jegy törlése |
| `GET` | `/api/v2/contacts` | Összes kapcsolat listázása |
| `POST` | `/api/v2/contacts` | Kapcsolat létrehozása |
| `PUT` | `/api/v2/contacts/{id}` | Kapcsolat frissítése |
| `GET` | `/api/v2/companies` | Összes vállalat listázása |
| `GET` | `/api/v2/agents` | Összes ügynök listázása |
| `GET` | `/api/v2/surveys/satisfaction_ratings` | CSAT értékelések listázása |
| `GET` | `/api/v2/search/tickets?query=` | Jegyek keresése |

## Kódpéldák

### A Freshdesk konnektor inicializálása

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

### Kapcsolatok szinkronizálása a Brevóba

```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"
// }
```

### Jegy események követése

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

### Jegyek keresése ügyfél szerint

```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();
```

## Ráta-korlátok

| Csomag | Korlát | Részletek |
| --- | --- | --- |
| **Sprout** | 50 kérés/perc | Ingyenes csomag |
| **Blossom** | 200 kérés/perc | Starter csomag |
| **Garden** | 400 kérés/perc | Growth csomag |
| **Estate** | 700 kérés/perc | Pro csomag |
| **Forest** | 1 000 kérés/perc | Enterprise csomag |

További korlátok:

| Erőforrás | Korlát |
| --- | --- |
| **Lista végpontok** | 30 oldal lekérdezésenként |
| **Oldalanként** | Max. 100 rekord |
| **Search API** | 2 kérés/mp |
| **Bulk műveletek** | 10 rekord/kérés |

Ráta-korlát fejlécek

A Freshdesk ráta-korlát információkat ad vissza a válasz fejlécekben. Figyeld az `X-RateLimit-Remaining` értéket és implementálj visszalépést a korlátok közelítésekor.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| `401 Unauthorized` | Érvénytelen API kulcs | Ellenőrizd az API kulcsot a Freshdesk Profil beállításokban |
| `403 Forbidden` | Elégtelen jogosultságok | Győződj meg róla, hogy az API kulcs adminisztrátori fiókhoz tartozik |
| Kapcsolatok nem szinkronizálódnak | Hiányzó e-mail mező | A Freshdesk kapcsolatokhoz e-mail cím szükséges |
| Jegyek nem jelennek meg | Helytelen domain | Ellenőrizd a Freshdesk domain URL-t |
| Keresés üres eredményt ad | Lekérdezési szintaxis hiba | Használd a Freshdesk keresési lekérdezési szintaxist dupla idézőjelekkel |
| `429 Too Many Requests` | Ráta-korlát túllépve | Implementálj ráta-korlátozást a csomag szintje alapján |
| Hiányzó egyéni mezők | Mező nincs engedélyezve | Győződj meg róla, hogy az egyéni mezők engedélyezve vannak a Freshdesk adminban |

## Legjobb gyakorlatok

1. **Használj webhookokat valós idejű szinkronizáláshoz** – Konfiguráld a Freshdesk Automatizálásokat webhook kiváltáshoz jegy eseményeknél
2. **Szinkronizálj CSAT pontszámokat** – Kövesd az ügyfélelégedettségi értékeléseket Brevo attribútumokként szegmentáláshoz
3. **Képezd le a jegy státuszt listákhoz** – Automatikusan mozgasd a kapcsolatokat Brevo listák között jegy státusz alapján
4. **Kövesd a támogatási mutatókat** – Szinkronizálj jegyszámot, átlagos válaszidőt és megoldási arányt kapcsolatonként
5. **Takarékosan használd a Search API-t** – A Search API szigorúbb ráta-korlátokkal rendelkezik; gyorsítótárazd az eredményeket ahol lehetséges
6. **Lapozd a nagy exportálásokat** – Használj lapozást `page` és `per_page` paraméterekkel a kezdeti szinkronizáláshoz

## Biztonság

- **API kulcs hitelesítés** – Egyszerű HTTP Basic Auth API kulccsal
- **Csak HTTPS** – Minden API kommunikáció TLS titkosítást igényel
- **IP engedélyezési lista** – Estate és Forest csomagokon elérhető
- **Szerepkör alapú hozzáférés** – API kulcs jogosultságok az ügynök szerepköréhez kötve
- **SOC 2 Type II** – A Freshdesk SOC 2 Type II minősítéssel rendelkezik
- **GDPR megfelelőség** – Adatexportálási és törlési kérések támogatása

## Kapcsolódó források

- [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Shopify konnektor](https://tajo.io/hu/docs/connectors/ecommerce/shopify)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)