موصل Freshdesk

اربط Freshdesk بـ Brevo من خلال Tajo لتوحيد بيانات الدعم والتسويق. زامن تذاكر دعم العملاء، وملفات جهات الاتصال، ودرجات الرضا لتشغيل اتصالات مستهدفة بناءً على تفاعلات الدعم.

نظرة عامة

الميزات

• مزامنة جهات الاتصال - مزامنة ثنائية الاتجاه لجهات اتصال Freshdesk مع قوائم جهات اتصال Brevo
• تتبع أحداث التذاكر - إعادة توجيه أحداث إنشاء التذاكر وتحديثها وحلها إلى Brevo
• مزامنة CSAT - مزامنة درجات رضا العملاء كسمات جهات اتصال Brevo
• مزامنة الشركات - ربط شركات Freshdesk بتقسيم جهات اتصال Brevo
• بيانات الوكلاء - تتبع تعيينات الوكلاء لأتمتة سير العمل الداخلي
• الحقول المخصصة - ربط حقول تذاكر وجهات اتصال Freshdesk المخصصة بسمات Brevo

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب Freshdesk مع صلاحيات المسؤول
2. مفتاح Freshdesk API الخاص بك (موجود في Profile Settings)
3. نطاق Freshdesk الخاص بك (مثلاً، yourcompany.freshdesk.com)
4. حساب Brevo مع وصول إلى API
5. حساب Tajo مع بيانات اعتماد API

المصادقة

مصادقة مفتاح API

يستخدم Freshdesk مصادقة مفتاح API عبر HTTP Basic Auth. يُستخدم مفتاح API كاسم مستخدم مع أي سلسلة (عادةً X) ككلمة مرور.

curl -u "YOUR_API_KEY:X" \
  https://yourcompany.freshdesk.com/api/v2/tickets

أو باستخدام ترميز Base64 في ترويسة Authorization:

curl https://yourcompany.freshdesk.com/api/v2/tickets \
  -H "Authorization: Basic BASE64_ENCODED_API_KEY:X" \
  -H "Content-Type: application/json"

العثور على مفتاح API الخاص بك

1. سجّل الدخول إلى حساب Freshdesk
2. انقر على صورة ملفك الشخصي في الزاوية العلوية اليمنى
3. انتقل إلى Profile Settings
4. يُعرض مفتاح API الخاص بك على الجانب الأيمن

الإعداد

الإعداد الأساسي

connectors:
  freshdesk:
    enabled: true
    domain: "yourcompany.freshdesk.com"
    api_key: "your-freshdesk-api-key"

    # Data sync options
    sync:
      contacts: true
      tickets: true
      companies: true
      satisfaction_ratings: true

    # Brevo list assignment
    lists:
      all_support_contacts: 30
      open_tickets: 31
      resolved_tickets: 32

تعيين حقول جهة الاتصال

ربط حقول جهات اتصال Freshdesk بسمات Brevo:

contact_mapping:
  email: email
  name: FULLNAME
  phone: SMS
  company_id: COMPANY
  job_title: JOB_TITLE
  twitter_id: TWITTER
  language: LANGUAGE
  time_zone: TIMEZONE

  # Support metrics
  total_tickets: TICKET_COUNT
  open_tickets: OPEN_TICKETS
  avg_csat: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # Custom fields
  custom_fields.account_type: ACCOUNT_TYPE
  custom_fields.subscription_tier: PLAN

تعيين أحداث التذاكر

ربط أحداث تذاكر Freshdesk بمحفزات أتمتة Brevo:

ticket_events:
  ticket_created: "support_ticket_created"
  ticket_updated: "support_ticket_updated"
  ticket_resolved: "support_ticket_resolved"
  ticket_closed: "support_ticket_closed"
  ticket_reopened: "support_ticket_reopened"
  satisfaction_rated: "csat_submitted"
  note_added: "support_note_added"

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

أمثلة على الكود

تهيئة موصل Freshdesk

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Freshdesk account
await tajo.connectors.connect('freshdesk', {
  domain: 'yourcompany.freshdesk.com',
  apiKey: process.env.FRESHDESK_API_KEY
});

مزامنة جهات الاتصال مع Brevo

// جلب جهات اتصال Freshdesk ومزامنتها مع Brevo
const response = await fetch(
  'https://yourcompany.freshdesk.com/api/v2/contacts?page=1&per_page=100',
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`),
      'Content-Type': 'application/json'
    }
  }
);

const contacts = await response.json();
// كل جهة اتصال:
// {
//   "id": 12345,
//   "name": "Jane Kim",
//   "email": "[email protected]",
//   "phone": "+15551234567",
//   "company_id": 678,
//   "job_title": "Product Manager",
//   "created_at": "2024-01-15T10:30:00Z"
// }

تتبع أحداث التذاكر

// إعداد webhook Freshdesk لإعادة توجيه أحداث التذاكر
// اضبطه في Freshdesk Admin > Automations > Webhook

// معالج webhook
app.post('/webhooks/freshdesk', async (req, res) => {
  const { ticket, event_type } = req.body;

  await tajo.connectors.handleWebhook('freshdesk', {
    topic: event_type,
    payload: {
      ticketId: ticket.id,
      subject: ticket.subject,
      status: ticket.status,
      priority: ticket.priority,
      requesterEmail: ticket.requester.email,
      createdAt: ticket.created_at
    }
  });

  res.status(200).send('OK');
});

البحث عن التذاكر حسب العميل

// البحث عن جميع التذاكر من عميل محدد
const query = encodeURIComponent('"email:[email protected]"');
const response = await fetch(
  `https://yourcompany.freshdesk.com/api/v2/search/tickets?query=${query}`,
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`)
    }
  }
);

const { results, total } = await response.json();

حدود المعدل

حدود إضافية:

استكشاف الأخطاء وإصلاحها

أفضل الممارسات

1. استخدم webhooks للمزامنة الآنية - اضبط Freshdesk Automations لتشغيل webhooks عند أحداث التذاكر
2. زامن درجات CSAT - تتبع تقييمات رضا العملاء كسمات Brevo للتقسيم
3. عيّن حالة التذكرة إلى القوائم - انقل جهات الاتصال تلقائيًا بين قوائم Brevo بناءً على حالة التذكرة
4. تتبع مقاييس الدعم - زامن عدد التذاكر ومتوسط وقت الاستجابة ومعدل الحل لكل جهة اتصال
5. استخدم Search API باعتدال - تحتوي Search API على حدود معدل أكثر صرامة؛ خزّن النتائج مؤقتًا عند الإمكان
6. قسّم التصديرات الكبيرة - استخدم التقسيم بمعاملي page وper_page للمزامنة الأولية

الأمان

• مصادقة مفتاح API - HTTP Basic Auth بسيط بمفتاح API
• HTTPS فقط - تتطلب جميع اتصالات API تشفير TLS
• قائمة IP المسموح بها - متاحة في خطط Estate وForest
• وصول قائم على الدور - صلاحيات مفتاح API مرتبطة بدور الوكيل
• SOC 2 Type II - Freshdesk معتمد من SOC 2 Type II
• الامتثال لـ GDPR - يدعم طلبات تصدير البيانات وحذفها

موارد ذات صلة

• موصل Brevo
• مهارة مزامنة العملاء
• موصل Shopify
• واجهة جهات اتصال Brevo