---
title: "Gorgias konektor"
description: "Kompletný sprievodca integráciou Gorgias na synchronizáciu helpdesk ticketov, zákazníckych dát a podporných udalostí s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/support/gorgias/
markdown: https://tajo.io/sk/docs/connectors/support/gorgias.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Gorgias konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoj helpdesk Gorgias s Brevo pre zákaznícke zapojenie riadené podporou, marketingové toky po uzavretí ticketov a zjednotenú analytiku zákazníckej skúsenosti cez Tajo.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Gorgias |
| **Kategória** | Podpora |
| **Zložitosť nastavenia** | Ľahké |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Zákazníci, Tickety, Udalosti |
| **Typ API** | REST API |
| **Autentifikácia** | API kľúč + E-mail (Basic Auth) |
| **Base URL** | `https://{domain}.gorgias.com/api/` |

## Funkcie

- **Synchronizácia udalostí ticketov** - Preposielaj udalosti vytvorenia, riešenia ticketov a CSAT do časových línií Brevo
- **Obohacovanie profilu zákazníka** - Synchronizuj zákaznícke dáta Gorgias vrátane tagov a vlastných polí do Brevo
- **Kampane po podpore** - Spúšťaj workflowy Brevo po vyriešení ticketu pre follow-up alebo upsell
- **Sledovanie spokojnosti** - Synchronizuj výsledky prieskumov CSAT ako atribúty kontaktov Brevo
- **Segmentácia na základe tagov** - Zrkadlí tagy zákazníkov Gorgias ako členstvá v zoznamoch Brevo
- **Udalosti makier a pravidiel** - Sleduj automatizované akcie pre prevádzkovú analytiku

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Gorgias účet s prístupom administrátora
2. Subdoménu Gorgias (napr. `yourstore.gorgias.com`)
3. API kľúč a pridruženú e-mailovú adresu
4. Brevo účet s API prístupom
5. Tajo účet s aktívnym predplatným

## Autentifikácia

Gorgias používa HTTP Basic Authentication s e-mailom účtu a API kľúčom.

### Vytvorenie API kľúča

1. Prihlás sa do svojho Gorgias dashboardu
2. Prejdi do **Settings** > **REST API**
3. Klikni na **Create API Key** (alebo skopíruj existujúci kľúč)
4. Poznač si základnú URL 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"
```

Oprávnenia API kľúča

API kľúče Gorgias majú plný prístup k dátam tvojho účtu. Neexistuje model oprávnení na základe scopov. Chráň svoj API kľúč a pravidelne ho rotuj.

### Pripojenie k Tajo

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

## Konfigurácia

### Základné nastavenie

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

### Mapovanie polí

Namapuj polia zákazníkov a ticketov Gorgias na atribúty kontaktov 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
```

### Mapovanie udalostí

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

## API endpointy

Tajo sa integruje s nasledujúcimi REST API endpointmi Gorgias:

| Endpoint | Metóda | Účel |
| --- | --- | --- |
| `/api/customers` | GET | Zoznam zákazníkov |
| `/api/customers/{id}` | GET | Načítanie zákazníka |
| `/api/customers` | POST | Vytvorenie zákazníka |
| `/api/customers/{id}` | PUT | Aktualizácia zákazníka |
| `/api/tickets` | GET | Zoznam ticketov |
| `/api/tickets/{id}` | GET | Načítanie ticketu |
| `/api/tickets/{id}/messages` | GET | Zoznam správ ticketu |
| `/api/tags` | GET | Zoznam tagov |
| `/api/satisfaction-surveys` | GET | Zoznam prieskumov CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Načítanie prieskumu |
| `/api/users` | GET | Zoznam agentov |
| `/api/integrations` | GET | Zoznam integrácií |
| `/api/events` | GET | Zoznam udalostí |
| `/api/customers/{id}/custom-fields` | GET | Získanie hodnôt vlastných polí |

## Ukážky kódu

### Inicializácia konektora

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

### Synchronizácia zákazníkov do 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
// }
```

### Spracovanie udalostí ticketov cez HTTP integráciu

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

### Kampaň po vyriešení

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

### Synchronizácia dát CSAT

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

## Obmedzenia rýchlosti

Gorgias presadzuje limity rýchlosti na účet:

| Typ limitu | Hodnota |
| --- | --- |
| **Limit rýchlosti API** | 2 požiadavky za sekundu |
| **Burst tolerancia** | Až 5 požiadaviek v krátkych intervaloch |
| **Stránkovanie** | 30 položiek na stranu (predvolené), max 100 |

Stratégia stránkovania

Gorgias používa stránkovanie na základe kurzora s parametrami `cursor` a `limit`. Tajo to spracováva automaticky, požadujúc až 100 položiek na stranu pre maximálnu efektivitu.

Gorgias vracia `429 Too Many Requests` pri prekročení limitov rýchlosti.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 401 Unauthorized | Neplatný e-mail alebo API kľúč | Overte prihlasovací údaje v Gorgias Settings > REST API |
| 404 Not Found | Neplatný endpoint alebo ID zdroja | Skontroluj, že základná URL API obsahuje tvoju subdoménu |
| Chýbajúci zákazníci | Žiadny e-mail na zázname | Gorgias vyžaduje e-mail pre zhodu zákazníkov |
| Tagy sa nesynchronizujú | Tagy nie sú priradené zákazníkom | Overte, že tagy sú na objektoch zákazníkov, nie len na ticketoch |
| Pomalá synchronizácia | Nízky limit rýchlosti | Gorgias obmedzuje na 2 požiadavky/sek; plné synchronizácie trvajú dlhšie |

### Debug režim

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

### Test pripojenia

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

## Odporúčané postupy

1. **Použi HTTP integrácie pre reálny čas** - Nakonfiguruj pravidlá Gorgias na odosielanie HTTP požiadaviek do Tajo pri udalostiach ticketov
2. **Pravidelne synchronizuj dáta CSAT** - Použi skóre spokojnosti na riadenie kampaní opätovného zapojenia
3. **Mapuj tagy na segmenty** - Prekladaj tagy zákazníkov Gorgias do členství v zoznamoch Brevo
4. **Starostlivo spracovávaj stránkovanie** - S limitmi 2 požiadavky/sek plánuj dlhšie časy synchronizácie na veľkých datasetoch
5. **Prepoj s e-commerce dátami** - Kombinuj podporné dáta Gorgias s dátami objednávok Shopify v Brevo
6. **Rotuj API kľúče** - Keďže kľúče Gorgias majú plný prístup, rotuj ich pravidelne

## Bezpečnosť

- **Basic Auth** - E-mail a API kľúč cez HTTPS
- **Iba HTTPS** - Všetka API komunikácia šifrovaná cez TLS 1.2+
- **Kľúče s plným prístupom** - Bez granulárnych scopov (chráň kľúče starostlivo)
- **IP Allowlisting** - Dostupné na vyšších plánoch Gorgias
- **Šifrované úložisko** - API prihlasovací údaje šifrované v pokoji v Tajo
- **SOC 2 súlad** - Platforma Gorgias je certifikovaná podľa SOC 2 Type II

## Súvisiace zdroje

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