👥 Contacts
Les Contacts sont les enregistrements clients dans PulseHub. Chaque conversation est liée à un contact, et chaque message entrant correspond à un contact existant ou en crée un nouveau.
Champs du Contact
| Champ | Description |
|---|---|
name | Nom d'affichage — extrait des données du fournisseur ou saisi manuellement |
email | Adresse email — utilisée pour faire correspondre les expéditeurs d'emails entrants |
phone | Numéro de téléphone — utilisé pour faire correspondre les expéditeurs WhatsApp et SMS |
tags | Tableau JSON de chaînes de tags pour la segmentation |
notes | Champ texte libre pour les notes de l'agent |
external_ids | Objet JSON mappant les types de canaux aux IDs spécifiques du fournisseur |
Correspondance des Contacts (Auto-Déduplication)
Quand un nouveau message entrant arrive :
- Si sender_phone est présent : correspondance par
contacts.phone - Sinon si sender_email est présent : correspondance par
contacts.email - Sinon : correspondance par chemin JSON
external_ids - Si aucune correspondance : créer un nouveau contact
Quand une correspondance est trouvée, PulseHub met à jour le champ external_ids pour unifier le client à travers les canaux.
Tags
- Tags de contact décrivent la personne :
[vip, enterprise, newsletter] - Tags de conversation décrivent le problème :
[urgent, billing, bug-report]
Les deux sont stockés comme des tableaux JSON.
Référence des IDs Externes
| Clé | Source |
|---|---|
whatsapp | Numéro de téléphone de l'expéditeur |
telegram_chat_id | chat.id Telegram |
viber | sender.id Viber |
facebook | PSID Facebook |
instagram | PSID Instagram |
sms | Numéro de téléphone de l'expéditeur |