---
title: "Conector Freshdesk"
description: "Ghid complet de integrare Freshdesk pentru sincronizarea tichetelor de suport, contactelor și datelor agenților cu Brevo prin Tajo."
url: https://tajo.io/ro/docs/connectors/support/freshdesk/
markdown: https://tajo.io/ro/docs/connectors/support/freshdesk.md
lang: ro-RO
robots: noindex
---

Solicită acces anticipat

Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo.

# Conector Freshdesk

Starea conectorului: Planificat Încă neconstruit. Tajo nu rulează astăzi acest conector.

| Câmp sursă | Câmp destinație | Valoare exemplu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conectați Freshdesk la Brevo prin Tajo pentru a unifica datele de suport și marketing. Sincronizați tichetele de suport ale clienților, profilurile de contact și scorurile de satisfacție pentru a alimenta comunicări țintite bazate pe interacțiunile de suport.

## Prezentare generală

| Proprietate | Valoare |
| --- | --- |
| **Platformă** | Freshdesk |
| **Categorie** | Suport |
| **Complexitate configurare** | Ușoară |
| **Integrare oficială** | Nu |
| **Date sincronizate** | Tichete, Contacte, Agenți, Companii |
| **Skilluri disponibile** | 6 |

## Funcționalități

- **Sincronizare contacte** - Sincronizare bidirecțională a contactelor Freshdesk cu listele de contacte Brevo
- **Urmărire evenimente tichete** - Redirecționați evenimentele de creare, actualizare și rezolvare a tichetelor la Brevo
- **Sincronizare CSAT** - Sincronizați scorurile de satisfacție a clienților ca atribute de contact Brevo
- **Sincronizare companii** - Mapați companiile Freshdesk la segmentarea contactelor Brevo
- **Date agenți** - Urmăriți atribuirile agenților pentru automatizarea fluxurilor de lucru interne
- **Câmpuri personalizate** - Mapați câmpurile personalizate de tichete și contacte Freshdesk la atributele Brevo

## Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont Freshdesk cu acces de administrator
2. Cheia API Freshdesk (găsită în Profile Settings)
3. Domeniul dvs. Freshdesk (ex: `companiadvs.freshdesk.com`)
4. Un cont Brevo cu acces API
5. Un cont Tajo cu credențiale API

## Autentificare

### Autentificare cu cheie API

Freshdesk utilizează autentificarea cu cheie API prin HTTP Basic Auth. Cheia API este utilizată ca nume de utilizator cu orice șir (de obicei `X`) ca parolă.

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

Sau utilizând codificarea Base64 în antetul Authorization:

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

### Găsirea cheii API

1. Autentificați-vă în contul Freshdesk
2. Faceți clic pe fotografia de profil din colțul din dreapta sus
3. Mergeți la **Profile Settings**
4. Cheia API este afișată pe partea dreaptă

## Configurare

### Configurare de bază

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

### Mapare câmpuri contact

Mapați câmpurile de contact Freshdesk la atributele 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
```

### Mapare evenimente tichete

Mapați evenimentele de tichete Freshdesk la declanșatoarele de automatizare 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"
```

## Puncte finale API

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `GET` | `/api/v2/tickets` | Listează toate tichetele |
| `POST` | `/api/v2/tickets` | Creează un tichet |
| `GET` | `/api/v2/tickets/{id}` | Obține un tichet specific |
| `PUT` | `/api/v2/tickets/{id}` | Actualizează un tichet |
| `DELETE` | `/api/v2/tickets/{id}` | Șterge un tichet |
| `GET` | `/api/v2/contacts` | Listează toate contactele |
| `POST` | `/api/v2/contacts` | Creează un contact |
| `PUT` | `/api/v2/contacts/{id}` | Actualizează un contact |
| `GET` | `/api/v2/companies` | Listează toate companiile |
| `GET` | `/api/v2/agents` | Listează toți agenții |
| `GET` | `/api/v2/surveys/satisfaction_ratings` | Listează ratingurile CSAT |
| `GET` | `/api/v2/search/tickets?query=` | Caută tichete |

## Exemple de cod

### Inițializare conector 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
});
```

### Sincronizare contacte la 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"
// }
```

### Urmărire evenimente tichete

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

### Căutare tichete după client

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

## Limite de rată

| Plan | Limită | Detalii |
| --- | --- | --- |
| **Sprout** | 50 cereri/min | Plan gratuit |
| **Blossom** | 200 cereri/min | Plan Starter |
| **Garden** | 400 cereri/min | Plan Growth |
| **Estate** | 700 cereri/min | Plan Pro |
| **Forest** | 1.000 cereri/min | Plan Enterprise |

Limite suplimentare:

| Resursă | Limită |
| --- | --- |
| **Puncte finale list** | 30 pagini per interogare |
| **Per pagină** | Max 100 înregistrări |
| **Search API** | 2 cereri/sec |
| **Operații bulk** | 10 înregistrări/cerere |

Antete limită de rată

Freshdesk returnează informații despre limitele de rată în antetele de răspuns. Monitorizați `X-RateLimit-Remaining` și implementați backoff când vă apropiați de limite.

## Depanare

| Problemă | Cauză | Soluție |
| --- | --- | --- |
| `401 Unauthorized` | Cheie API invalidă | Verificați cheia API în Freshdesk Profile Settings |
| `403 Forbidden` | Permisiuni insuficiente | Asigurați că cheia API aparține unui cont de administrator |
| Contacte nesincronizate | Câmp e-mail lipsă | Contactele Freshdesk necesită o adresă de e-mail |
| Tichete care nu apar | Domeniu greșit | Verificați că URL-ul domeniului Freshdesk este corect |
| Căutare returnând rezultate goale | Eroare sintaxă interogare | Utilizați sintaxa de interogare Freshdesk cu ghilimele duble |
| `429 Too Many Requests` | Limită de rată depășită | Implementați limitarea ratei bazată pe nivelul planului |
| Câmpuri personalizate lipsă | Câmp neactivat | Asigurați că câmpurile personalizate sunt activate în admin Freshdesk |

## Bune practici

1. **Utilizați webhook-uri pentru sincronizare în timp real** - Configurați Automatizările Freshdesk pentru a declanșa webhook-uri la evenimentele de tichete
2. **Sincronizați scorurile CSAT** - Urmăriți ratingurile de satisfacție ale clienților ca atribute Brevo pentru segmentare
3. **Mapați statusul tichetului la liste** - Mutați automat contactele între listele Brevo în funcție de statusul tichetului
4. **Urmăriți metricile de suport** - Sincronizați numărul de tichete, timpul mediu de răspuns și rata de rezolvare per contact
5. **Utilizați Search API cu moderație** - Search API are limite de rată mai stricte; memorați rezultatele în cache când este posibil
6. **Paginați exporturile mari** - Utilizați paginarea cu parametrii `page` și `per_page` pentru sincronizarea inițială

## Securitate

- **Autentificare cu cheie API** - HTTP Basic Auth simplu cu cheie API
- **Numai HTTPS** - Toate comunicațiile API necesită criptare TLS
- **IP whitelisting** - Disponibil pe planurile Estate și Forest
- **Acces bazat pe rol** - Permisiunile cheii API legate de rolul agentului
- **SOC 2 Tip II** - Freshdesk este certificat SOC 2 Tip II
- **Conformitate GDPR** - Suportă cereri de export și ștergere a datelor

## Resurse conexe

- [Conector Brevo](https://tajo.io/ro/docs/connectors/marketing/brevo)
- [Skill Sincronizare clienți](https://tajo.io/ro/docs/skills/data-sync/customer-sync)
- [Conector Shopify](https://tajo.io/ro/docs/connectors/ecommerce/shopify)
- [API Contacte Brevo](https://tajo.io/ro/docs/contact-management)