Knöpfe

Unter einer Nachricht können bis zu drei Knöpfe stehen. Ein Knopf öffnet entweder einen Link, oder er meldet deinem Tool, dass du ihn getippt hast.

Du brauchst: Nachricht senden. Für Aktions-Knöpfe zusätzlich einen Webhook.

Knöpfe mitschicken

Knöpfe stehen im Feld buttons. Jeder braucht eine id und ein label:

curl https://api.packlets.app/v1/push \
  -H "Authorization: Bearer $SAMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Neue Rechnung: Hosting GmbH",
    "text": "**189,00 €**, fällig am 20.11. Freigeben?",
    "buttons": [
      {"id": "approve", "label": "Freigeben"},
      {"id": "pdf", "label": "PDF öffnen", "url": "https://example.com/rechnungen/2026-118.pdf"}
    ]
  }'

Zwei Arten

Ob ein Knopf einen Link öffnet oder eine Aktion auslöst, entscheidet allein das Feld url.

Im Beispiel oben ist „Freigeben“ ein Aktions-Knopf und „PDF öffnen“ ein Link-Knopf.

Was nach dem Tipp passiert

Tippst du einen Aktions-Knopf, passieren zwei Dinge:

1. Die Nachricht zeigt sofort, welchen Knopf du gewählt hast. Die Aktions-Knöpfe dieser Nachricht sind damit erledigt, ein zweiter Tipp geht nicht.
2. Samy schickt das Ereignis button an deinen Webhook:

{
  "type": "button",
  "packlet_id": "9d2f7c10-3a5b-4c8e-9f21-6b7d8e9f0a12",
  "message_id": "5b0c1a52-7c1e-4a43-9d0b-2f6f0c7d1e11",
  "button_id": "approve",
  "pressed_at": "2026-11-09T18:00:00.000Z"
}

button_id ist die id, die du vergeben hast. message_id ist der Wert, den du beim Senden als Antwort bekommen hast. Merk ihn dir, wenn dein Tool wissen muss, zu welcher Meldung der Tipp gehört.

Wie dein Tool das Ereignis empfängt, steht unter Webhook einrichten.

Wann lieber Elemente

Knöpfe sind für eine einmalige Antwort. Brauchst du einen Schalter, ein Eingabefeld oder einen Button, den man mehrmals drücken kann, nimm Elemente in Nachrichten.