Guides
Identifier vos Contacts
Passez au chat l’ID de la personne connectée chez vous : elle devient un Contact vérifié, avec sa Conversation sur chacun de ses appareils.
Mis à jour le 20 octobre 2026
Les exemples affichent app_your_app_key. Ouvrez ce guide depuis Paramètres de l’App > Développeurs > Démarrage pour y voir la clé de votre App.
Sans identification, chaque appareil est un Contact anonyme. Quand une personne est connectée chez vous, passez au chat son ID dans votre app, avec son nom et son email : elle devient un Contact vérifié. Ni secret ni code sur votre serveur.
Passer la personne au chat
Ajoutez user à window.zean dans le code d’installation, avec les valeurs de la personne connectée. Si elle se connecte une fois la page chargée, appelez window.zean.identify({ id, name, email }).
<script> window.zean = { appKey: "app_your_app_key", user: { id: "1042", name: "Awa Diallo", email: "awa@example.com", phone: "+221 77 123 45 67", language: "wo" } };</script><script async src="https://widget.zean.chat/loader.js"></script>Ce que vous passez
| Nom | Type | Description |
|---|---|---|
| id | string | number | Obligatoire. Votre propre ID pour la personne, en texte ou en nombre, 200 caractères au plus. |
| name | string | Facultatif. Son nom, sur sa fiche Contact. |
| string | Facultatif, mais à passer : le code qui ajoute un autre appareil, ou qui ramène ce que la personne a écrit anonyme, part à cette adresse. | |
| phone | string | Facultatif. Son téléphone, sur sa fiche et dans le panneau Contact de la boîte de réception. |
| language | string | Facultatif. Sa langue, n’importe laquelle, en code comme wo, pt ou pt-BR. Sans elle, celle de son appareil est gardée. |
- Un détail qui ne convient pas, comme un email mal écrit, est laissé de côté, et la console dit lequel. Sans
id, la personne entière est laissée de côté. - Le tableau de bord montre la langue par son nom, par exemple « Wolof » ou « Portugais (Brésil) », dans la liste des Contacts, sur la fiche et dans le panneau Contact. Elle ne change pas la langue du chat lui-même : voir Langue.
Sur le premier appareil
Le premier appareil qui donne un ID rejoint ce Contact vérifié tout de suite. Ce que la personne y avait écrit avant, anonyme, rejoint sa Conversation. Les détails donnés par cet appareil remplissent sa fiche.
Sur un autre appareil
Un autre appareil avec le même ID ne montre pas tout de suite la Conversation. Il écrit comme son propre Contact, marqué « Non vérifié » dans le tableau de bord, et le chat propose un code au-dessus du champ de message :
- Le chat affiche « Déjà échangé avec nous sur un autre appareil ? » et le bouton « Recevoir le code ».
- Un code à 6 chiffres part à l’email enregistré sur le Contact vérifié, jamais à une adresse donnée par ce nouvel appareil. L’email porte le nom de votre App.
- La personne saisit le code dans le chat. Sur un téléphone, le clavier propose le code reçu.
- L’appareil rejoint le Contact vérifié : ses messages s’ajoutent à la Conversation.
- Un code marche 10 minutes et 5 essais, seulement sur l’appareil qui l’a demandé.
- 3 codes par heure au plus pour une personne, et 5 par appareil.
- Tant qu’il n’a pas rejoint le Contact, un appareil ne change ni le nom, ni l’email, ni le téléphone, ni la langue de la personne : ce qu’il donne reste sur son propre Contact.
Passez email. Sans email enregistré, un deuxième appareil ne peut jamais rejoindre le Contact vérifié : chaque appareil garde sa propre Conversation.
Ce qu’elle a écrit avant de se connecter
Une personne qui a écrit anonyme et laissé son email dans le chat peut ramener cette Conversation avec un code envoyé à cet email, dans les deux sens. Passez email dans user pour cela. Rien ne se fusionne sur un email identique seul.
- Connectée après avoir écrit anonyme sur un autre appareil : le chat affiche « Vous nous avez écrit avant de vous connecter ? ». Une fois le code saisi, chaque Conversation anonyme qui a donné cet email rejoint la sienne.
- Anonyme après s’être connectée ailleurs : un appareil qui donne l’email d’un Contact vérifié affiche « Déjà échangé avec nous sur un autre appareil ? ». Une fois le code saisi, il rejoint ce Contact et ce qu’il a écrit rejoint la Conversation.
- L’appareil dont la Conversation a été déplacée ne rejoint pas le Contact. Il garde l’email et propose le code à sa prochaine visite.
- « Ce n’est pas moi » refuse l’offre pour de bon sur cet appareil.
- Deux ID avec le même email sont deux Contacts vérifiés, jamais fusionnés. Un appareil anonyme qui donne cet email ne reçoit aucune offre.
- Un appareil qui a donné un
idne reçoit que le code de cet ID, jamais celui d’un email. - Les limites de codes ci-dessus s’appliquent.
Bon à savoir
- Les ID sont propres à chaque App. Le site et l’application mobile d’un même produit sont une seule App, avec une seule clé : le même ID sur les deux donne une seule personne et une seule Conversation.
- Passez l’ID seulement une fois la personne connectée chez vous : le premier appareil qui le donne rejoint son Contact.
- Pour passer d’une personne à une autre, passez le nouvel ID : la première quitte l’appareil.
- À la déconnexion, voir Déconnecter le Contact.