---
title: "Gorgias کنیکٹر"
description: "Tajo کے ذریعے helpdesk ٹکٹس، گاہک ڈیٹا، اور سپورٹ ایونٹس کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Gorgias انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/support/gorgias/
markdown: https://tajo.io/ur/docs/connectors/support/gorgias.md
lang: ur-PK
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` |

سپورٹ سے چلنے والے گاہک engagement، ٹکٹ کے بعد مارکیٹنگ فلوز، اور Tajo کے ذریعے متحدہ گاہک تجربہ اینالیٹکس کے لیے اپنے Gorgias helpdesk کو Brevo سے منسلک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Gorgias |
| **زمرہ** | سپورٹ |
| **سیٹ اپ کی پیچیدگی** | آسان |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | گاہک، ٹکٹس، ایونٹس |
| **API قسم** | REST API |
| **تصدیق** | API Key + Email (Basic Auth) |
| **بنیادی URL** | `https://{domain}.gorgias.com/api/` |

## خصوصیات

- **ٹکٹ ایونٹ سنک** - ٹکٹ کی تخلیق، resolution، اور CSAT ایونٹس کو Brevo ٹائم لائنز پر فارورڈ کریں
- **گاہک پروفائل افزودگی** - Gorgias گاہک ڈیٹا بشمول ٹیگز اور کسٹم فیلڈز کو Brevo پر سنک کریں
- **سپورٹ کے بعد مہمات** - فالو اپ یا upsell کے لیے ٹکٹ resolution کے بعد Brevo ورک فلوز ٹرگر کریں
- **اطمینان ٹریکنگ** - CSAT سروے نتائج کو Brevo رابطہ خصوصیات کے طور پر سنک کریں
- **ٹیگ پر مبنی segmentation** - Gorgias گاہک ٹیگز کو Brevo فہرست رکنیتوں کے طور پر مرور کریں
- **Macro اور rule ایونٹس** - آپریشنل اینالیٹکس کے لیے خودکار اقدامات ٹریک کریں

## شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. ایڈمن رسائی کے ساتھ Gorgias اکاؤنٹ
2. آپ کا Gorgias subdomain (مثلاً `yourstore.gorgias.com`)
3. API key اور متعلقہ ای میل پتہ
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. فعال سبسکرپشن کے ساتھ Tajo اکاؤنٹ

## تصدیق

Gorgias آپ کے اکاؤنٹ ای میل اور API key کے ساتھ HTTP Basic Authentication استعمال کرتا ہے۔

### 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-based اجازت کا ماڈل نہیں ہے۔ اپنی 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
```

### فیلڈ میپنگ

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 اینڈ پوائنٹس

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

### Resolution کے بعد مہم

```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 درخواستیں فی سیکنڈ |
| **برسٹ allowance** | مختصر برسٹس میں 5 درخواستوں تک |
| **Pagination** | 30 آئٹمز فی صفحہ (default), زیادہ سے زیادہ 100 |

Pagination حکمت عملی

Gorgias `cursor` اور `limit` پیرامیٹرز کے ساتھ cursor-based pagination استعمال کرتا ہے۔ Tajo اسے خودکار طور پر سنبھالتا ہے، زیادہ سے زیادہ کارکردگی کے لیے فی صفحہ 100 آئٹمز تک کی درخواست کرتا ہے۔

شرح کی حدود تجاوز ہونے پر Gorgias `429 Too Many Requests` واپس کرتا ہے۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 401 Unauthorized | غلط ای میل یا API key | Gorgias Settings > REST API میں کریڈینشلز کی تصدیق کریں |
| 404 Not Found | غلط اینڈ پوائنٹ یا resource ID | چیک کریں کہ API base URL میں آپ کا subdomain شامل ہے |
| گاہک غائب | ریکارڈ پر کوئی ای میل نہیں | Gorgias کو گاہک میچنگ کے لیے ای میل درکار ہے |
| ٹیگز سنک نہیں ہو رہے | ٹیگز گاہکوں کو تفویض نہیں | تصدیق کریں کہ ٹیگز گاہک objects پر ہیں، صرف ٹکٹس پر نہیں |
| سست sync | کم شرح کی حد | Gorgias 2 req/s تک محدود کرتا ہے؛ مکمل syncs زیادہ وقت لیتے ہیں |

### ڈیبگ موڈ

```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 استعمال کریں** - ٹکٹ ایونٹس پر Tajo کو HTTP درخواستیں بھیجنے کے لیے Gorgias Rules ترتیب دیں
2. **CSAT ڈیٹا کو باقاعدگی سے سنک کریں** - دوبارہ engagement مہمات چلانے کے لیے اطمینان اسکورز استعمال کریں
3. **ٹیگز کو سیگمنٹس پر میپ کریں** - Gorgias گاہک ٹیگز کو Brevo فہرست رکنیتوں میں ترجمہ کریں
4. **Pagination کو احتیاط سے سنبھالیں** - 2 req/s حدود کے ساتھ، بڑے ڈیٹا سیٹس پر طویل sync اوقات کا منصوبہ بنائیں
5. **ای کامرس ڈیٹا سے لنک کریں** - Brevo میں Gorgias سپورٹ ڈیٹا کو Shopify آرڈر ڈیٹا کے ساتھ ملائیں
6. **API keys گردش دیں** - چونکہ Gorgias keys کے پاس مکمل رسائی ہے، انہیں وقتاً فوقتاً گردش دیں

## سیکیورٹی

- **Basic Auth** - HTTPS پر ای میل اور API key
- **HTTPS صرف** - تمام API مواصلات TLS 1.2+ کے ذریعے انکرپٹڈ
- **مکمل رسائی Keys** - کوئی گرانولر اسکوپنگ نہیں (keys کی احتیاط سے حفاظت کریں)
- **IP اجازت دینا** - اعلی Gorgias plans پر دستیاب
- **انکرپٹڈ اسٹوریج** - API کریڈینشلز Tajo میں آرام پر انکرپٹڈ
- **SOC 2 کمپلائنس** - Gorgias پلیٹ فارم SOC 2 Type II سرٹیفائیڈ ہے

## متعلقہ وسائل

- [Twilio Flex کنیکٹر](https://tajo.io/ur/docs/connectors/custom/twilio-flex)
- [Jira کنیکٹر](https://tajo.io/ur/docs/connectors/custom/jira)
- [Shopify کنیکٹر](https://tajo.io/ur/docs/connectors/ecommerce/shopify)
- [Brevo Contacts API](https://tajo.io/ur/docs/contact-management)