Samy

Loslegen

Schnellstart

In fünf Minuten zur ersten Nachricht auf dem Handy.

Als Markdown öffnen

Am Ende dieser Seite hat dein Handy eine Push-Nachricht bekommen, die du selbst geschickt hast. Du brauchst die Samy-App und ein Terminal.

1. Packlet anlegen

Ein Packlet ist die Verbindung zwischen einem deiner Tools und Samy. Leg in der App eins an:

  1. Tippe oben links auf das Plus: Packlet verbinden.
  2. Wähle Mir Bescheid geben und tippe auf Weiter.
  3. Gib einen Namen ein, zum Beispiel „Test“, und such dir einen Avatar aus.
  4. Tippe auf Packlet anlegen.
Packlet verbinden: erst wählen, was dein Skript tun soll

Das Feld für die Webhook-URL bleibt leer. Die brauchst du erst, wenn dein Tool auf Knöpfe reagieren soll.

2. Schlüssel ablegen

Samy zeigt jetzt den Schlüssel deines Packlets. Er beginnt mit samy_ und ist das Passwort, mit dem dein Tool Nachrichten schicken darf.

Achtung: Den Schlüssel siehst du nur dieses eine Mal. Kopier ihn jetzt. Geht er verloren, erzeugst du in den Einstellungen des Packlets einen neuen.

Leg ihn im Terminal als Umgebungsvariable ab. So steht er nicht im Code:

Shell
export SAMY_KEY="samy_…"

3. Erste Nachricht schicken

Die App wartet jetzt auf die erste Nachricht. Schick sie:

curl https://api.packlets.app/v1/push \
  -H "Authorization: Bearer $SAMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Hallo","text":"Mein Tool ist verbunden"}'

Als Antwort kommt die Kennung der Nachricht:

JSON
{ "message_id": "5b0c1a52-7c1e-4a43-9d0b-2f6f0c7d1e11" }

4. Fertig

Die App zeigt Verbunden!, und die Nachricht steht in deinem neuen Kanal. Ist die App im Hintergrund, kommt sie als Push.

Deine erste Nachricht im Kanal

Dieselben drei Zeilen kannst du jetzt in jedes Skript einbauen: ans Ende eines Backups, in einen Cronjob, in einen Fehler-Handler.

Wenn es nicht klappt

Was du siehstUrsache
401 mit invalid_keyDer Schlüssel stimmt nicht. Prüf mit echo $SAMY_KEY, ob er vollständig ist.
400 mit invalid_bodyIm JSON fehlt text, oder es ist leer.
200, aber kein PushDie Nachricht ist da, nur der Push fehlt: Öffne den Kanal und prüf, ob Mitteilungen für Samy erlaubt sind.

Mehr dazu unter Fehlersuche.

Wie es weitergeht