---
title: "Gorgias Konektor"
description: "Kompletan vodič za integraciju Gorgiasa za sinkronizaciju zahtjeva help deska, korisničkih podataka i događaja podrške s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/support/gorgias/
markdown: https://tajo.io/hr/docs/connectors/support/gorgias.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.

# Gorgias 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 vaš Gorgias help desk s Brevom za angažman korisnika vođen podrškom, marketinške tokove rada nakon zahtjeva i ujedinjenu analitiku korisničkog iskustva putem Taja.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Gorgias |
| **Kategorija** | Podrška |
| **Složenost postavljanja** | Jednostavno |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Kupci, Zahtjevi, Događaji |
| **Vrsta API-ja** | REST API |
| **Autentifikacija** | API ključ + e-mail (Basic Auth) |
| **Osnovni URL** | `https://{domain}.gorgias.com/api/` |

## Značajke

- **Sinkronizacija događaja zahtjeva** - Prosljeđivanje događaja kreiranja, rješavanja i CSAT zahtjeva na Brevo vremenske osi
- **Obogaćivanje profila kupaca** - Sinkronizacija Gorgias podataka o kupcima uključujući oznake i prilagođena polja u Brevo
- **Kampanje nakon podrške** - Pokretanje Brevo tijekova rada nakon rješavanja zahtjeva za praćenje ili upsell
- **Praćenje zadovoljstva** - Sinkronizacija rezultata CSAT anketa kao Brevo atributa kontakata
- **Segmentacija temeljena na oznakama** - Zrcaljenje oznaka Gorgias kupaca kao Brevo članstava na popisu
- **Događaji makroa i pravila** - Praćenje automatiziranih radnji za operativnu analitiku

## Preduvjeti

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

1. Gorgias račun s administratorskim pristupom
2. Vašu Gorgias poddomenu (npr. `yourstore.gorgias.com`)
3. API ključ i povezanu e-mail adresu
4. Brevo račun s API pristupom
5. Tajo račun s aktivnom pretplatom

## Autentifikacija

Gorgias koristi HTTP Basic autentifikaciju s e-mailom vašeg računa i API ključem.

### Kreiranje API ključa

1. Prijavite se na vaš Gorgias dashboard
2. Navigirajte do **Postavke** > **REST API**
3. Kliknite **Kreiraj API ključ** (ili kopirajte postojeći ključ)
4. Zabilježite vaš osnovni URL API-ja: `https://{domain}.gorgias.com/api/`

```bash
# Basic Auth: e-mail kao korisničko ime, API ključ kao lozinka
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "admin@yourstore.com:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"
```

Dozvole API ključa

Gorgias API ključevi imaju puni pristup podacima vašeg računa. Ne postoji model dozvola temeljen na opsegu. Zaštitite vaš API ključ i redovito ga rotirajte.

### Povezivanje s Tajom

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

## Konfiguracija

### Osnovna konfiguracija

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

### Mapiranje polja

Mapirajte Gorgias polja kupaca i zahtjeva na Brevo atribute kontakata:

```yaml
field_mapping:
  # Polja kupca
  id: GORGIAS_ID
  email: email
  name: FIRSTNAME
  phone: SMS

  # Metrike podrške
  nb_tickets: TICKET_COUNT
  last_ticket_date: LAST_SUPPORT_DATE
  last_ticket_channel: LAST_SUPPORT_CHANNEL
  avg_response_time: AVG_RESPONSE_TIME

  # CSAT podaci
  last_satisfaction_score: CSAT_SCORE
  satisfaction_count: CSAT_RESPONSES

  # Prilagođena polja
  customer_type: CUSTOMER_TYPE
  vip_status: VIP_STATUS
```

### Mapiranje događaja

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

Tajo se integrira s sljedećim Gorgias REST API krajnjim točkama:

| Krajnja točka | Metoda | Namjena |
| --- | --- | --- |
| `/api/customers` | GET | Popis kupaca |
| `/api/customers/{id}` | GET | Dohvati kupca |
| `/api/customers` | POST | Kreiraj kupca |
| `/api/customers/{id}` | PUT | Ažuriraj kupca |
| `/api/tickets` | GET | Popis zahtjeva |
| `/api/tickets/{id}` | GET | Dohvati zahtjev |
| `/api/tickets/{id}/messages` | GET | Popis poruka zahtjeva |
| `/api/tags` | GET | Popis oznaka |
| `/api/satisfaction-surveys` | GET | Popis CSAT anketa |
| `/api/satisfaction-surveys/{id}` | GET | Dohvati anketu |
| `/api/users` | GET | Popis agenata |
| `/api/integrations` | GET | Popis integracija |
| `/api/events` | GET | Popis događaja |
| `/api/customers/{id}/custom-fields` | GET | Dohvati vrijednosti prilagođenih polja |

## Primjeri koda

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

### Sinkronizacija kupaca u 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
// }
```

### Rukovanje događajima zahtjeva putem HTTP integracije

```javascript
// Gorgias može slati HTTP zahtjeve putem Pravila ili HTTP integracija
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');
});
```

### Kampanja nakon rješavanja

```javascript
// Pokrenite follow-up e-mail nakon rješavanja zahtjeva podrške
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
      }
    });
  }
});
```

### Sinkronizacija CSAT podataka

```javascript
// Sinkronizacija rezultata anketa zadovoljstva na Brevo atribute
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## Ograničenja brzine

Gorgias primjenjuje ograničenja brzine po računu:

| Vrsta ograničenja | Vrijednost |
| --- | --- |
| **Ograničenje brzine API-ja** | 2 zahtjeva u sekundi |
| **Burst dopuštanje** | Do 5 zahtjeva u kratkim naletima |
| **Paginacija** | 30 stavki po stranici (zadano), maks. 100 |

Strategija paginacije

Gorgias koristi paginaciju temeljenu na pokazivaču s parametrima `cursor` i `limit`. Tajo ovo rukuje automatski, zahtijevajući do 100 stavki po stranici za maksimalnu učinkovitost.

Gorgias vraća `429 Too Many Requests` kada su ograničenja brzine premašena.

## Rješavanje problema

### Uobičajeni problemi

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| 401 Unauthorized | Nevažeći e-mail ili API ključ | Verificirajte vjerodajnice u Gorgias Postavkama > REST API |
| 404 Not Found | Nevažeća krajnja točka ili ID resursa | Provjerite da osnovni URL API-ja uključuje vašu poddomenu |
| Nedostaju kupci | Nema e-maila u zapisu | Gorgias zahtijeva e-mail za podudaranje kupaca |
| Oznake se ne sinkroniziraju | Oznake nisu dodijeljene kupcima | Verificirajte da su oznake na objektima kupaca, a ne samo na zahtjevima |
| Spora sinkronizacija | Nisko ograničenje brzine | Gorgias ograničava na 2 zah./s; pune sinkronizacije traju dulje |

### Način otklanjanja grešaka

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

### Testiranje veze

```bash
tajo connectors test gorgias
# ✓ API autentifikacija uspješna
# ✓ Popis kupaca dostupan
# ✓ Podaci o zahtjevima čitljivi
# ✓ CSAT ankete dostupne
# ✓ Oznake u popisu
```

## Preporučene prakse

1. **Koristite HTTP integracije za stvarno vrijeme** - Konfigurirajte Gorgias pravila za slanje HTTP zahtjeva Taju na događajima zahtjeva
2. **Redovito sinkronizirajte CSAT podatke** - Koristite ocjene zadovoljstva za pokretanje kampanja ponovnog angažmana
3. **Mapirajte oznake na segmente** - Prevedite oznake Gorgias kupaca u Brevo članstva na popisu
4. **Pažljivo rukujte paginacijom** - S ograničenjima od 2 zah./s, planirajte za dulje sinkronizacije na velikim skupovima podataka
5. **Povežite s e-commerce podacima** - Kombinirajte Gorgias podatke podrške s Shopify podacima narudžbi u Brevo
6. **Rotirajte API ključeve** - Budući da Gorgias ključevi imaju puni pristup, periodično ih rotirajte

## Sigurnost

- **Basic Auth** - E-mail i API ključ putem HTTPS-a
- **Samo HTTPS** - Sva API komunikacija šifrirana putem TLS 1.2+
- **Ključevi s punim pristupom** - Bez granularnog opsežavanja (pažljivo zaštitite ključeve)
- **Lista dopuštenih IP-ova** - Dostupno na višim Gorgias planovima
- **Šifrirano pohranjivanje** - API vjerodajnice šifrirane u mirovanju u Taju
- **SOC 2 usklađenost** - Gorgias platforma je SOC 2 Type II certificirana

## Povezani resursi

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