Personnes (CRM)
Trouver un client, consulter la conversation, ajouter une étiquette et enregistrer un téléphone ou d’autres informations. Fiches, filtres et export.
Sur cette page
La section Personnes regroupe les clients qui ont écrit au bot. Ouvrez une fiche pour voir la conversation, les fichiers et les informations enregistrées, par exemple un téléphone, un cours demandé ou un état de paiement. Les fiches sont créées et mises à jour automatiquement à partir des événements.
On appelle cette base de clients un CRM. Les étiquettes permettent d’isoler un groupe comme « A payé » ; les paramètres gardent des valeurs précises comme phone ou order_id.
Liste des utilisateurs
Le tableau montre le nom, l’ID Telegram, les étiquettes et l’activité, notamment la dernière visite ou le blocage du bot. Recherchez par nom ou ID et utilisez Tous, VIP, A payé, Nouveau et Désabonné. Chaque filtre indique le nombre de personnes. Cliquez sur une ligne pour ouvrir la conversation.
Ont bloqué le bot filtre ceux qui l’ont bloqué ; la date figure dans leur fiche. Exporter en CSV télécharge la liste filtrée et recherchée, limitée à 10 000 lignes. Le fichier s’ouvre dans un tableur. Il contient tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels ; les étiquettes sont séparées par ; et les dates sont au format RFC3339. Les cellules texte sont protégées contre l’exécution comme formule. Si la limite est atteinte, l’API renvoie X-Export-Truncated: true. Route API : GET /api/bots/{botID}/users?is_blocked=true&format=csv. is_blocked=true|false fonctionne aussi pour la liste JSON, où blocked_at est présent pour les utilisateurs concernés.
Données conservées sur un utilisateur
La fiche contient l’avatar, le nom, @username, un lien Ouvrir dans Telegram, les compteurs de messages et de première et dernière conversation, les étiquettes et les paramètres globaux. Elle indique aussi si la personne a bloqué le bot ou attend un opérateur.
La source de l’abonné indique le lien par lequel il est arrivé la première fois. Un lien distinct pour une campagne de printemps, par exemple, permet de distinguer ses visiteurs. Les marqueurs publicitaires sont appelés UTM. Dans Telegram, la partie ajoutée après start= est le payload, ou marqueur de démarrage.
Exemples de formats :
- Telegram :
t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring. Le payload Telegram n’accepte que lettres, chiffres,_et-;__sépare les paires et le premier-sépare clé et valeur. - VK :
vk.me/<group>?ref=utm_source=vk&utm_medium=post. - Lien de parrainage :
t.me/<bot>?start=ref_<son ID>. La fiche et{{referrals.count}}montrent combien de personnes l’abonné a invitées.ref=<ID>etref_<ID>sont analysés séparément des UTM.
Cinq champs sont gardés : utm_source, utm_medium, utm_campaign, utm_content et utm_term. Pour chacun, la première valeur non vide est retenue. Ils sont disponibles dans les substitutions et les segments sous attribution.utm_source … utm_term.
La source est figée au premier lien de démarrage muni d’un marqueur non vide. C’est l’attribution au premier contact. Un /start ultérieur ne change pas la source et n’ajoute pas d’UTM du nouveau lien. Si le premier marqueur était libre ou de parrainage, les UTM restent vides. Un lien sans marqueur ne fixe aucune source.
Dans un segment, les UTM du lien priment sur les marqueurs de visite du site portant le même nom. Les champs absents du lien sont pris dans les données web ; un lien sans aucun UTM ne les efface pas. La source appartient au canal du premier démarrage et n’entre dans le segment, après recalcul, que pour l’abonné ayant le même identifiant dans ce canal.
Étiquettes
Une étiquette permet de regrouper les abonnés : « VIP », « A payé », « Nouveau » ou « Désabonné ». Vous pouvez créer vos propres étiquettes et choisir leur couleur. Ajoutez-les à la main ou avec Modifier les étiquettes, puis utilisez-les dans les conditions « Avec étiquettes » ou pour choisir l’audience d’une diffusion.
Une étiquette peut être permanente ou durer un nombre de jours. À l’échéance, elle est retirée automatiquement et le bot reçoit « Étiquette expirée ». Par API, utilisez POST /api/bots/{botID}/users/{tgUserID}/labels avec un UUID canonique label_id et éventuellement ttl_days de 0 à 106751. ttl_days: 0 signifie permanente ; l’expiration d’une étiquette temporaire figure dans label_expires_at de la liste des personnes.
Paramètres
Les paramètres conservent des valeurs liées à l’utilisateur, comme nom, email, somme, état d’une commande ou points. Ils sont renseignés par Modifier les paramètres, Enregistrer le message et les étapes de conversation. Vous pouvez ensuite les employer dans les substitutions, par exemple {{param.clé}}, et les conditions « Avec paramètres ». Le bot dispose ainsi d’un profil client simple sans base externe.
Conversations
Une conversation affiche textes, photos, vidéos, messages vocaux, documents, boutons et états de livraison. Les réactions envoyées apparaissent sur des fiches distinctes. En bas, vous pouvez répondre, joindre un fichier ou envoyer une réaction choisie dans la liste.
Pièces jointes
Pièces jointes ouvre la galerie des fichiers de la conversation, avec les filtres Photos, Fichiers, Vocaux, Liens et Tout télécharger.
Historique et import des conversations
L’intégralité de la conversation avec l’utilisateur est conservée. Les messages anciens se chargent quand vous remontez le fil ; un long historique s’ouvre donc sans attendre son chargement complet. Les nouveaux messages arrivent immédiatement dans la conversation ouverte, comme dans la file des opérateurs.
Si vous migrez un bot depuis sambot, l’historique est importé avec les utilisateurs. Les conversations et pièces jointes passées sont visibles dans la fiche dès la fin de l’import. Voir Importer depuis sambot.
Fiche client et actions groupées
La fiche réunit le profil, l’historique des événements (timeline), les segments, la conversation et les notes d’opérateur. L’historique se charge par morceaux et se filtre par type, source et période. Après modification des propriétés et étiquettes, enregistrez : les changements iront au journal et déclencheront la mise à jour des segments.
Dans la liste, sélectionnez des clients pour appliquer une propriété en masse. L’opération utilise un instantané enregistré de l’audience choisie, est limitée à 5 000 personnes et peut être renvoyée sans doublon. L’export CSV crée une opération enregistrée distincte, annulable avant le téléchargement. Une modification groupée déjà appliquée n’est pas annulée partiellement.
Fusionner les profils
Le propriétaire du projet peut sélectionner deux personnes sur la même page et choisir Fusionner les profils. Vérifiez les contacts et les canaux, choisissez le profil principal et confirmez. Les données et historiques sont réunis ; en cas de conflit, le profil principal prévaut. La fusion est irréversible.
Terminez ou examinez d’abord toute synchronisation CRM ou opération Ozma en attente. Résolvez les contacts contradictoires et les liens vers des fiches CRM différentes.
Une adresse e-mail identique ne fusionne pas automatiquement les profils. Utilisez identify signé pour lier un utilisateur connecté du site ; La liaison Telegram confirmée est disponible uniquement si la fonction est activée dans la région ; connecter le canal ne suffit pas.
Pour aller plus loin
- Chats et opérateurs : file des opérateurs et transfert de conversation.
- Conditions et chats : filtres par étiquettes et paramètres.
- Diffusions : envois segmentés aux abonnés.
- Importer depuis sambot : transfert de l’historique.
Segments dynamiques
Dans Segments, définissez une audience par des conditions liées par ET ou OU. Vérifiez sa définition dans l’aperçu avant d’enregistrer. Après tout changement, recalculez les membres et vérifiez que le segment est prêt avant de l’utiliser dans une diffusion : enregistrer la définition ne garantit pas que le nombre de membres est à jour.