Alapértelmezés szerint a Yaplet minden böngésző-munkamenetet névtelen látogatóként kezel. Ez azt jelenti, hogy a csapatod „Látogató 1234"-et lát valódi név helyett, és ugyanaz az ügyfél minden bejelentkezéskor új beszélgetést kezd. Ha egyszer meghívod a Yaplet.identify()-t
munkamenetenként, ez megoldódik: a widget megjeleníti a felhasználó nevét, összekapcsolja az összes korábbi beszélgetését, és lehetővé teszi az inbox szűrését csomag, vállalat vagy bármilyen egyedi tulajdonság alapján.
Előfeltételek
- A Yaplet kódrészlet már telepítve van. Ha még nem, kezdd itt: A Yaplet telepítése JavaScript-kódrészlettel.
- Van egy szerveroldali munkamenet, amely ismeri az aktuális felhasználó azonosítóját és e-mail-címét.
Alaphasználat
Hívd meg a Yaplet.identify()-t az oldal betöltése után, amikor a felhasználói munkamenet már elérhető. Add meg a felhasználó egyedi azonosítóját első argumentumként, és az adatait tartalmazó objektumot másodikként:
Yaplet.identify("user-123", {
name: "Kiss Éva",
email: "[email protected]",
phone: "+36 30 123 4567",
createdAt: new Date("2024-03-15"),
plan: "pro",
companyId: "pelda-001",
companyName: "Példa Kft.",
});A userId (az első argumentum) kivételével minden mező opcionális, de minél több adatot küldesz, annál több kontextust kap a csapatod egy-egy beérkező beszélgetésnél.
Szabványos mezők
| Mező | Típus | Leírás |
|---|---|---|
name |
string | Teljes név, amely az inboxban és a látogatói profilon jelenik meg. |
email |
string | Kapcsolattartási e-mail-cím. Lehetővé teszi az e-mailes utókövetést a chat után. |
phone |
string | Telefonszám E.164 formátumban (pl. +36301234567). |
value |
number | Élettartam-érték a te valutádban. A látogatói oldalsávon jelenik meg. |
companyId |
string | Belső vállalatazonosító B2B szűréshez. |
companyName |
string | Vállalat megjelenített neve. |
plan |
string | Előfizetési csomag neve (pl. "free", "pro", "enterprise"). |
sla |
number | Cél válaszidő órában ennél a felhasználónál. Kiemeli az SLA-érzékeny beszélgetéseket. |
createdAt |
Date | A felhasználó regisztrációjának dátuma. Kohorsz-alapú támogatási szabályokhoz hasznos. |
Egyedi attribútumok
Minden adat, amely nem fér bele a szabványos mezőkbe, a customData-ba kerülhet. Ezek szabad formátumú kulcs-érték párok:
Yaplet.identify("user-123", {
name: "Kiss Éva",
email: "[email protected]",
customData: {
subscriptionStatus: "trialing",
trialEndsAt: "2026-06-15",
accountRegion: "EU",
featureFlagsEnabled: ["ai-phone", "affiliate"],
},
});Az egyedi attribútumok megjelennek a látogatói oldalsávon az inboxban, és a csapatod szűrhet is rájuk.
Hol hívd meg az identify()-t?
Hívd meg azonnal, amint az alkalmazásod tudja, ki az aktuális felhasználó – jellemzően az autentikáció ellenőrzése után. Egyoldalas alkalmazásokban általában a gyökérkomponensben vagy az auth store-ban a legjobb hely. Szerveroldali renderelés esetén inline is elhelyezheted az oldal válaszában.
A Yaplet.identify()-t bármikor meghívhatod a kódrészlet futása után – akár az SDK teljes betöltése előtt is. A kódrészlet sorba állítja a hívást, és az SDK betöltése után végrehajtja.
Kijelentkezés
Amikor egy felhasználó kijelentkezik az alkalmazásodból, töröld a Yaplet azonosítást, hogy a következő látogató ne örökölje a beszélgetési előzményeit:
Yaplet.clearIdentity();Mi a következő lépés?
Ha az azonosítás be van állítva, a csapatod már akkor tudja, kivel beszél, amikor egy új beszélgetés érkezik. Ellenőrizd, hogy minden rendben működik-e: Telepítés ellenőrzése.