Nachrichten

Knöpfe

Mit Knöpfen öffnest du Links oder bedienst dein Tool direkt vom Handy.

Eine Nachricht kann bis zu drei Knöpfe haben. Du gibst sie im Feld buttons an.

Zwei Arten

Link-Knopf (mit url): öffnet die Adresse auf dem Handy.
Aktions-Knopf (ohne url): Samy meldet den Tipp an die Webhook-URL deines Packlets. So bedienst du dein Tool vom Handy aus. Dafür muss beim Packlet eine Webhook-URL eingetragen sein.

Felder eines Knopfs

Feld	Typ	Pflicht	Bedeutung
`id`	Text, 1 bis 64 Zeichen	ja	Deine Kennung für den Knopf. Pro Nachricht eindeutig. Sie kommt im Webhook als `button_id` zurück.
`label`	Text, 1 bis 40 Zeichen	ja	Beschriftung.
`url`	http(s)-Adresse	nein	Macht aus dem Knopf einen Link-Knopf.

Beispiel

Shell

curl https://api-production-e537a.up.railway.app/v1/push \
  -H "Authorization: Bearer $SAMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Neue Bestellung #1042",
    "text": "2× Kaffeebecher, 89,00 €",
    "buttons": [
      {"id": "label", "label": "Versandlabel drucken"},
      {"id": "open", "label": "Details", "url": "https://shop.example.com/orders/1042"}
    ]
  }'

Der erste Knopf ist ein Aktions-Knopf, der zweite ein Link-Knopf. Nach dem Tipp zeigt die Nachricht in der App, welcher Knopf gedrückt wurde.