Pull quando serve. Push quando conta.
L'SimplyPrint API è ideale quando il sistema pone le domande. I Webhooks consentono a SimplyPrint di avvisare il sistema non appena qualcosa cambia, senza polling, processi pianificati né eventi mancati.
Eventi push anziché polling
Un webhook è un URL fornito a SimplyPrint. Ogni volta che si verifica un evento dell'account a cui si è iscritti, avvio di una stampa, errore di un lavoro, approvazione di un elemento della coda, scorte basse di un ricambio, SimplyPrint invia un HTTP POST a quell'URL con il payload dell'evento. Nessun ciclo di polling, nessuna gestione dei limiti di frequenza, nessun dubbio del tipo "ne è sfuggito uno?", solo un flusso di eventi integrabile con qualsiasi sistema che supporti HTTP.
Creare tutti i webhook necessari. Scegliere esattamente gli eventi rilevanti per ciascuno. Disattivarne uno senza eliminarlo. Consultare ogni invio nella cronologia. È lo stesso meccanismo su cui funziona il resto del web, ora connesso alla flotta di stampanti 3D.
Quattro formati di consegna: un sistema di webhook
SimplyPrint rileva automaticamente la destinazione dall'URL e formatta il payload di conseguenza. Impostando un webhook su Discord si ottiene un embed corretto con colore, campi e timestamp. Con Slack si ottiene un messaggio Slack Block Kit. Con Microsoft Teams si ottiene una scheda adattiva. Per qualsiasi altra destinazione si ottiene JSON non elaborato e pulito, utilizzabile liberamente.
Corpo POST pulito per Zapier, n8n, Make o backend personalizzato.
Incollare l'URL del webhook del canale per ottenere embed avanzati, senza bot.
Messaggi Block Kit nativi da qualsiasi webhook in entrata di Slack.
Schede adattive inviate a un flusso di lavoro Teams o a un URL del connettore.
Ogni evento generato dalla flotta, raggruppato in categorie chiare
Ogni webhook può essere sottoscritto solo agli eventi rilevanti. Un canale Discord per tutto il team potrebbe interessarsi solo a stampa completata e stampa non riuscita. Un'automazione Zapier potrebbe iscriversi a elemento della coda approvato. Una dashboard di manutenzione potrebbe richiedere ogni evento maintenance.*. La scelta è disponibile per ogni webhook.
- Eventi dei lavori di stampa: avviato, messo in pausa, ripreso, annullato, completato, non riuscito, piano di stampa liberato, oggetti saltati
- Eventi della stampante: stato AutoPrint, dimensione ugello, materiale, tag personalizzato assegnato / rimosso, stato fuori servizio, stato AI, errore rilevato dall'AI, falso positivo dell'AI, cicli massimi AutoPrint
- Eventi dell'organizzazione - stato AutoPrint dell'account, registrazione di nuovi utenti, utenti in attesa di approvazione
- Coda di stampa: elemento aggiunto, eliminato, spostato, riattivato, in attesa di approvazione, approvato, rifiutato, coda svuotata
- Filamento: creato, aggiornato, eliminato, assegnato alla stampante, dissociato
- Manutenzione - lavoro creato / avviato / completato / annullato / scaduto / riaperto / aggiornato / eliminato, problema segnalato / risolto, ricambio creato / aggiornato / eliminato, scorte rettificate, scorte basse, attività completata / ignorata, pianificazione creata / aggiornata / eliminata
- Saldo, addebitato, rimborsato, ricaricato, rettificato
- Quota: nuova richiesta, richiesta risolta, modificata, reimpostata
Un formato del payload facile da usare nel codice
Ogni consegna webhook in formato standard ha lo stesso aspetto esterno: una busta con il nome dell'event, un timestamp ISO e il webhook_id di origine, che racchiude un oggetto data la cui struttura è specifica dell'evento.
L'oggetto data di un evento job.done include il lavoro di stampa, la stampante, il file, l'utente e il tempo trascorso. Un evento filament.assigned include il filamento, la stampante e lo strumento a cui è stato assegnato. Un evento maintenance.job_overdue include l'intervento di manutenzione, la stampante, l'utente responsabile e la data di scadenza originale. Stessa struttura, dati specifici dell'evento: una sola istruzione switch nel codice gestisce l'intero flusso.
Scopri come Weshape usa Webhooks per gestire ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Testare, provare e ispezionare prima di inviare in produzione
I Webhooks dovrebbero essere semplici. SimplyPrint offre tre strumenti per renderli tali: vedere cosa verrà ricevuto, inviare un evento di prova e consultare ogni consegna già avvenuta.
Inviare un evento di prova
Inviare su richiesta un payload nella struttura reale da qualsiasi sottoscrizione.
Payload di esempio
Consultare le strutture esatte dei payload prima di scrivere codice.
Cronologia consegne
URL, stato HTTP, corpo della risposta e timestamp per ogni consegna.
Come appaiono i webhook dopo la consegna
I formati Discord, Slack e Teams vengono mostrati come schede integrate native nelle rispettive app, con titolo completo, payload strutturato in campi e miniatura opzionale della stampante. Ecco tre invii reali da una print farm che usa SimplyPrint, acquisiti direttamente da un canale Discord. Configurando il formato una volta, SimplyPrint gestisce l'integrazione.
Manutenzione scaduta
Un intervento di manutenzione programmato ha superato la data prevista: nome dell'intervento, stampante, priorità, pianificazione e gruppo, tutto in un'unica scheda.
Lavoro di manutenzione creato
È programmato un nuovo intervento di manutenzione, stampante, gruppo e priorità appaiono subito nel canale del team.
Inventario dei pezzi di ricambio
Modifiche all'inventario, componenti eliminati, scorte corrette o rifornite, inviate come eventi separati per consentire a uno strumento di workflow di reagire a ciascuna.
Verifica facoltativa del segreto, per dimostrare che la richiesta proviene davvero da SimplyPrint
Impostare un segreto per webhook e SimplyPrint lo invia con ogni consegna nell'intestazione X-SP-Secret, così il ricevitore può verificare che la richiesta provenga davvero da noi e non da un IP casuale che ha indovinato l'URL. Omettere il segreto per i webhook sulla rete interna, quando non serve. Ruotarlo quando una chiave viene esposta: le consegne precedenti restano valide, le successive usano la nuova chiave.
Ogni webhook può anche essere abilitato / disabilitato indipendentemente: basta usare l'interruttore per sospendere un'integrazione troppo attiva senza perdere la sottoscrizione agli eventi o la cronologia.
Cosa collegano davvero
Ecco gli scenari più frequenti nelle print farm, nelle scuole, nei makerspace e nei team di prodotto che usano SimplyPrint.
Pubblicare job.done e job.failed nel canale del team.
Genera fatture o avvia l'evasione quando un elemento della coda di stampa viene approvato.
Avvisare il team operativo su manutenzioni scadute o scorte basse di ricambi.
Gli insegnanti vedono gli invii degli studenti in tempo reale.
La parte push di un'esperienza completa per sviluppatori
I Webhooks si abbinano naturalmente al resto degli strumenti per sviluppatori di SimplyPrint:
- L'SimplyPrint API consente al codice di richiedere qualsiasi stato quando necessario: stampanti, coda, file, filamento, lavori.
- Webhooks consentono a SimplyPrint di inviare dati non appena qualcosa cambia, così non serve effettuare polling.
- Il SimplyPrint MCP server consente agli assistenti AI (Claude, ChatGPT) di leggere e agire sulla stessa flotta tramite un registro di strumenti verificato.
Accesso per piano: quali piani includono i webhook?
I Webhooks sono inclusi nei piani Print Farm e Enterprise, senza costi aggiuntivi. Nessun costo per webhook o consegna, nessun limite di eventi.
| Funzionalità / Limite | Gratis | Base | Pro | Print farm | Enterprise | Scuola | Cloud Slicer | Gestore del filamento |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Sistema completo di webhook multicanale: JSON normale, Discord, Slack e Microsoft Teams, con catalogo eventi completo, verifica facoltativa del segreto e cronologia di ogni consegna.
|
Vuoi saperne di più sui nostri piani?
Visualizza il confronto completo tra prezzi e funzionalitàDomande frequenti
Come inviare eventi a Discord, Slack o Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services o URL di workflow Teams, e il payload viene formattato in modo nativo per quella piattaforma. Nessuna installazione di bot, app o middleware.Quali eventi è possibile sottoscrivere?
Come verificare che una richiesta provenga da SimplyPrint?
È possibile vedere quali webhook sono stati consegnati?
È possibile testare un webhook prima dell'attivazione?
In cosa differisce dall'API SimplyPrint?
E i tentativi di nuovo invio se il server non è disponibile?
SimplyPrint riprova a effettuare le consegne non riuscite?
Per quanto tempo vengono conservati i tentativi di consegna?
Quali piani includono i webhook?
Guida passo passo alla configurazione
Per una guida alla creazione del primo webhook, incluse indicazioni specifiche per URL di Discord, Slack e Microsoft Teams, consultare l'articolo completo dell'helpdesk sui webhook.