الانتقال إلى المحتوى الرئيسي
تساعد المطالبة بمحادثة الضيف في تدفقات الدردشة على موقع الويب على دمج محادثات الزائرين المجهولين في ملف تعريف عميل حقيقي. استخدمه بعد تسجيل دخول الزائر، أو إرسال بريده الإلكتروني، أو بعد أن يصبح معروفًا.

المطالبة بمحادثات الضيوف

const result = await plato.v1.connect.claimGuestConversations.mutate({
  fingerprint: "browser_fingerprint_value",
  guestExternalId: "guest_123",
  customer: {
    externalId: "customer_123",
    name: "Jane Customer",
    email: "[email protected]",
  },
  targetParentId: "known_customer_conversation_id",
  claimMetadata: {
    source: "website-login",
  },
});

مدخل

{
  fingerprint: string;
  guestExternalId?: string | null;
  guestLocalConversationId?: string | null;
  targetParentId?: string | null;
  customerId?: string | null;
  customer?: {
    id?: string | null;
    externalId?: string | null;
    name?: string | null;
    email?: string | null;
    phone?: string | null;
    image?: string | null;
    metadata?: Record<string, unknown> | null;
  } | null;
  claimMetadata?: Record<string, unknown> | null;
}
مطلوب إما customerId أو customer.

إجابة

{
  claimed: 2,
  reparented: 1
}
claimed هو عدد المحادثات المطابقة والمرفقة بالعميل المعروف. reparented هو عدد المحادثات التابعة التي تم نقلها ضمن targetParentId.

متى تستخدمه

استخدم هذا التدفق عندما:
  • يبدأ الزائر الدردشة قبل تسجيل الدخول.
  • يقوم موقع الويب بإنشاء معرف محادثة مؤقت في وحدة التخزين المحلية.
  • يجب أن يؤدي تسجيل الدخول لاحقًا إلى ربط سجل الدردشة القديم بالعميل الحقيقي.

ملحوظات

  • يجب أن يتكون fingerprint من 8 أحرف على الأقل.
  • يجب أن ينتمي targetParentId إلى نفس مساحة العمل مثل مفتاح API.
  • يقوم API بإزالة المشاركين الضيوف فقط عندما يتمكن من استبدالهم بأمان بالعميل الحقيقي.
  • يتم الاحتفاظ بالمحادثات مع السجلات التجارية.