Aller au contenu
StampyWalletDocs
MCP et IA / Outils avec compte / chercher_clients

chercher_clients

Avec compteLecture seule

Liste les clients du commerce selon un segment (habitués, perdus de vue, à un tampon de la récompense, récompense à offrir, nouveaux, inactifs, jamais revenus) croisé avec des filtres : prénom, tampons sur la carte, nombre de visites, date d’inscription, date de dernière visite, type de wallet ; triés et paginés. Rend pour chacun un identifiant, le prénom et l’initiale du nom, les visites, la dernière visite et l’état de la carte, jamais d’e-mail ni de téléphone. À utiliser pour « qui sont mes meilleurs clients ? », « qui n’est pas revenu ? », « qui est proche de sa récompense ? », ou pour retrouver l’identifiant d’un client avant fiche_client.

Paramètres

segmentenumfacultatif
Groupe de départ, défini comme dans l’application. tous (défaut) ; habitues = au moins 4 passages sur les 60 derniers jours ; perdus = venus au moins 4 fois, et absents depuis plus d’une fois et demie leur rythme habituel (médiane des écarts entre leurs passages), ou, sans assez d’historique, depuis plus de le délai du commerce ; congés et jours de fermeture non comptés ; presque = il ne leur manque qu’un tampon pour la récompense ; recompense_prete = une récompense gagnée, pas encore offerte, pas expirée ; nouveaux = inscrits dans les 30 derniers jours ; inactifs = aucun passage depuis plus de le délai du commerce, en jours calendaires, quel que soit leur nombre de visites ; un_seul_passage = un passage au plus : inscrits mais jamais revenus.

Valeurs : tous habitues perdus presque recompense_prete nouveaux inactifs un_seul_passage

Défaut : "tous"

recherchestring, ≤ 60 caractèresfacultatif
Morceau du prénom ou du nom (accents et casse ignorés).
tampons_mininteger, ≥ 0facultatif
Tampons au moins sur la carte en cours.
tampons_maxinteger, ≥ 0facultatif
Tampons au plus sur la carte en cours.
visites_mininteger, ≥ 0facultatif
Passages au moins depuis l’inscription (tampons de bienvenue exclus).
visites_maxinteger, ≥ 0facultatif
Passages au plus depuis l’inscription.
inactif_depuis_joursinteger, 1…3650facultatif
Aucun passage depuis au moins N jours calendaires (un client jamais venu compte depuis son inscription).
actif_depuis_joursinteger, 1…3650facultatif
Au moins un passage dans les N derniers jours.
inscrit_depuisstring (date)facultatif
Inscrit ce jour-là ou après (AAAA-MM-JJ).
inscrit_avantstring (date)facultatif
Inscrit ce jour-là ou avant (AAAA-MM-JJ).
derniere_visite_depuisstring (date)facultatif
Dernier passage ce jour-là ou après (AAAA-MM-JJ).
derniere_visite_avantstring (date)facultatif
Dernier passage ce jour-là ou avant (AAAA-MM-JJ). Exclut ceux jamais venus.
walletenumfacultatif
Où le client garde sa carte. aucun = page web, sans wallet.

Valeurs : tous apple google aucun

Défaut : "tous"

trienumfacultatif
Ordre des résultats. Défaut derniere_visite (les plus récents d’abord).

Valeurs : derniere_visite visites visites_90j tampons recompenses inscription prenom

Défaut : "derniere_visite"

ordreenumfacultatif
auto (défaut) : décroissant, sauf prenom (A→Z).

Valeurs : auto asc desc

Défaut : "auto"

limiteinteger, 1…100facultatif
Nombre maximum de résultats.

Défaut : 25

decalageinteger, ≥ 0facultatif
Nombre de résultats à sauter (pagination).

Défaut : 0

Réponse

Un texte que lit l'assistant (content), et les mêmes informations en données structurées (structuredContent). En cas de refus (paramètre à corriger, formule, rôle), la réponse porte isError: true et une phrase que l'assistant peut reformuler.

Mis à jour le

Cette page vous a aidé ?