Gorgias कनेक्टर

सपोर्ट-संचालित ग्राहक एंगेजमेंट, पोस्ट-टिकट मार्केटिंग फ़्लोज़, और एकीकृत ग्राहक अनुभव एनालिटिक्स के लिए अपने Gorgias helpdesk को Tajo के माध्यम से Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• टिकट इवेंट सिंक - टिकट निर्माण, 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/

# Basic Auth: email as username, API key as password
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "[email protected]:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"

Tajo से कनेक्ट करना

tajo connectors install gorgias \
  --domain yourstore.gorgias.com \
  --email [email protected] \
  --api-key $GORGIAS_API_KEY

कॉन्फ़िगरेशन

बुनियादी सेटअप

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 कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

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

इवेंट मैपिंग

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 एंडपॉइंट्स के साथ इंटीग्रेट होता है:

कोड उदाहरण

कनेक्टर प्रारंभ करें

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: '[email protected]',
  apiKey: process.env.GORGIAS_API_KEY
});

Brevo में कस्टमर्स सिंक करें

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 के माध्यम से टिकट इवेंट्स हैंडल करें

// 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 कैंपेन

// 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 डेटा सिंक करें

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

दर सीमाएं

Gorgias प्रति खाता दर सीमाएं लागू करता है:

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

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

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

डीबग मोड

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

कनेक्शन परीक्षण करें

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
• Jira Connector
• Shopify Connector
• Brevo Contacts API