موصل Gorgias

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

نظرة عامة

الميزات

• مزامنة أحداث التذاكر - إعادة توجيه أحداث إنشاء التذاكر وحلها و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/

# 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

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

يتكامل 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 إرسال طلبات 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');
});

حملة ما بعد الحل

// تشغيل بريد متابعة بعد حل تذكرة دعم
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

// مزامنة نتائج استبيانات الرضا مع سمات Brevo
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 للوقت الفعلي - اضبط قواعد 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
• موصل Jira
• موصل Shopify
• واجهة جهات اتصال Brevo