Ana içeriğe atla
Misafir sohbeti talebinde bulunma, web sitesi sohbet akışlarının anonim ziyaretçi konuşmalarını gerçek bir müşteri profilinde birleştirmesine yardımcı olur. Bir ziyaretçi oturum açtıktan, e-postasını gönderdikten veya başka bir şekilde öğrenildikten sonra bunu kullanın.

​
Misafir Konuşmalarını Talep Edin

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",
  },
});

​
Giriş

{
  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 veya customer gereklidir.

​
Cevap

{
  claimed: 2,
  reparented: 1
}
claimed, bilinen müşteriyle eşleşen ve ona eklenen konuşmaların sayısıdır. reparented, targetParentId altında taşınan alt konuşmaların sayısıdır.

​
Ne Zaman Kullanılmalı

Bu akışı şu durumlarda kullanın:
  • Ziyaretçi oturum açmadan önce sohbete başlar.
  • Bir web sitesi yerel depolamada geçici bir konuşma kimliği oluşturur.
  • Daha sonra yapılan bir giriş, eski sohbet geçmişini gerçek müşteriye bağlayacaktır.

​
Notlar

  • fingerprint en az 8 karakter olmalıdır.
  • targetParentId, API anahtarıyla aynı çalışma alanına ait olmalıdır.
  • API, yalnızca konuk katılımcıları güvenli bir şekilde gerçek müşteriyle değiştirebildiğinde kaldırır.
  • İş kayıtlarıyla yapılan görüşmeler korunur.