---
title: "موصل Gorgias"
description: "دليل تكامل Gorgias الشامل لمزامنة تذاكر مكتب المساعدة، وبيانات العملاء، وأحداث الدعم مع Brevo عبر Tajo."
url: https://tajo.io/ar/docs/connectors/support/gorgias/
markdown: https://tajo.io/ar/docs/connectors/support/gorgias.md
lang: ar-SA
robots: noindex
---

اطلب الوصول المبكر

أدخل اسمك الأول وعنوان بريدك الإلكتروني للعمل. سنرسل إليك رابطًا لتأكيد طلب الوصول إلى Tajo.

# موصل Gorgias

حالة الموصل: مخطط له لم يُبنَ بعد. لا يشغّل Tajo هذا الموصل اليوم.

| حقل المصدر | حقل الوجهة | قيمة نموذجية |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

اربط مكتب مساعدة Gorgias الخاص بك مع Brevo لتفاعل عملاء قائم على الدعم، وتدفقات تسويقية ما بعد التذاكر، وتحليلات تجربة عملاء موحدة عبر Tajo.

## نظرة عامة

| الخاصية | القيمة |
| --- | --- |
| **المنصة** | Gorgias |
| **الفئة** | الدعم |
| **تعقيد الإعداد** | سهل |
| **تكامل رسمي** | لا |
| **البيانات المُزامَنة** | عملاء، تذاكر، أحداث |
| **نوع واجهة البرمجة** | REST API |
| **المصادقة** | مفتاح API + بريد إلكتروني (Basic Auth) |
| **عنوان URL الأساسي** | `https://{domain}.gorgias.com/api/` |

## الميزات

- **مزامنة أحداث التذاكر** - إعادة توجيه أحداث إنشاء التذاكر وحلها وCSAT إلى جداول Brevo الزمنية
- **إثراء ملف العميل** - مزامنة بيانات عملاء Gorgias بما في ذلك الوسوم والحقول المخصصة مع Brevo
- **حملات ما بعد الدعم** - تشغيل سير عمل Brevo بعد حل التذاكر للمتابعة أو البيع الإضافي
- **تتبع الرضا** - مزامنة نتائج استبيانات CSAT كسمات جهات اتصال Brevo
- **التقسيم القائم على الوسوم** - عكس وسوم عملاء Gorgias كعضويات قوائم Brevo
- **أحداث Macro والقواعد** - تتبع الإجراءات الآلية للتحليلات التشغيلية

## المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب Gorgias مع صلاحيات المسؤول
2. النطاق الفرعي لـ Gorgias (مثلاً، `yourstore.gorgias.com`)
3. مفتاح API وعنوان البريد الإلكتروني المرتبط به
4. حساب Brevo مع وصول إلى API
5. حساب Tajo مع اشتراك نشط

## المصادقة

يستخدم Gorgias مصادقة HTTP Basic Authentication بعنوان بريدك الإلكتروني للحساب ومفتاح API.

### إنشاء مفتاح API

1. سجّل الدخول إلى لوحة 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

تحتوي مفاتيح Gorgias API على وصول كامل لبيانات حسابك. لا يوجد نموذج صلاحيات قائم على النطاق. احمِ مفتاح 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
```

## نقاط نهاية واجهة البرمجة

يتكامل Tajo مع نقاط نهاية Gorgias REST API التالية:

| نقطة النهاية | الطريقة | الغرض |
| --- | --- | --- |
| `/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

```javascript
// يمكن لـ Gorgias إرسال طلبات HTTP عبر القواعد أو تكاملات HTTP
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
// تشغيل بريد متابعة بعد حل تذكرة دعم
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
// مزامنة نتائج استبيانات الرضا مع سمات Brevo
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## حدود المعدل

يفرض Gorgias حدود معدل لكل حساب:

| نوع الحد | القيمة |
| --- | --- |
| **حد معدل API** | طلبان في الثانية |
| **السماح بالدفعات** | حتى 5 طلبات في دفعات قصيرة |
| **التقسيم** | 30 عنصرًا في الصفحة (افتراضي)، الحد الأقصى 100 |

استراتيجية التقسيم

يستخدم Gorgias تقسيمًا قائمًا على المؤشر بمعاملات `cursor` و`limit`. يتعامل Tajo مع هذا تلقائيًا، ويطلب حتى 100 عنصر لكل صفحة لأقصى كفاءة.

يُعيد Gorgias `429 Too Many Requests` عند تجاوز حدود المعدل.

## استكشاف الأخطاء وإصلاحها

### المشاكل الشائعة

| المشكلة | السبب | الحل |
| --- | --- | --- |
| 401 Unauthorized | بريد إلكتروني أو مفتاح API غير صالح | تحقق من بيانات الاعتماد في Gorgias Settings > REST API |
| 404 Not Found | نقطة نهاية أو معرّف مورد غير صالح | تحقق من أن عنوان URL الأساسي لـ API يتضمن نطاقك الفرعي |
| العملاء مفقودون | لا يوجد بريد إلكتروني في السجل | يتطلب Gorgias البريد الإلكتروني لمطابقة العملاء |
| الوسوم لا تتزامن | الوسوم غير مُعيَّنة للعملاء | تحقق من أن الوسوم موجودة على كائنات العملاء، وليس فقط التذاكر |
| مزامنة بطيئة | حد معدل منخفض | يقتصر Gorgias على طلبين/ثانية؛ تستغرق المزامنات الكاملة وقتًا أطول |

### وضع التصحيح

```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 للوقت الفعلي** - اضبط قواعد Gorgias لإرسال طلبات HTTP إلى Tajo عند أحداث التذاكر
2. **زامن بيانات CSAT بانتظام** - استخدم درجات الرضا لتشغيل حملات إعادة التفاعل
3. **عيّن الوسوم إلى الشرائح** - ترجم وسوم عملاء Gorgias إلى عضويات قوائم Brevo
4. **تعامل مع التقسيم بعناية** - مع حدود طلبين/ثانية، خطط لأوقات مزامنة أطول لمجموعات البيانات الكبيرة
5. **اربط ببيانات التجارة الإلكترونية** - ادمج بيانات دعم Gorgias مع بيانات طلبات Shopify في Brevo
6. **دوّر مفاتيح API** - نظرًا لأن مفاتيح Gorgias تحتوي على وصول كامل، دوّرها دوريًا

## الأمان

- **Basic Auth** - البريد الإلكتروني ومفتاح API عبر HTTPS
- **HTTPS فقط** - جميع اتصالات API مشفرة عبر TLS 1.2+
- **مفاتيح وصول كامل** - لا يوجد تحديد نطاق دقيق (احمِ المفاتيح بعناية)
- **قائمة IP المسموح بها** - متاحة في خطط Gorgias الأعلى
- **تخزين مشفر** - بيانات اعتماد API مشفرة في حالة السكون في Tajo
- **الامتثال لـ SOC 2** - منصة Gorgias معتمدة من SOC 2 Type II

## موارد ذات صلة

- [موصل Twilio Flex](https://tajo.io/ar/docs/connectors/custom/twilio-flex)
- [موصل Jira](https://tajo.io/ar/docs/connectors/custom/jira)
- [موصل Shopify](https://tajo.io/ar/docs/connectors/ecommerce/shopify)
- [واجهة جهات اتصال Brevo](https://tajo.io/ar/docs/contact-management)