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

envoyer_message

Avec compteÉcrit (confirmer)

Envoie une notification sur l’écran verrouillé des clients (via leur carte Apple Wallet ou Google Wallet). À utiliser pour annoncer une nouveauté, une offre, un événement, ou faire revenir des clients. L’audience est paramétrable (tous, habitués, perdus de vue, presque à la récompense, nouveaux, récompense à retirer, inactifs) et se combine avec des filtres (jours sans passage, tampons sur la carte, passages, date d’inscription). Texte de 180 caractères au plus, envoyé tel quel. Un seul message par jour et par commerce. Appeler d’abord avec confirmer=false : l’aperçu donne le texte exact, le nombre de destinataires et combien peuvent vraiment le recevoir, sans rien envoyer. N’appeler avec confirmer=true qu’après l’accord explicite de la personne : un message parti ne se reprend pas. Pour les messages automatiques (relance, anniversaire, rappels), utiliser regler_automatismes.

Paramètres

textestring, ≤ 180 caractèresrequis
Le texte exact de la notification, 180 caractères au plus. Il est précédé du nom du commerce sur le téléphone : inutile de le répéter.
audienceenumfacultatif
Qui reçoit le message. tous = tous les clients ; habitues = 4 passages ou plus sur 60 jours ; perdus = habitués dont l’absence dépasse une fois et demie leur rythme habituel, ou le délai du commerce sans assez d’historique (la définition de l’écran Clients) ; presque = il ne manque qu’un tampon avant la récompense ; nouveaux = inscrits depuis 30 jours (ou depuis inscrit_depuis) ; recompense_prete = une récompense gagnée, pas encore retirée ; inactifs = tout client sans passage depuis inactif_depuis_jours jours d’ouverture (par défaut le délai du commerce), habitué ou non. Toute audience autre que tous, ou tout filtre, demande la fonction « notifications ciblées ».

Valeurs : tous habitues perdus presque nouveaux recompense_prete inactifs

Défaut : "tous"

inactif_depuis_joursinteger, 1…730facultatif
Filtre : pas de passage depuis au moins N jours d’OUVERTURE (les jours fermés et les congés ne comptent pas).
actif_depuis_joursinteger, 1…730facultatif
Filtre : au moins un passage dans les N derniers jours d’ouverture.
tampons_mininteger, 0…500facultatif
Filtre : au moins N tampons sur la carte en cours.
tampons_maxinteger, 0…500facultatif
Filtre : au plus N tampons sur la carte en cours.
passages_mininteger, 1…10000facultatif
Filtre : au moins N passages au total depuis l’inscription.
inscrit_depuisstring (date)facultatif
Filtre : inscrits ce jour-là ou après (AAAA-MM-JJ).
inscrit_avantstring (date)facultatif
Filtre : inscrits avant ce jour-là (AAAA-MM-JJ, exclu).
confirmerbooleanfacultatif
false (défaut) : rend seulement un aperçu de ce qui serait fait, sans rien changer. true : exécute. Toujours montrer l’aperçu à la personne et attendre son accord avant de repasser avec true.

Défaut : false

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.

Attention : cet outil écrit. Appelé avec confirmer: false (par défaut), il rend seulement un aperçu, sans rien changer. L'assistant doit vous le montrer et attendre votre accord avant de repasser avec confirmer: true.

Mis à jour le

Cette page vous a aidé ?