Abrufen, wenn du willst. Senden, wenn es zählt.
Die SimplyPrint-API ist ideal, wenn dein System Fragen stellt. Mit Webhooks teilt SimplyPrint dir sofort mit, wenn sich etwas ändert, ohne Polling, ohne geplante Jobs, ohne verpasste Ereignisse.
Ereignisse senden statt abzufragen
Ein Webhook ist eine URL, die du SimplyPrint gibst. Immer wenn in deinem Konto etwas passiert, das du abonniert hast, etwa ein Druck startet, ein Auftrag fehlschlägt, ein Warteschlangeneintrag genehmigt wird oder ein Ersatzteil knapp wird, sendet SimplyPrint einen HTTP POST mit den Ereignisdaten an diese URL. Keine Polling-Schleifen, kein Jonglieren mit Rate-Limits, kein „Haben wir das verpasst?“, nur ein Ereignisstrom, den du mit allem verbinden kannst, das HTTP spricht.
Erstelle beliebig viele Webhooks. Wähle genau die Ereignisse aus, die für jeden relevant sind. Deaktiviere einen, ohne ihn zu löschen. Prüfe jede Zustellung in der Verlaufsansicht. Das ist dieselbe Grundlage, auf der das übrige Web läuft, jetzt für deine 3D-Druckerflotte.
Vier Bereitstellungsformate, ein Webhook-System
SimplyPrint erkennt das Ziel anhand der URL automatisch und formatiert die Payload passend. Richtest du einen Webhook auf Discord, erhältst du ein korrektes Embed mit Farbe, Feldern und Zeitstempel. Richtest du ihn auf Slack, erhältst du eine Slack Block Kit-Nachricht. Richtest du ihn auf Microsoft Teams, erhältst du eine Adaptive Card. Für alles andere erhältst du sauberes rohes JSON, mit dem du machen kannst, was du möchtest.
Sauberer POST-Body für Zapier, n8n, Make oder dein eigenes Backend.
Füge eine Kanal-Webhook-URL ein und erhalte Rich Embeds ohne Bot.
Native Block-Kit-Nachrichten von jedem eingehenden Slack-Webhook.
Adaptive Karten, die an einen Teams-Workflow oder eine Connector-URL gesendet werden.
Jedes Ereignis deiner Flotte, sauber in Kategorien gruppiert
Abonniere für jeden Webhook genau die Ereignisse, die dafür wichtig sind. Ein teamweiter Discord-Kanal interessiert sich vielleicht nur für Druck abgeschlossen und Druck fehlgeschlagen. Eine Zapier-Automatisierung abonniert vielleicht Warteschlangeneintrag genehmigt. Ein Wartungsdashboard möchte vielleicht jedes maintenance.*-Ereignis. Du entscheidest das pro Webhook.
- Druckauftragsereignisse: gestartet, pausiert, fortgesetzt, abgebrochen, abgeschlossen, fehlgeschlagen, Druckbett geräumt, Objekte übersprungen
- Druckerereignisse: AutoPrint-Status, Düsengröße, Material, benutzerdefiniertes Tag zugewiesen / entfernt, Außer-Betrieb-Status, KI-Status, fehlgeschlagener Druck per KI erkannt, KI-Fehlalarm, AutoPrint-Maximalzyklen
- Organisationsereignisse - AutoPrint-Status des Kontos, Registrierung neuer Nutzer, ausstehende Nutzerfreigabe
- Druckwarteschlange: Eintrag hinzugefügt, gelöscht, verschoben, reaktiviert, Genehmigung ausstehend, genehmigt, abgelehnt, Warteschlange geleert
- Filament, erstellt, aktualisiert, gelöscht, einem Drucker zugewiesen, Zuweisung aufgehoben
- Wartung - Wartungsauftrag erstellt / gestartet / abgeschlossen / storniert / überfällig / wiedereröffnet / aktualisiert / gelöscht, Problem gemeldet / gelöst, Ersatzteil erstellt / aktualisiert / gelöscht, Bestand angepasst, niedriger Bestand, Aufgabe abgeschlossen / übersprungen, Zeitplan erstellt / aktualisiert / gelöscht
- Guthaben, belastet, erstattet, aufgeladen, angepasst
- Kontingent: neue Anfrage, Anfrage abgeschlossen, angepasst, zurückgesetzt
Eine Payload-Struktur, für die sich leicht Code schreiben lässt
Jede Webhook-Zustellung im regulären Format sieht von außen gleich aus: ein Umschlag mit dem Namen des event, einem ISO-timestamp und der auslösenden webhook_id, der ein data-Objekt enthält, dessen Struktur vom Ereignis abhängt.
Das data-Objekt für ein job.done-Ereignis enthält Druckauftrag, Drucker, Datei, Benutzer und verstrichene Zeit. Ein filament.assigned-Ereignis enthält das Filament, den Drucker und das Werkzeug, dem es zugeordnet wurde. Ein maintenance.job_overdue-Ereignis enthält den Auftrag, den Drucker, den verantwortlichen Benutzer und das ursprüngliche Fälligkeitsdatum. Das Nachrichtenformat bleibt gleich, die Daten sind ereignisspezifisch. So verarbeitet eine einzige switch-Anweisung in deinem Code den gesamten Datenstrom.
Erfahre, wie Weshape mit Webhooks ~50 printers betreibt
Order queueing is a webhook that feeds into the SimplyPrint API.
Testen, Beispieldaten prüfen und inspizieren, bevor du etwas produktiv schaltest
Webhooks sollen langweilig sein. SimplyPrint gibt dir drei Tools, damit sie es sind: Prüfe, was du erhältst, löse einen Test aus und sieh dir jede bereits erfolgte Zustellung an.
Testereignis senden
Sende bei Bedarf über jedes Abonnement einen Payload im echten Format.
Beispiel-Payloads
Sieh dir die exakten Payload-Strukturen an, bevor du Code schreibst.
Zustellverlauf
URL, HTTP-Status, Antworttext und Zeitstempel für jede Zustellung.
Wie deine Webhooks nach der Zustellung aussehen
Die Formate für Discord, Slack und Teams werden in diesen Apps als native Embed-Karten dargestellt, mit aussagekräftigem Titel, strukturierten Nutzdaten und optionalem Drucker-Vorschaubild. Hier sind drei echte Zustellungen aus einer Druckfarm mit SimplyPrint, direkt aus einem Discord-Kanal aufgenommen. Konfiguriere das Format einmal, SimplyPrint kümmert sich um die Einbettung.
Wartung überfällig
Ein geplanter Wartungsauftrag ist überfällig: Auftragsname, Drucker, Priorität, Zeitplan und Gruppe in einer Karte.
Wartungsauftrag erstellt
Ein neuer Wartungsauftrag ist geplant, Drucker, Gruppe und Priorität erscheinen sofort in deinem Teamkanal.
Ersatzteilbestand
Bestandsänderungen: Teile werden gelöscht, der Bestand angepasst oder aufgefüllt. Jede Änderung wird als separates Ereignis übermittelt, damit ein Workflow-Tool darauf reagieren kann.
Optionale Secret-Prüfung, bestätige, dass die Anfrage wirklich von SimplyPrint stammt
Lege pro Webhook ein Secret fest. SimplyPrint sendet es bei jeder Zustellung im Header X-SP-Secret. So kann dein Empfänger prüfen, ob die Anfrage wirklich von uns stammt und nicht von jemandem, der von irgendeiner IP-Adresse aus deine URL erraten hat. Bei Webhooks im internen Netzwerk kannst du das Secret weglassen, wenn du es nicht brauchst. Ersetze das Secret, sobald es offengelegt wurde. Frühere Zustellungen werden dadurch nicht ungültig, künftige verwenden den neuen Schlüssel.
Jeder Webhook kann außerdem unabhängig aktiviert / deaktiviert werden. Lege den Schalter um, um eine störende Integration zu pausieren, ohne ihr Event-Abonnement oder ihren Verlauf zu verlieren.
Was Nutzer wirklich verbinden
Das sind die Muster, die wir am häufigsten bei Druckfarmen, Schulen, Makerspaces und Produktteams sehen, die SimplyPrint nutzen.
Sende job.done und job.failed an den Kanal deines Teams.
Rechnungen oder Auftragsabwicklung auslösen, wenn ein Eintrag in der Druckwarteschlange genehmigt wird.
Informiere den Betrieb bei überfälliger Wartung oder geringem Ersatzteilbestand.
Zeige Lehrkräften die Einreichungen von Schülern in Echtzeit.
Der Push-Teil einer vollständigen Entwicklerlösung
Webhooks ergänzen die übrigen Entwicklerfunktionen von SimplyPrint ideal:
- Über die SimplyPrint-API kann dein Code bei Bedarf beliebige Zustandsdaten per Pull abrufen: Drucker, Druckwarteschlange, Dateien, Filament und Aufträge.
- Webhooks lassen SimplyPrint Änderungen sofort pushen, damit du nicht danach pollen musst.
- Mit dem SimplyPrint MCP-Server können KI-Assistenten wie Claude und ChatGPT über eine geprüfte Tool-Registry Daten derselben Druckerflotte lesen und dort Aktionen ausführen.
Tarife: In welchen Tarifen sind Webhooks enthalten?
Webhooks sind in den Tarifen Print Farm und Enterprise ohne Aufpreis enthalten. Keine Gebühr pro Webhook oder Zustellung, keine Eventlimits.
| Funktion / Limit | Kostenlos | Einfach | Pro | Druckfarm | Enterprise | Schule | Cloud Slicer | Filament-Manager |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Vollständiges Mehrkanal-Webhook-System: normales JSON, Discord, Slack und Microsoft Teams, mit vollständigem Ereigniskatalog, optionaler Secret-Prüfung und Zustellverlauf.
|
Möchtest du mehr über unsere Tarife erfahren?
Vollständigen Preis- und Funktionsvergleich anzeigenHäufig gestellte Fragen
Wie sende ich Ereignisse an Discord, Slack oder Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services oder eine Teams-Workflow-URL, und formatieren die Nutzlast passend für die jeweilige Plattform. Keine Bot-Installation, keine App, keine Middleware.Welche Events kann ich abonnieren?
Wie prüfe ich, ob eine Anfrage wirklich von SimplyPrint stammt?
Kann ich sehen, was zugestellt wurde?
Kann ich einen Webhook vor dem Livegang testen?
Worin unterscheidet sich das von der SimplyPrint-API?
Was ist mit Wiederholungen, wenn mein Server nicht erreichbar ist?
Versucht SimplyPrint fehlgeschlagene Zustellungen erneut?
Wie lange werden Zustellversuche gespeichert?
Welche Tarife enthalten Webhooks?
Schritt-für-Schritt-Einrichtungsanleitung
Eine Anleitung für deinen ersten Webhook, einschließlich Details zu Discord-, Slack- und Microsoft-Teams-URLs, findest du im vollständigen Helpdesk-Artikel zu Webhooks.