---
title: "Gorgias Connector"
description: "คู่มือการผสานรวม Gorgias ฉบับสมบูรณ์สำหรับการซิงค์ helpdesk tickets ข้อมูลลูกค้า และเหตุการณ์ support กับ Brevo ผ่าน Tajo"
url: https://tajo.io/th/docs/connectors/support/gorgias/
markdown: https://tajo.io/th/docs/connectors/support/gorgias.md
lang: th-TH
robots: noindex
---

ขอสิทธิ์ใช้งานล่วงหน้า

กรอกชื่อและที่อยู่อีเมลที่ทำงานของคุณ เราจะส่งลิงก์เพื่อยืนยันคำขอเข้าใช้งาน Tajo ทางอีเมล

# Gorgias Connector

สถานะตัวเชื่อม: วางแผนไว้ ยังไม่ได้สร้าง ปัจจุบัน Tajo ยังไม่ได้ใช้งานตัวเชื่อมนี้

| ฟิลด์ต้นทาง | ฟิลด์ปลายทาง | ค่าตัวอย่าง |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

เชื่อมต่อ Gorgias helpdesk ของคุณกับ Brevo สำหรับ customer engagement ที่ขับเคลื่อนด้วย support post-ticket marketing flows และ customer experience analytics ที่รวมกันผ่าน Tajo

## ภาพรวม

| คุณสมบัติ | ค่า |
| --- | --- |
| **แพลตฟอร์ม** | Gorgias |
| **หมวดหมู่** | Support |
| **ความซับซ้อนในการตั้งค่า** | ง่าย |
| **การผสานรวมอย่างเป็นทางการ** | ไม่ |
| **ข้อมูลที่ซิงค์** | ลูกค้า Tickets เหตุการณ์ |
| **ประเภท API** | REST API |
| **การยืนยันตัวตน** | API Key + Email (Basic Auth) |
| **Base URL** | `https://{domain}.gorgias.com/api/` |

## ฟีเจอร์

- **การซิงค์เหตุการณ์ Ticket** - ส่งต่อเหตุการณ์การสร้าง การแก้ไข และ CSAT ของ ticket ไปยัง Brevo timelines
- **การเสริมโปรไฟล์ลูกค้า** - ซิงค์ข้อมูลลูกค้า Gorgias รวมถึง tags และ custom fields ไปยัง Brevo
- **แคมเปญหลัง support** - Trigger Brevo workflows หลังจากการแก้ไข ticket สำหรับการติดตามหรือ upsell
- **การติดตามความพึงพอใจ** - ซิงค์ผลการสำรวจ CSAT เป็น Brevo contact attributes
- **การแบ่ง segment ตาม tag** - จำลอง Gorgias customer tags เป็นสมาชิก Brevo list
- **เหตุการณ์ Macro และ rule** - ติดตามการดำเนินการอัตโนมัติสำหรับ operational analytics

## ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี Gorgias ที่มีสิทธิ์ admin
2. Gorgias subdomain ของคุณ (เช่น `yourstore.gorgias.com`)
3. API key และที่อยู่อีเมลที่เกี่ยวข้อง
4. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
5. บัญชี Tajo ที่มีการสมัครสมาชิกที่ใช้งานอยู่

## การยืนยันตัวตน

Gorgias ใช้ HTTP Basic Authentication ด้วยอีเมลบัญชีและ API key ของคุณ

### การสร้าง API Key

1. เข้าสู่ระบบ Gorgias dashboard ของคุณ
2. ไปที่ **Settings** > **REST API**
3. คลิก **Create API Key** (หรือคัดลอก key ที่มีอยู่)
4. จดบันทึก API base URL ของคุณ: `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 Key

Gorgias API keys มีการเข้าถึงข้อมูลบัญชีของคุณแบบเต็มรูปแบบ ไม่มีโมเดลสิทธิ์แบบ scope ปกป้อง API key ของคุณและหมุนเวียนเป็นประจำ

### การเชื่อมต่อกับ 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
```

### การแมปฟิลด์

แมปฟิลด์ลูกค้าและ ticket ของ 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
```

## API Endpoints

Tajo ผสานรวมกับ Gorgias REST API endpoints ต่อไปนี้:

| Endpoint | เมธอด | จุดประสงค์ |
| --- | --- | --- |
| `/api/customers` | GET | แสดงรายการลูกค้า |
| `/api/customers/{id}` | GET | ดึงข้อมูลลูกค้า |
| `/api/customers` | POST | สร้างลูกค้า |
| `/api/customers/{id}` | PUT | อัปเดตลูกค้า |
| `/api/tickets` | GET | แสดงรายการ tickets |
| `/api/tickets/{id}` | GET | ดึงข้อมูล ticket |
| `/api/tickets/{id}/messages` | GET | แสดงรายการข้อความ ticket |
| `/api/tags` | GET | แสดงรายการ tags |
| `/api/satisfaction-surveys` | GET | แสดงรายการการสำรวจ CSAT |
| `/api/satisfaction-surveys/{id}` | GET | ดึงการสำรวจ |
| `/api/users` | GET | แสดงรายการ agents |
| `/api/integrations` | GET | แสดงรายการ integrations |
| `/api/events` | GET | แสดงรายการเหตุการณ์ |
| `/api/customers/{id}/custom-fields` | GET | ดึงค่า custom fields |

## ตัวอย่างโค้ด

### เริ่มต้น Connector

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

### จัดการเหตุการณ์ Ticket ผ่าน 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 บังคับใช้ rate limits ต่อบัญชี:

| ประเภทขีดจำกัด | ค่า |
| --- | --- |
| **API rate limit** | 2 คำขอต่อวินาที |
| **Burst allowance** | สูงสุด 5 คำขอในช่วงสั้น |
| **Pagination** | 30 รายการต่อหน้า (ค่าเริ่มต้น), สูงสุด 100 |

กลยุทธ์ Pagination

Gorgias ใช้ cursor-based pagination พร้อมพารามิเตอร์ `cursor` และ `limit` Tajo จัดการโดยอัตโนมัติ โดยขอสูงสุด 100 รายการต่อหน้าเพื่อประสิทธิภาพสูงสุด

Gorgias ส่งคืน `429 Too Many Requests` เมื่อเกิน rate limits

## การแก้ไขปัญหา

### ปัญหาทั่วไป

| ปัญหา | สาเหตุ | วิธีแก้ |
| --- | --- | --- |
| 401 Unauthorized | อีเมลหรือ API key ไม่ถูกต้อง | ตรวจสอบข้อมูลประจำตัวใน Gorgias Settings > REST API |
| 404 Not Found | Endpoint ไม่ถูกต้องหรือ resource ID ผิด | ตรวจสอบว่า API base URL รวม subdomain ของคุณ |
| ลูกค้าหายไป | ไม่มีอีเมลในบันทึก | Gorgias ต้องการอีเมลสำหรับการจับคู่ลูกค้า |
| Tags ไม่ซิงค์ | Tags ไม่ได้กำหนดให้ลูกค้า | ตรวจสอบว่า tags อยู่บน customer objects ไม่ใช่แค่ tickets |
| ซิงค์ช้า | Rate limit ต่ำ | Gorgias จำกัด 2 req/s; full syncs ใช้เวลานานกว่า |

### โหมด Debug

```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 สำหรับ real-time** - กำหนดค่า Gorgias Rules เพื่อส่ง HTTP requests ไปยัง Tajo บนเหตุการณ์ ticket
2. **ซิงค์ข้อมูล CSAT เป็นประจำ** - ใช้คะแนนความพึงพอใจเพื่อขับเคลื่อนแคมเปญ re-engagement
3. **แมป tags ไปยัง segments** - แปลง Gorgias customer tags เป็นสมาชิก Brevo list
4. **จัดการ pagination อย่างระมัดระวัง** - ด้วยขีดจำกัด 2 req/s วางแผนสำหรับเวลาซิงค์ที่นานขึ้นสำหรับชุดข้อมูลขนาดใหญ่
5. **เชื่อมกับข้อมูล e-commerce** - รวมข้อมูล support Gorgias กับข้อมูลคำสั่งซื้อ Shopify ใน Brevo
6. **หมุนเวียน API keys** - เนื่องจาก Gorgias keys มีการเข้าถึงแบบเต็มรูปแบบ หมุนเวียนเป็นระยะ

## ความปลอดภัย

- **Basic Auth** - อีเมลและ API key ผ่าน HTTPS
- **HTTPS เท่านั้น** - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน TLS 1.2+
- **Full Access Keys** - ไม่มี granular scoping (ปกป้อง keys อย่างระมัดระวัง)
- **IP Allowlisting** - มีให้สำหรับแผน Gorgias ที่สูงกว่า
- **การจัดเก็บที่เข้ารหัส** - ข้อมูลประจำตัว API เข้ารหัสที่เก็บใน Tajo
- **SOC 2 Compliance** - Gorgias platform ได้รับการรับรอง SOC 2 Type II

## แหล่งข้อมูลที่เกี่ยวข้อง

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