---
title: "Freshdesk Konektor"
description: "Kompletan vodič za integraciju Freshdeska za sinkronizaciju zahtjeva za podršku, kontakata i podataka o agentima s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/support/freshdesk/
markdown: https://tajo.io/hr/docs/connectors/support/freshdesk.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Freshdesk Konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite Freshdesk s Brevom putem Taja kako biste ujedinili podatke o podršci i marketingu. Sinkronizirajte zahtjeve za podršku, profile kontakata i ocjene zadovoljstva za pokretanje ciljane komunikacije na temelju interakcija podrške.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Freshdesk |
| **Kategorija** | Podrška |
| **Složenost postavljanja** | Jednostavno |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Zahtjevi, Kontakti, Agenti, Tvrtke |
| **Dostupne vještine** | 6 |

## Značajke

- **Sinkronizacija kontakata** - Dvosmjerna sinkronizacija Freshdesk kontakata na Brevo popise kontakata
- **Praćenje događaja zahtjeva** - Prosljeđivanje događaja kreiranja, ažuriranja i rješavanja zahtjeva u Brevo
- **Sinkronizacija CSAT-a** - Sinkronizacija ocjena zadovoljstva kupaca kao Brevo atributa kontakata
- **Sinkronizacija tvrtki** - Mapiranje Freshdesk tvrtki na Brevo segmentaciju kontakata
- **Podaci agenta** - Praćenje dodjela agenta za internu automatizaciju tijeka rada
- **Prilagođena polja** - Mapiranje Freshdesk prilagođenih polja zahtjeva i kontakata na Brevo atribute

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Freshdesk račun s administratorskim pristupom
2. Vaš Freshdesk API ključ (pronađen u Postavkama profila)
3. Vašu Freshdesk domenu (npr. `yourcompany.freshdesk.com`)
4. Brevo račun s API pristupom
5. Tajo račun s API vjerodajnicama

## Autentifikacija

### Autentifikacija API ključem

Freshdesk koristi autentifikaciju API ključem putem HTTP Basic Auth. API ključ se koristi kao korisničko ime s bilo kojim nizom (obično `X`) kao lozinkom.

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

Ili koristeći Base64 kodiranje u zaglavlju Authorization:

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

### Pronalaženje vašeg API ključa

1. Prijavite se na vaš Freshdesk račun
2. Kliknite na vašu profilnu sliku u gornjem desnom kutu
3. Idite na **Postavke profila**
4. Vaš API ključ prikazan je na desnoj strani

## Konfiguracija

### Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      contacts: true
      tickets: true
      companies: true
      satisfaction_ratings: true

    # Dodjela Brevo popisa
    lists:
      all_support_contacts: 30
      open_tickets: 31
      resolved_tickets: 32
```

### Mapiranje polja kontakata

Mapirajte polja Freshdesk kontakata na Brevo atribute:

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

  # Metrike podrške
  total_tickets: TICKET_COUNT
  open_tickets: OPEN_TICKETS
  avg_csat: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # Prilagođena polja
  custom_fields.account_type: ACCOUNT_TYPE
  custom_fields.subscription_tier: PLAN
```

### Mapiranje događaja zahtjeva

Mapirajte Freshdesk događaje zahtjeva na okidače automatizacije Breva:

```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 krajnje točke

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/api/v2/tickets` | Popis svih zahtjeva |
| `POST` | `/api/v2/tickets` | Kreiraj zahtjev |
| `GET` | `/api/v2/tickets/{id}` | Dohvati određeni zahtjev |
| `PUT` | `/api/v2/tickets/{id}` | Ažuriraj zahtjev |
| `DELETE` | `/api/v2/tickets/{id}` | Izbriši zahtjev |
| `GET` | `/api/v2/contacts` | Popis svih kontakata |
| `POST` | `/api/v2/contacts` | Kreiraj kontakt |
| `PUT` | `/api/v2/contacts/{id}` | Ažuriraj kontakt |
| `GET` | `/api/v2/companies` | Popis svih tvrtki |
| `GET` | `/api/v2/agents` | Popis svih agenata |
| `GET` | `/api/v2/surveys/satisfaction_ratings` | Popis CSAT ocjena |
| `GET` | `/api/v2/search/tickets?query=` | Pretraži zahtjeve |

## Primjeri koda

### Inicijalizacija Freshdesk konektora

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

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

// Povežite Freshdesk račun
await tajo.connectors.connect('freshdesk', {
  domain: 'yourcompany.freshdesk.com',
  apiKey: process.env.FRESHDESK_API_KEY
});
```

### Sinkronizacija kontakata u Brevo

```javascript
// Dohvatite Freshdesk kontakte i sinkronizirajte u 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();
// Svaki kontakt:
// {
//   "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"
// }
```

### Praćenje događaja zahtjeva

```javascript
// Postavite Freshdesk webhook za prosljeđivanje događaja zahtjeva
// Konfigurirajte u Freshdesk Administracija > Automatizacije > Webhook

// Handler za webhookove
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');
});
```

### Pretraživanje zahtjeva po kupcu

```javascript
// Pretraži sve zahtjeve od određenog kupca
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();
```

## Ograničenja brzine

| Plan | Ograničenje | Detalji |
| --- | --- | --- |
| **Sprout** | 50 zahtjeva/min | Besplatni plan |
| **Blossom** | 200 zahtjeva/min | Starter plan |
| **Garden** | 400 zahtjeva/min | Growth plan |
| **Estate** | 700 zahtjeva/min | Pro plan |
| **Forest** | 1.000 zahtjeva/min | Enterprise plan |

Dodatna ograničenja:

| Resurs | Ograničenje |
| --- | --- |
| **Krajnje točke za popise** | 30 stranica po upitu |
| **Po stranici** | Maks. 100 zapisa |
| **Search API** | 2 zahtjeva/sek |
| **Skupne operacije** | 10 zapisa/zahtjev |

Zaglavlja ograničenja brzine

Freshdesk vraća informacije o ograničenju brzine u zaglavljima odgovora. Pratite `X-RateLimit-Remaining` i implementirajte povratak kada se približavate ograničenjima.

## Rješavanje problema

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| `401 Unauthorized` | Nevažeći API ključ | Verificirajte API ključ u Freshdesk Postavkama profila |
| `403 Forbidden` | Nedovoljne dozvole | Osigurajte da API ključ pripada administratorskom računu |
| Kontakti se ne sinkroniziraju | Nedostaje polje e-maila | Freshdesk kontakti zahtijevaju e-mail adresu |
| Zahtjevi se ne pojavljuju | Pogrešna domena | Verificirajte da je URL vaše Freshdesk domene ispravan |
| Pretraživanje vraća prazno | Greška sintakse upita | Koristite Freshdesk sintaksu upita za pretraživanje s dvostrukim navodnicima |
| `429 Too Many Requests` | Premašeno ograničenje brzine | Implementirajte ograničenje brzine na temelju razine plana |
| Nedostaju prilagođena polja | Polje nije omogućeno | Osigurajte da su prilagođena polja omogućena u Freshdesk administraciji |

## Preporučene prakse

1. **Koristite webhookove za sinkronizaciju u stvarnom vremenu** - Konfigurirajte Freshdesk automatizacije za pokretanje webhookova na događajima zahtjeva
2. **Sinkronizirajte CSAT ocjene** - Pratite ocjene zadovoljstva kupaca kao Brevo atribute za segmentaciju
3. **Mapirajte status zahtjeva na popise** - Automatski premještajte kontakte između Brevo popisa na temelju statusa zahtjeva
4. **Pratite metrike podrške** - Sinkronizirajte broj zahtjeva, prosječno vrijeme odgovora i stopu rješavanja po kontaktu
5. **Štedljivo koristite Search API** - Search API ima strožija ograničenja brzine; predmemorirajte rezultate kada je moguće
6. **Paginirajte velike izvoze** - Koristite paginaciju s parametrima `page` i `per_page` za početnu sinkronizaciju

## Sigurnost

- **Autentifikacija API ključem** - Jednostavna HTTP Basic Auth s API ključem
- **Samo HTTPS** - Sva API komunikacija zahtijeva TLS šifriranje
- **Lista dopuštenih IP-ova** - Dostupno na Estate i Forest planovima
- **Pristup temeljen na ulogama** - Dozvole API ključa vezane uz ulogu agenta
- **SOC 2 Type II** - Freshdesk je SOC 2 Type II certificiran
- **GDPR usklađenost** - Podržava zahtjeve za izvoz i brisanje podataka

## Povezani resursi

- [Brevo Konektor](https://tajo.io/hr/docs/connectors/marketing/brevo)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)
- [Shopify Konektor](https://tajo.io/hr/docs/connectors/ecommerce/shopify)
- [Brevo API kontakata](https://tajo.io/hr/docs/contact-management)