---
title: "Gorgias कनेक्टर"
description: "Tajo के माध्यम से Brevo के साथ helpdesk टिकट्स, ग्राहक डेटा, और सपोर्ट इवेंट्स सिंक करने के लिए संपूर्ण Gorgias इंटीग्रेशन गाइड।"
url: https://tajo.io/hi/docs/connectors/support/gorgias/
markdown: https://tajo.io/hi/docs/connectors/support/gorgias.md
lang: hi-IN
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 helpdesk को Tajo के माध्यम से Brevo से कनेक्ट करें।

## अवलोकन

| गुण | मान |
| --- | --- |
| **प्लेटफ़ॉर्म** | Gorgias |
| **श्रेणी** | Support |
| **सेटअप जटिलता** | आसान |
| **आधिकारिक इंटीग्रेशन** | नहीं |
| **सिंक किया गया डेटा** | कस्टमर्स, टिकट्स, इवेंट्स |
| **API Type** | REST API |
| **प्रमाणीकरण** | API Key + Email (Basic Auth) |
| **Base URL** | `https://{domain}.gorgias.com/api/` |

## विशेषताएं

- **टिकट इवेंट सिंक** - टिकट निर्माण, resolution, और CSAT इवेंट्स को Brevo timelines में फ़ॉरवर्ड करें
- **ग्राहक प्रोफ़ाइल संवर्धन** - tags और कस्टम फ़ील्ड्स सहित Gorgias ग्राहक डेटा को Brevo में सिंक करें
- **पोस्ट-सपोर्ट कैंपेन** - फ़ॉलो-अप या upsell के लिए टिकट resolution के बाद Brevo workflows ट्रिगर करें
- **संतुष्टि ट्रैकिंग** - CSAT survey परिणामों को Brevo कॉन्टैक्ट एट्रिब्यूट्स के रूप में सिंक करें
- **Tag-आधारित सेगमेंटेशन** - Gorgias ग्राहक tags को Brevo list memberships के रूप में मिरर करें
- **Macro और rule इवेंट्स** - operational एनालिटिक्स के लिए स्वचालित actions ट्रैक करें

## पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. admin एक्सेस के साथ एक 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 डैशबोर्ड में लॉग इन करें
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
```

### फ़ील्ड मैपिंग

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 | tags सूचीबद्ध करें |
| `/api/satisfaction-surveys` | GET | CSAT surveys सूचीबद्ध करें |
| `/api/satisfaction-surveys/{id}` | GET | एक survey प्राप्त करें |
| `/api/users` | GET | एजेंट्स सूचीबद्ध करें |
| `/api/integrations` | GET | integrations सूचीबद्ध करें |
| `/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');
});
```

### पोस्ट-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 अनुरोध प्रति सेकंड |
| **Burst allowance** | छोटे bursts में 5 अनुरोध तक |
| **Pagination** | 30 आइटम प्रति page (default), max 100 |

Pagination रणनीति

Gorgias `cursor` और `limit` पैरामीटर के साथ cursor-आधारित pagination का उपयोग करता है। Tajo इसे स्वचालित रूप से हैंडल करता है, अधिकतम दक्षता के लिए प्रति page 100 तक आइटम का अनुरोध करता है।

जब दर सीमाएं पार हो जाती हैं तो Gorgias `429 Too Many Requests` लौटाता है।

## समस्या निवारण

### सामान्य समस्याएं

| समस्या | कारण | समाधान |
| --- | --- | --- |
| 401 Unauthorized | अमान्य ईमेल या API key | Gorgias Settings > REST API में credentials सत्यापित करें |
| 404 Not Found | अमान्य एंडपॉइंट या resource ID | API base URL में आपका subdomain शामिल है जांचें |
| कस्टमर्स गायब | record पर कोई ईमेल नहीं | Gorgias को customer matching के लिए ईमेल आवश्यक है |
| Tags सिंक नहीं हो रहे | Tags customers को असाइन नहीं | सत्यापित करें कि tags customer objects पर हैं, न कि केवल tickets पर |
| धीमा 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 डेटा नियमित रूप से सिंक करें** - re-engagement कैंपेन को संचालित करने के लिए संतुष्टि स्कोर का उपयोग करें
3. **tags को segments में मैप करें** - Gorgias customer tags को Brevo list memberships में अनुवादित करें
4. **pagination को सावधानी से हैंडल करें** - 2 req/s सीमाओं के साथ, बड़े datasets पर लंबे sync समय की योजना बनाएं
5. **e-commerce डेटा से लिंक करें** - Brevo में Gorgias सपोर्ट डेटा को Shopify order डेटा के साथ संयोजित करें
6. **API keys रोटेट करें** - चूंकि Gorgias keys के पास पूर्ण एक्सेस है, उन्हें समय-समय पर रोटेट करें

## सुरक्षा

- **Basic Auth** - HTTPS पर ईमेल और API key
- **HTTPS Only** - सभी API संचार TLS 1.2+ के माध्यम से एन्क्रिप्टेड
- **Full Access Keys** - कोई granular scoping नहीं (keys को सावधानी से सुरक्षित रखें)
- **IP Allowlisting** - उच्च Gorgias प्लान्स पर उपलब्ध
- **एन्क्रिप्टेड स्टोरेज** - Tajo में रेस्ट पर API क्रेडेंशियल्स एन्क्रिप्टेड
- **SOC 2 अनुपालन** - Gorgias प्लेटफ़ॉर्म SOC 2 Type II प्रमाणित है

## संबंधित संसाधन

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