---
title: "Konektor Gorgias"
description: "Panduan integrasi Gorgias lengkap untuk menyinkronkan tiket helpdesk, data pelanggan, dan event support dengan Brevo melalui Tajo."
url: https://tajo.io/in/docs/connectors/support/gorgias/
markdown: https://tajo.io/in/docs/connectors/support/gorgias.md
lang: id-ID
robots: noindex
---

Ajukan akses awal

Masukkan nama depan dan alamat email kerja Anda. Kami akan mengirim tautan untuk mengonfirmasi permintaan akses Tajo.

# Konektor Gorgias

Status konektor: Direncanakan Belum dibangun. Tajo belum menjalankan konektor ini.

| Field sumber | Field tujuan | Nilai contoh |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Hubungkan helpdesk Gorgias Anda ke Brevo untuk customer engagement berbasis support, alur marketing pasca tiket, dan analitik pengalaman pelanggan yang terpadu melalui Tajo.

## Ikhtisar

| Properti | Nilai |
| --- | --- |
| **Platform** | Gorgias |
| **Kategori** | Support |
| **Kompleksitas setup** | Mudah |
| **Integrasi resmi** | Tidak |
| **Data yang disinkronkan** | Pelanggan, Tiket, Event |
| **Tipe API** | REST API |
| **Autentikasi** | API Key + Email (Basic Auth) |
| **Base URL** | `https://{domain}.gorgias.com/api/` |

## Fitur

- **Sinkronisasi event tiket** - Teruskan event pembuatan tiket, penyelesaian, dan CSAT ke timeline Brevo
- **Pengayaan profil pelanggan** - Sinkronkan data pelanggan Gorgias termasuk tag dan custom field ke Brevo
- **Kampanye pasca support** - Picu alur kerja Brevo setelah tiket selesai untuk follow-up atau upsell
- **Pelacakan kepuasan** - Sinkronkan hasil survei CSAT sebagai atribut kontak Brevo
- **Segmentasi berbasis tag** - Cerminkan tag pelanggan Gorgias sebagai keanggotaan daftar Brevo
- **Event macro dan rule** - Lacak aksi otomatis untuk analitik operasional

## Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Gorgias dengan akses admin
2. Subdomain Gorgias Anda (misalnya, `yourstore.gorgias.com`)
3. Sebuah API key dan alamat email yang terkait
4. Akun Brevo dengan akses API
5. Akun Tajo dengan langganan aktif

## Autentikasi

Gorgias menggunakan HTTP Basic Authentication dengan email akun dan API key Anda.

### Membuat API key

1. Masuk ke dasbor Gorgias Anda
2. Buka **Settings** > **REST API**
3. Klik **Create API Key** (atau salin key yang sudah ada)
4. Catat base URL API Anda: `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"
```

Izin API key

API key Gorgias memiliki akses penuh ke data akun Anda. Tidak ada model izin berbasis scope. Lindungi API key Anda dan rotasikan secara rutin.

### Menghubungkan ke Tajo

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

## Konfigurasi

### Setup dasar

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

### Pemetaan field

Petakan field pelanggan dan tiket Gorgias ke atribut kontak 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
```

### Pemetaan event

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

## Endpoint API

Tajo terintegrasi dengan endpoint REST API Gorgias berikut:

| Endpoint | Metode | Tujuan |
| --- | --- | --- |
| `/api/customers` | GET | Menampilkan pelanggan |
| `/api/customers/{id}` | GET | Mengambil satu pelanggan |
| `/api/customers` | POST | Membuat pelanggan |
| `/api/customers/{id}` | PUT | Memperbarui pelanggan |
| `/api/tickets` | GET | Menampilkan tiket |
| `/api/tickets/{id}` | GET | Mengambil satu tiket |
| `/api/tickets/{id}/messages` | GET | Menampilkan pesan tiket |
| `/api/tags` | GET | Menampilkan tag |
| `/api/satisfaction-surveys` | GET | Menampilkan survei CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Mengambil satu survei |
| `/api/users` | GET | Menampilkan agen |
| `/api/integrations` | GET | Menampilkan integrasi |
| `/api/events` | GET | Menampilkan event |
| `/api/customers/{id}/custom-fields` | GET | Mengambil nilai custom field |

## Contoh kode

### Inisialisasi konektor

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

### Menyinkronkan pelanggan ke 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
// }
```

### Menangani event tiket lewat integrasi 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');
});
```

### Kampanye pasca penyelesaian

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

### Menyinkronkan data CSAT

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

## Batas rate

Gorgias menerapkan batas rate per akun:

| Tipe batas | Nilai |
| --- | --- |
| **Batas rate API** | 2 permintaan per detik |
| **Toleransi burst** | Hingga 5 permintaan dalam burst singkat |
| **Paginasi** | 30 item per halaman (default), maksimal 100 |

Strategi paginasi

Gorgias menggunakan paginasi berbasis cursor dengan parameter `cursor` dan `limit`. Tajo menanganinya secara otomatis, meminta hingga 100 item per halaman untuk efisiensi maksimal.

Gorgias mengembalikan `429 Too Many Requests` ketika batas rate terlampaui.

## Pemecahan masalah

### Masalah umum

| Masalah | Penyebab | Solusi |
| --- | --- | --- |
| 401 Unauthorized | Email atau API key tidak valid | Verifikasi kredensial di Gorgias Settings > REST API |
| 404 Not Found | Endpoint atau ID sumber daya tidak valid | Periksa base URL API sudah menyertakan subdomain Anda |
| Pelanggan tidak muncul | Tidak ada email pada record | Gorgias membutuhkan email untuk pencocokan pelanggan |
| Tag tidak tersinkronisasi | Tag belum ditetapkan ke pelanggan | Pastikan tag ada pada objek pelanggan, bukan hanya pada tiket |
| Sinkronisasi lambat | Batas rate rendah | Gorgias membatasi 2 req/detik; sinkronisasi penuh butuh waktu lebih lama |

### Mode debug

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

### Menguji koneksi

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

## Praktik terbaik

1. **Gunakan integrasi HTTP untuk real-time** - Konfigurasikan Gorgias Rules agar mengirim permintaan HTTP ke Tajo pada event tiket
2. **Sinkronkan data CSAT secara rutin** - Gunakan skor kepuasan untuk menggerakkan kampanye re-engagement
3. **Petakan tag ke segmen** - Terjemahkan tag pelanggan Gorgias menjadi keanggotaan daftar Brevo
4. **Tangani paginasi dengan cermat** - Dengan batas 2 req/detik, siapkan waktu sinkronisasi lebih lama untuk dataset besar
5. **Hubungkan dengan data e-commerce** - Gabungkan data support Gorgias dengan data pesanan Shopify di Brevo
6. **Rotasikan API key** - Karena key Gorgias memiliki akses penuh, rotasikan secara berkala

## Keamanan

- **Basic Auth** - Email dan API key melalui HTTPS
- **HTTPS saja** - Semua komunikasi API dienkripsi lewat TLS 1.2+
- **Key akses penuh** - Tidak ada scoping granular (lindungi key dengan cermat)
- **IP allowlisting** - Tersedia pada paket Gorgias yang lebih tinggi
- **Penyimpanan terenkripsi** - Kredensial API dienkripsi saat disimpan di Tajo
- **Kepatuhan SOC 2** - Platform Gorgias bersertifikat SOC 2 Type II

## Sumber daya terkait

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