Gorgias کنیکٹر

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

جائزہ

خصوصیات

• ٹکٹ ایونٹ سنک - ٹکٹ کی تخلیق، 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/

# 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 انٹیگریشن کے ذریعے ٹکٹ ایونٹس کو سنبھالیں

// 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 ڈیٹا کو باقاعدگی سے سنک کریں - دوبارہ 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 کنیکٹر
• Jira کنیکٹر
• Shopify کنیکٹر
• Brevo Contacts API