---
title: "Σύνδεσμος Gorgias"
description: "Πλήρης οδηγός ενσωμάτωσης Gorgias για συγχρονισμό εισιτηρίων helpdesk, δεδομένων πελατών και εκδηλώσεων υποστήριξης με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/support/gorgias/
markdown: https://tajo.io/gr/docs/connectors/support/gorgias.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Gorgias

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε το helpdesk Gorgias με το Brevo για αφοσίωση πελατών βάσει υποστήριξης, ροές marketing μετά-εισιτηρίου και ενοποιημένα αναλυτικά εμπειρίας πελάτη μέσω Tajo.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Gorgias |
| **Κατηγορία** | Υποστήριξη |
| **Πολυπλοκότητα Ρύθμισης** | Εύκολη |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Πελάτες, Εισιτήρια, Εκδηλώσεις |
| **Τύπος API** | REST API |
| **Πιστοποίηση** | API Key + Email (Basic Auth) |
| **Βασικό URL** | `https://{domain}.gorgias.com/api/` |

## Χαρακτηριστικά

- **Συγχρονισμός εκδηλώσεων εισιτηρίων** - Προώθηση εκδηλώσεων δημιουργίας, επίλυσης και CSAT στα χρονολόγια Brevo
- **Εμπλουτισμός προφίλ πελάτη** - Συγχρονισμός δεδομένων πελάτη Gorgias συμπεριλαμβανομένων ετικετών και προσαρμοσμένων πεδίων στο Brevo
- **Καμπάνιες μετά-υποστήριξης** - Trigger ροών εργασίας Brevo μετά την επίλυση εισιτηρίου για follow-up ή upsell
- **Παρακολούθηση ικανοποίησης** - Συγχρονισμός αποτελεσμάτων έρευνας CSAT ως χαρακτηριστικά επαφών Brevo
- **Τμηματοποίηση βάσει ετικετών** - Αντικατοπτρισμός ετικετών πελάτη Gorgias ως συμμετοχές λίστας Brevo
- **Εκδηλώσεις macro και rule** - Παρακολούθηση αυτοματοποιημένων ενεργειών για λειτουργικά αναλυτικά

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Gorgias με πρόσβαση διαχειριστή
2. Το υποτομέα Gorgias σας (π.χ. `yourstore.gorgias.com`)
3. Κλειδί API και συσχετισμένη διεύθυνση email
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

## Πιστοποίηση

Το Gorgias χρησιμοποιεί HTTP Basic Authentication με το email λογαριασμού και κλειδί API.

### Δημιουργία Κλειδιού API

1. Συνδεθείτε στο dashboard Gorgias
2. Μεταβείτε στις **Settings** > **REST API**
3. Κάντε κλικ **Create API Key** (ή αντιγράψτε υπάρχον κλειδί)
4. Σημειώστε το βασικό 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"
```

Δικαιώματα Κλειδιού API

Τα κλειδιά API Gorgias έχουν πλήρη πρόσβαση στα δεδομένα λογαριασμού. Δεν υπάρχει μοντέλο δικαιωμάτων βάσει εύρους. Προστατέψτε το κλειδί API και εναλλάσσετε το τακτικά.

### Σύνδεση στο Tajo

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

## Διαμόρφωση

### Βασική Ρύθμιση

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

### Αντιστοίχιση Πεδίων

Αντιστοίχηση πεδίων πελάτη και εισιτηρίου Gorgias σε χαρακτηριστικά επαφών 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
```

### Αντιστοίχιση Εκδηλώσεων

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

## Endpoints API

Το Tajo ενσωματώνεται με τα ακόλουθα endpoints REST API του Gorgias:

| Endpoint | Μέθοδος | Σκοπός |
| --- | --- | --- |
| `/api/customers` | GET | Λίστα πελατών |
| `/api/customers/{id}` | GET | Ανάκτηση πελάτη |
| `/api/customers` | POST | Δημιουργία πελάτη |
| `/api/customers/{id}` | PUT | Ενημέρωση πελάτη |
| `/api/tickets` | GET | Λίστα εισιτηρίων |
| `/api/tickets/{id}` | GET | Ανάκτηση εισιτηρίου |
| `/api/tickets/{id}/messages` | GET | Λίστα μηνυμάτων εισιτηρίου |
| `/api/tags` | GET | Λίστα ετικετών |
| `/api/satisfaction-surveys` | GET | Λίστα ερευνών CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Ανάκτηση έρευνας |
| `/api/users` | GET | Λίστα πρακτόρων |
| `/api/integrations` | GET | Λίστα ενσωματώσεων |
| `/api/events` | GET | Λίστα εκδηλώσεων |
| `/api/customers/{id}/custom-fields` | GET | Λήψη τιμών προσαρμοσμένων πεδίων |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου

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

### Συγχρονισμός Πελατών στο 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
// }
```

### Χειρισμός Εκδηλώσεων Εισιτηρίου μέσω HTTP Integration

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

### Καμπάνια Μετά-Επίλυση

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

### Συγχρονισμός Δεδομένων CSAT

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

## Όρια Ρυθμού

Το Gorgias επιβάλλει όρια ρυθμού ανά λογαριασμό:

| Τύπος Ορίου | Τιμή |
| --- | --- |
| **Όριο ρυθμού API** | 2 αιτήματα ανά δευτερόλεπτο |
| **Επίδομα burst** | Έως 5 αιτήματα σε σύντομα burst |
| **Σελιδοποίηση** | 30 στοιχεία ανά σελίδα (προεπιλογή), μέγιστο 100 |

Στρατηγική Σελιδοποίησης

Το Gorgias χρησιμοποιεί σελιδοποίηση βάσει cursor με παραμέτρους `cursor` και `limit`. Το Tajo τη χειρίζεται αυτόματα, ζητώντας έως 100 στοιχεία ανά σελίδα για μέγιστη αποδοτικότητα.

Το Gorgias επιστρέφει `429 Too Many Requests` όταν υπερβαίνονται τα όρια ρυθμού.

## Αντιμετώπιση Προβλημάτων

### Συνήθη Προβλήματα

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο email ή κλειδί API | Επαληθεύστε διαπιστευτήρια στο Gorgias Settings > REST API |
| 404 Not Found | Μη έγκυρο endpoint ή ID πόρου | Ελέγξτε ότι το βασικό URL API περιλαμβάνει τον υποτομέα σας |
| Λείπουν πελάτες | Δεν υπάρχει email στο αρχείο | Το Gorgias απαιτεί email για αντιστοίχηση πελατών |
| Οι ετικέτες δεν συγχρονίζονται | Οι ετικέτες δεν έχουν ανατεθεί σε πελάτες | Επαληθεύστε ότι οι ετικέτες βρίσκονται σε αντικείμενα πελατών, όχι μόνο εισιτήρια |
| Αργός συγχρονισμός | Χαμηλό όριο ρυθμού | Το Gorgias περιορίζει σε 2 αιτ./δευτ.· οι πλήρεις συγχρονισμοί διαρκούν περισσότερο |

### Λειτουργία Εντοπισμού Σφαλμάτων

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

### Δοκιμή Σύνδεσης

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

## Βέλτιστες Πρακτικές

1. **Χρησιμοποιήστε HTTP integrations για πραγματικό χρόνο** - Ρυθμίστε Κανόνες Gorgias για αποστολή HTTP αιτημάτων στο Tajo σε εκδηλώσεις εισιτηρίων
2. **Συγχρονίστε δεδομένα CSAT τακτικά** - Χρησιμοποιήστε βαθμολογίες ικανοποίησης για καμπάνιες επανεμπλοκής
3. **Αντιστοιχίστε ετικέτες σε τμήματα** - Μεταφράστε ετικέτες πελάτη Gorgias σε συμμετοχές λίστας Brevo
4. **Χειριστείτε τη σελιδοποίηση προσεκτικά** - Με όρια 2 αιτ./δευτ., σχεδιάστε για μεγαλύτερους χρόνους συγχρονισμού σε μεγάλα σύνολα δεδομένων
5. **Συνδέστε με δεδομένα e-commerce** - Συνδυάστε δεδομένα υποστήριξης Gorgias με δεδομένα παραγγελιών Shopify στο Brevo
6. **Εναλλάσσετε κλειδιά API** - Δεδομένου ότι τα κλειδιά Gorgias έχουν πλήρη πρόσβαση, εναλλάσσετε τα περιοδικά

## Ασφάλεια

- **Basic Auth** - Email και κλειδί API μέσω HTTPS
- **Μόνο HTTPS** - Όλη η επικοινωνία API κρυπτογραφείται μέσω TLS 1.2+
- **Κλειδιά Πλήρους Πρόσβασης** - Χωρίς λεπτομερή εύρη (προστατέψτε προσεκτικά τα κλειδιά)
- **Λίστα Επιτρεπόμενων IP** - Διαθέσιμο σε υψηλότερα πλάνα Gorgias
- **Κρυπτογραφημένη Αποθήκευση** - Διαπιστευτήρια API κρυπτογραφούνται σε ηρεμία στο Tajo
- **Συμμόρφωση SOC 2** - Η πλατφόρμα Gorgias είναι πιστοποιημένη SOC 2 Type II

## Σχετικοί Πόροι

- [Σύνδεσμος Twilio Flex](https://tajo.io/gr/docs/connectors/custom/twilio-flex)
- [Σύνδεσμος Jira](https://tajo.io/gr/docs/connectors/custom/jira)
- [Σύνδεσμος Shopify](https://tajo.io/gr/docs/connectors/ecommerce/shopify)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)