# envoyer_message

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/mcp/werkzeuge/envoyer_message/

Mit Konto · Schreibt (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.

## Beispiel

Prompt : « Sag meinen Kunden, die kurz vor der Prämie stehen, dass es dieses Wochenende Mandelcroissants gibt. »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "envoyer_message",
    "arguments": {
      "texte": "Mandelcroissants dieses Wochenende: nur noch ein Stempel bis zu Ihrer Prämie!",
      "audience": "presque",
      "confirmer": false
    }
  }
}
```

```bash
curl https://app.stampywallet.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $STAMPY_JETON" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"envoyer_message","arguments":{"texte":"Mandelcroissants dieses Wochenende: nur noch ein Stempel bis zu Ihrer Prämie!","audience":"presque","confirmer":false}}}'
```

`$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun.
