---
title: "Conector Gorgias"
description: "Ghid complet de integrare Gorgias pentru sincronizarea tichetelor de helpdesk, datelor clienților și evenimentelor de suport cu Brevo prin Tajo."
url: https://tajo.io/ro/docs/connectors/support/gorgias/
markdown: https://tajo.io/ro/docs/connectors/support/gorgias.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 Gorgias

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 helpdesk-ul Gorgias la Brevo pentru implicarea clienților bazată pe suport, fluxuri de marketing post-tichet și analize unificate ale experienței clienților prin Tajo.

## Prezentare generală

| Proprietate | Valoare |
| --- | --- |
| **Platformă** | Gorgias |
| **Categorie** | Suport |
| **Complexitate configurare** | Ușoară |
| **Integrare oficială** | Nu |
| **Date sincronizate** | Clienți, Tichete, Evenimente |
| **Tip API** | REST API |
| **Autentificare** | Cheie API + E-mail (Basic Auth) |
| **URL de bază** | `https://{domain}.gorgias.com/api/` |

## Funcționalități

- **Sincronizare evenimente tichete** - Redirecționați evenimentele de creare, rezolvare și CSAT ale tichetelor la cronologiile Brevo
- **Îmbogățire profil client** - Sincronizați datele clienților Gorgias incluzând etichete și câmpuri personalizate la Brevo
- **Campanii post-suport** - Declanșați fluxurile de lucru Brevo după rezolvarea tichetelor pentru follow-up sau upsell
- **Urmărire satisfacție** - Sincronizați rezultatele sondajelor CSAT ca atribute de contact Brevo
- **Segmentare bazată pe etichete** - Oglindiți etichetele clienților Gorgias ca apartenența la listele Brevo
- **Evenimente macro și reguli** - Urmăriți acțiunile automatizate pentru analize operaționale

## Cerințe preliminare

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

1. Un cont Gorgias cu acces de administrator
2. Subdomeniul Gorgias (ex: `magazin.gorgias.com`)
3. O cheie API și adresa de e-mail asociată
4. Un cont Brevo cu acces API
5. Un cont Tajo cu abonament activ

## Autentificare

Gorgias utilizează HTTP Basic Authentication cu e-mailul contului și cheia API.

### Creare cheie API

1. Autentificați-vă în tabloul de bord Gorgias
2. Navigați la **Settings** > **REST API**
3. Faceți clic pe **Create API Key** (sau copiați cheia existentă)
4. Notați URL-ul de bază API: `https://{domain}.gorgias.com/api/`

```bash
# Basic Auth: email as username, API key as password
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "admin@yourstore.com:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"
```

Permisiuni cheie API

Cheile API Gorgias au acces complet la datele contului. Nu există un model de permisiuni bazat pe scope. Protejați cheia API și rotiți-o regulat.

### Conectare la Tajo

```bash
tajo connectors install gorgias \
  --domain yourstore.gorgias.com \
  --email admin@yourstore.com \
  --api-key $GORGIAS_API_KEY
```

## Configurare

### Configurare de bază

```yaml
connectors:
  gorgias:
    enabled: true
    domain: "yourstore.gorgias.com"

    sync:
      customers: true
      tickets: true
      satisfaction_surveys: true
      tags: true

    lists:
      all_support_contacts: 35
      satisfied_customers: 36
      dissatisfied_customers: 37
```

### Mapare câmpuri

Mapați câmpurile de clienți și tichete Gorgias la atributele de contact Brevo:

```yaml
field_mapping:
  # Customer fields
  id: GORGIAS_ID
  email: email
  name: FIRSTNAME
  phone: SMS

  # Support metrics
  nb_tickets: TICKET_COUNT
  last_ticket_date: LAST_SUPPORT_DATE
  last_ticket_channel: LAST_SUPPORT_CHANNEL
  avg_response_time: AVG_RESPONSE_TIME

  # CSAT data
  last_satisfaction_score: CSAT_SCORE
  satisfaction_count: CSAT_RESPONSES

  # Custom fields
  customer_type: CUSTOMER_TYPE
  vip_status: VIP_STATUS
```

### Mapare evenimente

```yaml
event_mapping:
  ticket.created: SUPPORT_TICKET_OPENED
  ticket.closed: SUPPORT_TICKET_RESOLVED
  ticket.reopened: SUPPORT_TICKET_REOPENED
  satisfaction_survey.created: CSAT_SURVEY_SENT
  satisfaction_survey.responded: CSAT_SUBMITTED
  customer.created: SUPPORT_CUSTOMER_CREATED
```

## Puncte finale API

Tajo se integrează cu următoarele puncte finale REST API Gorgias:

| Punct final | Metodă | Scop |
| --- | --- | --- |
| `/api/customers` | GET | Listează clienții |
| `/api/customers/{id}` | GET | Recuperează un client |
| `/api/customers` | POST | Creează un client |
| `/api/customers/{id}` | PUT | Actualizează un client |
| `/api/tickets` | GET | Listează tichetele |
| `/api/tickets/{id}` | GET | Recuperează un tichet |
| `/api/tickets/{id}/messages` | GET | Listează mesajele tichetului |
| `/api/tags` | GET | Listează etichetele |
| `/api/satisfaction-surveys` | GET | Listează sondajele CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Recuperează un sondaj |
| `/api/users` | GET | Listează agenții |
| `/api/integrations` | GET | Listează integrările |
| `/api/events` | GET | Listează evenimentele |
| `/api/customers/{id}/custom-fields` | GET | Obține valorile câmpurilor personalizate |

## Exemple de cod

### Inițializare conector

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

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

await tajo.connectors.connect('gorgias', {
  domain: 'yourstore.gorgias.com',
  email: 'admin@yourstore.com',
  apiKey: process.env.GORGIAS_API_KEY
});
```

### Sincronizare clienți la Brevo

```javascript
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['customers'],
  since: '2024-01-01',
  batchSize: 30
});

const status = await tajo.connectors.status('gorgias');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T17:00:00Z',
//   customersCount: 14200,
//   ticketsTracked: 28600,
//   csatResponses: 3400
// }
```

### Gestionare evenimente tichete prin integrare HTTP

```javascript
// Gorgias can send HTTP requests via Rules or HTTP integrations
app.post('/webhooks/gorgias', async (req, res) => {
  const event = req.body;

  await tajo.connectors.handleEvent('gorgias', {
    type: 'ticket.updated',
    payload: {
      ticketId: event.ticket_id,
      status: event.status,
      customerEmail: event.customer?.email,
      channel: event.channel,
      tags: event.tags,
      satisfaction: event.satisfaction
    }
  });

  res.status(200).send('OK');
});
```

### Campanie post-rezolvare

```javascript
// Trigger a follow-up email after a support ticket is resolved
tajo.connectors.on('gorgias', 'ticket.closed', async (event) => {
  if (event.satisfaction_score >= 4) {
    await tajo.campaigns.trigger('post-support-upsell', {
      email: event.customer.email,
      params: {
        agent_name: event.assignee.name,
        ticket_subject: event.subject,
        resolution_time: event.resolution_time
      }
    });
  }
});
```

### Sincronizare date CSAT

```javascript
// Sync satisfaction survey results to Brevo attributes
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## Limite de rată

Gorgias aplică limite de rată per cont:

| Tip limită | Valoare |
| --- | --- |
| **Limită de rată API** | 2 cereri pe secundă |
| **Alocație burst** | Până la 5 cereri în burst-uri scurte |
| **Paginare** | 30 articole per pagină (implicit), max 100 |

Strategie de paginare

Gorgias utilizează paginarea bazată pe cursor cu parametrii `cursor` și `limit`. Tajo gestionează aceasta automat, solicitând până la 100 de articole per pagină pentru eficiență maximă.

Gorgias returnează `429 Too Many Requests` când limitele de rată sunt depășite.

## Depanare

### Probleme frecvente

| Problemă | Cauză | Soluție |
| --- | --- | --- |
| 401 Neautorizat | E-mail sau cheie API invalidă | Verificați credențialele în Gorgias Settings > REST API |
| 404 Negăsit | Punct final sau ID resursă invalid | Verificați că URL-ul de bază API include subdomeniul dvs. |
| Clienți lipsă | Fără e-mail în evidență | Gorgias necesită e-mail pentru potrivirea clienților |
| Etichete nesincronizate | Etichete neatribuite clienților | Verificați că etichetele sunt pe obiectele client, nu doar pe tichete |
| Sincronizare lentă | Limită de rată scăzută | Gorgias limitează la 2 cereri/s; sincronizările complete durează mai mult |

### Modul de depanare

```yaml
connectors:
  gorgias:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### Testare conexiune

```bash
tajo connectors test gorgias
# ✓ API authentication successful
# ✓ Customer list accessible
# ✓ Ticket data readable
# ✓ CSAT surveys available
# ✓ Tags listable
```

## Bune practici

1. **Utilizați integrările HTTP pentru timp real** - Configurați Regulile Gorgias pentru a trimite cereri HTTP la Tajo la evenimentele de tichete
2. **Sincronizați datele CSAT regulat** - Utilizați scorurile de satisfacție pentru a conduce campaniile de re-implicare
3. **Mapați etichetele la segmente** - Traduceți etichetele clienților Gorgias în apartenența la listele Brevo
4. **Gestionați paginarea cu atenție** - Cu limite de 2 cereri/s, planificați pentru timpi de sincronizare mai lungi pe seturi mari de date
5. **Legați cu datele e-commerce** - Combinați datele de suport Gorgias cu datele comenzilor Shopify în Brevo
6. **Rotiți cheile API** - Deoarece cheile Gorgias au acces complet, rotiți-le periodic

## Securitate

- **Basic Auth** - E-mail și cheie API prin HTTPS
- **Numai HTTPS** - Toate comunicațiile API criptate prin TLS 1.2+
- **Chei cu acces complet** - Fără scope granular (protejați cheile cu atenție)
- **IP Allowlisting** - Disponibil pe planurile superioare Gorgias
- **Stocare criptată** - Credențiale API criptate în repaus în Tajo
- **Conformitate SOC 2** - Platforma Gorgias este certificată SOC 2 Tip II

## Resurse conexe

- [Conector Twilio Flex](https://tajo.io/ro/docs/connectors/custom/twilio-flex)
- [Conector Jira](https://tajo.io/ro/docs/connectors/custom/jira)
- [Conector Shopify](https://tajo.io/ro/docs/connectors/ecommerce/shopify)
- [API Contacte Brevo](https://tajo.io/ro/docs/contact-management)