Webhooks

Ereignisse in Echtzeit an deine Systeme — signiert und wiederholbar.

Webhooks benachrichtigen dein System in Echtzeit über Ereignisse in Astreo — z. B. wenn eine neue Nachricht eintrifft oder ein Thread zugewiesen wird. So baust du Automatisierungen, ohne ständig zu pollen.

Einrichtung

Lege in den Einstellungen ein Webhook-Abonnement an:

• Ziel-URL: ein öffentlich erreichbarer HTTPS-Endpunkt deines Systems.
• Ereignisse: wähle die Typen, die du empfangen willst.
• Secret: wird zur Signaturprüfung verwendet (siehe unten) — sicher aufbewahren.

Ereignistypen

Astreo sendet Ereignisse rund um Posteingang und Zusammenarbeit (z. B. neue Nachricht, Thread zugewiesen, Status geändert). Die genau verfügbaren Typen siehst du beim Anlegen des Abonnements. Jede Zustellung ist ein JSON-Payload mit Ereignistyp und den betroffenen Objekt-IDs.

Signaturprüfung (HMAC)

Jede Auslieferung ist mit deinem Secret HMAC-signiert und trägt die Signatur in einem HTTP-Header. Prüfe sie bei Empfang, bevor du den Payload verarbeitest, um die Echtheit sicherzustellen:

// Node.js (Beispiel)
const crypto = require('crypto');
const expected = crypto.createHmac('sha256', SECRET)
  .update(rawBody)            // den ROHEN Request-Body verwenden
  .digest('hex');
// expected zeitkonstant mit der Header-Signatur vergleichen

Verwende den unveränderten Rohtext des Bodys — nicht das geparste JSON.

Zustellung & Wiederholung

• Antworte mit 2xx, sobald du das Ereignis angenommen hast (idealerweise schnell, Verarbeitung asynchron).
• Bei Fehlern oder Timeouts wiederholt Astreo die Zustellung mit Backoff.
• Mache deinen Endpunkt idempotent — dasselbe Ereignis kann mehr als einmal ankommen.