---
title: "Konektor Gorgias"
description: "Kompletny przewodnik integracji Gorgias do synchronizacji zgłoszeń helpdesk, danych klientów i zdarzeń wsparcia z Brevo przez Tajo."
url: https://tajo.io/pl/docs/connectors/support/gorgias/
markdown: https://tajo.io/pl/docs/connectors/support/gorgias.md
lang: pl-PL
robots: noindex
---

Poproś o wcześniejszy dostęp

Podaj imię i firmowy adres e-mail. Wyślemy Ci link potwierdzający prośbę o dostęp do Tajo.

# Konektor Gorgias

Status konektora: Planowany Jeszcze niezbudowany. Tajo nie uruchamia dziś tego konektora.

| Pole źródłowe | Pole docelowe | Przykładowa wartość |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Połącz swój helpdesk Gorgias z Brevo dla zaangażowania klientów opartego na wsparciu, przepływów marketingowych po zgłoszeniu i ujednoliconej analityki doświadczeń klientów przez Tajo.

## Przegląd

| Właściwość | Wartość |
| --- | --- |
| **Platforma** | Gorgias |
| **Kategoria** | Support |
| **Poziom konfiguracji** | Łatwy |
| **Integracja oficjalna** | Nie |
| **Synchronizowane dane** | Klienci, Zgłoszenia, Zdarzenia |
| **Typ API** | REST API |
| **Uwierzytelnianie** | Klucz API + E-mail (Basic Auth) |
| **Bazowy URL** | `https://{domain}.gorgias.com/api/` |

## Funkcje

- **Synchronizacja zdarzeń zgłoszeń** - Przekazuj zdarzenia tworzenia, rozwiązywania i CSAT zgłoszeń do osi czasu Brevo
- **Wzbogacanie profili klientów** - Synchronizuj dane klientów Gorgias, w tym tagi i niestandardowe pola, do Brevo
- **Kampanie po wsparciu** - Wyzwalaj workflow Brevo po rozwiązaniu zgłoszenia dla follow-upu lub upsellingu
- **Śledzenie satysfakcji** - Synchronizuj wyniki ankiet CSAT jako atrybuty kontaktów Brevo
- **Segmentacja oparta na tagach** - Dubluj tagi klientów Gorgias jako przynależność do list Brevo
- **Zdarzenia makr i reguł** - Śledź zautomatyzowane działania dla operacyjnej analityki

## Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

1. Konto Gorgias z dostępem administratora
2. Subdomenę Gorgias (np. `twojsklep.gorgias.com`)
3. Klucz API i powiązany adres e-mail
4. Konto Brevo z dostępem do API
5. Konto Tajo z aktywną subskrypcją

## Uwierzytelnianie

Gorgias używa HTTP Basic Authentication z Twoim e-mailem konta i kluczem API.

### Tworzenie klucza API

1. Zaloguj się do dashboardu Gorgias
2. Przejdź do **Settings** > **REST API**
3. Kliknij **Create API Key** (lub skopiuj istniejący klucz)
4. Zanotuj bazowy 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"
```

Uprawnienia klucza API

Klucze API Gorgias mają pełny dostęp do danych Twojego konta. Nie ma modelu uprawnień opartego na zakresach. Chroń swój klucz API i regularnie go rotuj.

### Połączenie z Tajo

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

## Konfiguracja

### Podstawowa konfiguracja

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

### Mapowanie pól

Mapuj pola klientów i zgłoszeń Gorgias na atrybuty kontaktów 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
```

### Mapowanie zdarzeń

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

## Endpointy API

Tajo integruje się z następującymi endpointami REST API Gorgias:

| Endpoint | Metoda | Przeznaczenie |
| --- | --- | --- |
| `/api/customers` | GET | Lista klientów |
| `/api/customers/{id}` | GET | Pobierz klienta |
| `/api/customers` | POST | Utwórz klienta |
| `/api/customers/{id}` | PUT | Zaktualizuj klienta |
| `/api/tickets` | GET | Lista zgłoszeń |
| `/api/tickets/{id}` | GET | Pobierz zgłoszenie |
| `/api/tickets/{id}/messages` | GET | Lista wiadomości zgłoszenia |
| `/api/tags` | GET | Lista tagów |
| `/api/satisfaction-surveys` | GET | Lista ankiet CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Pobierz ankietę |
| `/api/users` | GET | Lista agentów |
| `/api/integrations` | GET | Lista integracji |
| `/api/events` | GET | Lista zdarzeń |
| `/api/customers/{id}/custom-fields` | GET | Pobierz wartości niestandardowych pól |

## Przykłady kodu

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

### Synchronizuj klientów 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
// }
```

### Obsługa zdarzeń zgłoszeń przez integrację 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');
});
```

### Kampania po rozwiązaniu zgłoszenia

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

### Synchronizuj dane CSAT

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

## Limity API

Gorgias egzekwuje limity szybkości na konto:

| Typ limitu | Wartość |
| --- | --- |
| **Limit szybkości API** | 2 żądania na sekundę |
| **Dozwolony burst** | Do 5 żądań w krótkich seriach |
| **Paginacja** | 30 elementów na stronę (domyślnie), maks. 100 |

Strategia paginacji

Gorgias używa paginacji opartej na kursorze z parametrami `cursor` i `limit`. Tajo obsługuje to automatycznie, żądając do 100 elementów na stronę dla maksymalnej wydajności.

Gorgias zwraca `429 Too Many Requests`, gdy przekroczono limity szybkości.

## Rozwiązywanie problemów

### Typowe problemy

| Problem | Przyczyna | Rozwiązanie |
| --- | --- | --- |
| 401 Unauthorized | Nieprawidłowy e-mail lub klucz API | Zweryfikuj poświadczenia w Gorgias Settings > REST API |
| 404 Not Found | Nieprawidłowy endpoint lub ID zasobu | Sprawdź, czy bazowy URL API zawiera Twoją subdomenę |
| Brakujący klienci | Brak e-maila w rekordzie | Gorgias wymaga e-maila do dopasowania klientów |
| Tagi się nie synchronizują | Tagi nie przypisane do klientów | Zweryfikuj, czy tagi są na obiektach klientów, a nie tylko zgłoszeniach |
| Wolna synchronizacja | Niski limit szybkości | Gorgias ogranicza do 2 żądań/s; pełne synchronizacje trwają dłużej |

### Tryb debug

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

### Test połączenia

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

## Najlepsze praktyki

1. **Używaj integracji HTTP dla zdarzeń w czasie rzeczywistym** - Konfiguruj Reguły Gorgias do wysyłania żądań HTTP do Tajo przy zdarzeniach zgłoszeń
2. **Regularnie synchronizuj dane CSAT** - Używaj wyników satysfakcji do kampanii reangażowania
3. **Mapuj tagi na segmenty** - Przekształcaj tagi klientów Gorgias na przynależność do list Brevo
4. **Ostrożnie obsługuj paginację** - Przy limitach 2 żądań/s planuj dłuższe czasy synchronizacji dla dużych zestawów danych
5. **Łącz z danymi e-commerce** - Łącz dane wsparcia Gorgias z danymi zamówień Shopify w Brevo
6. **Rotuj klucze API** - Ponieważ klucze Gorgias mają pełny dostęp, rotuj je regularnie

## Bezpieczeństwo

- **Basic Auth** - E-mail i klucz API przez HTTPS
- **Tylko HTTPS** - Cała komunikacja API szyfrowana przez TLS 1.2+
- **Klucze z pełnym dostępem** - Brak szczegółowego zakresu (chroń klucze starannie)
- **Allowlisting IP** - Dostępne w wyższych planach Gorgias
- **Szyfrowane przechowywanie** - Poświadczenia API szyfrowane w stanie spoczynku w Tajo
- **Zgodność SOC 2** - Platforma Gorgias posiada certyfikat SOC 2 Type II

## Powiązane zasoby

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