Zum Inhalt springen

Für KI-Agenten: Das Verzeichnis der Dokumentation steht unter https://stampywallet.com/de/docs/llms.txt, die gesamte Dokumentation in einer Datei unter https://stampywallet.com/de/docs/llms-full.txt, und diese Seite gibt es als Markdown: https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_message.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
MCP und KI / Werkzeuge mit Konto / envoyer_messageAls Markdown ansehen

envoyer_message

Mit KontoSchreibt (bestätigen)

Schickt eine Benachrichtigung auf den Sperrbildschirm der Kunden (über ihre Karte in Apple Wallet oder Google Wallet). Verwenden, um eine Neuheit, ein Angebot oder ein Event anzukündigen oder Kunden zurückzuholen. Die Zielgruppe ist einstellbar (alle, Stammkunden, Weggebliebene, kurz vor der Prämie, Neue, Prämie abzuholen, Inaktive) und lässt sich mit Filtern kombinieren (Tage ohne Besuch, Stempel auf der Karte, Besuche, Anmeldedatum). Text mit höchstens 180 Zeichen, wird unverändert verschickt. Eine Nachricht pro Tag und Laden. MIT client_id (von chercher_clients): eine Nachricht nur an DIESEN Kunden, zum Beispiel „Ihre Bestellung ist fertig“ (Reinigung, Schuhmacher, Feinkost, Blumenladen): eine fertige Vorlage (modele = pret, retrait, recu, attente) oder texte + modele=libre; optional auch aussi_sms und aussi_email. Sie zählt nicht zur Tagesnachricht an alle; höchstens zwei pro Kunde und Tag. Zuerst mit confirmer=false aufrufen: Die Vorschau zeigt den genauen Text, die Anzahl der Empfänger und wie viele sie wirklich erhalten können, ohne etwas zu verschicken. Erst nach ausdrücklicher Zustimmung der Person mit confirmer=true aufrufen: Eine verschickte Nachricht lässt sich nicht zurückholen. Für automatische Nachrichten (Erinnerung, Geburtstag, Hinweise) regler_automatismes verwenden.

Parameter

texte
string, ≤ 180 Zeichen
optional
Der genaue Text der Benachrichtigung, höchstens 180 Zeichen. Auf dem Telefon steht der Name des Ladens davor: Sie müssen ihn nicht wiederholen. Pflicht ohne client_id; mit client_id nur für modele=libre.
audience
enum
optional
Wer die Nachricht bekommt. tous = alle Kunden; habitues = 4 Besuche oder mehr in 60 Tagen; perdus = Stammkunden, deren Abwesenheit das Anderthalbfache ihres üblichen Rhythmus überschreitet, oder ohne genug Verlauf die Frist des Ladens (die Definition aus der Ansicht Kunden); presque = nur noch ein Stempel bis zur Prämie; nouveaux = seit 30 Tagen angemeldet (oder seit inscrit_depuis); recompense_prete = eine verdiente Prämie, noch nicht abgeholt; inactifs = jeder Kunde ohne Besuch seit inactif_depuis_jours Öffnungstagen (standardmäßig die Frist des Ladens), Stammkunde oder nicht. Jede Zielgruppe außer tous und jeder Filter erfordert die Funktion „gezielte Benachrichtigungen“.

Werte : tous, habitues, perdus, presque, nouveaux, recompense_prete, inactifs

Standard : "tous"

inactif_depuis_jours
integer, 1…730
optional
Filter: kein Besuch seit mindestens N ÖFFNUNGStagen (Ruhetage und Urlaub zählen nicht).
actif_depuis_jours
integer, 1…730
optional
Filter: mindestens ein Besuch in den letzten N Öffnungstagen.
tampons_min
integer, 0…500
optional
Filter: mindestens N Stempel auf der aktuellen Karte.
tampons_max
integer, 0…500
optional
Filter: höchstens N Stempel auf der aktuellen Karte.
passages_min
integer, 1…10000
optional
Filter: insgesamt mindestens N Besuche seit der Anmeldung.
inscrit_depuis
string (date)
optional
Filter: an diesem Tag oder danach angemeldet (JJJJ-MM-TT).
inscrit_avant
string (date)
optional
Filter: vor diesem Tag angemeldet (JJJJ-MM-TT, ausgeschlossen).
client_id
string
optional
Kennung (UUID) EINES Kunden, geliefert von chercher_clients oder fiche_client: Die Nachricht geht nur an ihn. Schließt audience und Filter aus.
modele
enum
optional
Mit client_id: pret = „Ihre Bestellung ist fertig…“, retrait = „Ihr Artikel liegt zur Abholung bereit…“, recu = „Wir haben Ihre Bestellung erhalten…“, attente = „Ihre Bestellung wartet noch auf Sie…“, libre = der angegebene Text. Standard: libre, wenn ein Text angegeben ist.

Werte : pret, retrait, recu, attente, libre

langue
enum
optional
Mit client_id und einer Vorlage: die Sprache des fertigen Textes. Standard: die des Ladens.

Werte : fr, en, es, de

aussi_sms
boolean
optional
Mit client_id: auch per SMS (Tarif Wachstum, Monatsbudget, zwischen 8 und 20 Uhr, sonst zur Öffnung). Standard false.

Standard : false

aussi_email
boolean
optional
Mit client_id: auch per E-Mail, wenn der Kunde eine hinterlassen hat. Standard false.

Standard : false

confirmer
boolean
optional
false (Standard): liefert nur eine Vorschau dessen, was passieren würde, ohne etwas zu ändern. true: führt aus. Zeigen Sie der Person immer die Vorschau und warten Sie ihre Zustimmung ab, bevor Sie mit true erneut aufrufen.

Standard : false

Antwort

Ein Text, den der Assistent liest (content), und dieselben Informationen als strukturierte Daten (structuredContent). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort isError: true und einen Satz, den der Assistent umformulieren kann.

Achtung : Dieses Werkzeug schreibt. Mit confirmer: false (Standard) aufgerufen, liefert es nur eine Vorschau und ändert nichts. Der Assistent muss sie Ihnen zeigen und Ihre Zustimmung abwarten, bevor er es mit confirmer: true erneut aufruft.

War diese Seite hilfreich?