Interrogez à la demande. Recevez les événements importants.
L’API SimplyPrint est idéale lorsque votre système pose les questions. Les Webhooks permettent à SimplyPrint de vous informer vous dès que quelque chose change, sans interrogation répétée, sans tâches planifiées, sans événements manqués.
Événements envoyés au lieu d’interrogations régulières
Un webhook est une URL que vous fournissez à SimplyPrint. Chaque fois qu’un événement auquel vous êtes abonné survient dans votre compte, par exemple le démarrage d’une impression, l’échec d’une impression, l’approbation d’un élément de la file d’impression ou le faible stock d’une pièce de rechange, SimplyPrint envoie une requête HTTP POST à cette URL avec les données de l’événement. Pas de boucles d’interrogation, de gestion des limites de débit ou de « avons-nous raté celui-ci ? », seulement un flux d’événements que vous pouvez connecter à tout système compatible HTTP.
Créez autant de webhooks que nécessaire. Choisissez précisément les événements qui intéressent chacun. Désactivez-en un sans le supprimer. Consultez chaque envoi dans l’historique. C’est le même mécanisme que celui sur lequel repose le web, désormais relié à votre parc d’imprimantes 3D.
Quatre formats de livraison, un système de webhooks
SimplyPrint détecte automatiquement la destination à partir de l’URL et formate la charge utile en conséquence. Dirigez un webhook vers Discord et vous obtenez un embed avec couleur, champs et horodatage. Dirigez-le vers Slack et vous obtenez un message Slack Block Kit. Dirigez-le vers Microsoft Teams et vous obtenez une carte adaptative. Dirigez-le vers toute autre destination et vous obtenez du JSON brut propre, à utiliser comme vous le souhaitez.
Corps de requête POST propre pour Zapier, n8n, Make ou votre propre backend.
Collez l’URL du webhook d’un canal pour obtenir des aperçus enrichis, sans bot.
Messages Block Kit natifs depuis tout webhook entrant Slack.
Cartes adaptatives envoyées vers un flux de travail Teams ou une URL de connecteur.
Chaque événement généré par votre flotte, regroupé en catégories claires
Abonnez chaque webhook exactement aux événements qui le concernent. Un canal Discord d’équipe peut ne s’intéresser qu’à impression terminée et impression échouée. Une automatisation Zapier peut s’abonner à élément de la file d’impression approuvé. Un tableau de bord de maintenance peut nécessiter chaque événement maintenance.*. Vous décidez pour chaque webhook.
- Événements liés aux travaux d’impression - démarrage, pause, reprise, annulation, fin, échec, plateau dégagé, objets ignorés
- Événements d’imprimante - état AutoPrint, taille de buse, matériau, étiquette personnalisée attribuée / retirée, état hors service, état IA, échec détecté par l’IA, faux positif de l’IA, nombre maximal de cycles AutoPrint
- Événements d’organisation - état AutoPrint du compte, inscription de nouvel utilisateur, utilisateur en attente d’approbation
- File d’impression - élément ajouté, supprimé, déplacé, réactivé, en attente d’approbation, approuvé, refusé, file vidée
- Filament : créé, mis à jour, supprimé, attribué à une imprimante, retiré d’une imprimante
- Maintenance - intervention créée / démarrée / terminée / annulée / en retard / rouverte / mise à jour / supprimée, problème signalé / résolu, pièce détachée créée / mise à jour / supprimée, stock ajusté, stock faible, tâche terminée / ignorée, planification créée / mise à jour / supprimée
- Solde : débité, remboursé, rechargé, ajusté
- Quota - nouvelle demande, demande traitée, ajustement, réinitialisation
Une structure de données facile à utiliser dans le code
Chaque livraison de webhook au format standard se présente de la même façon : une enveloppe contenant le champ event, un timestamp ISO et le webhook_id d’origine, qui enveloppe un objet data dont la structure est propre à l’événement.
L’objet data d’un événement job.done comprend la tâche d’impression, l’imprimante, le fichier, l’utilisateur et le temps écoulé. Un événement filament.assigned comprend le filament, l’imprimante et l’outil auquel il a été attribué. Un événement maintenance.job_overdue comprend l’intervention, l’imprimante, l’utilisateur responsable et la date d’échéance d’origine. Même enveloppe, données propres à l’événement : une seule instruction switch dans votre code gère ainsi tout le flux.
Weshape, ~50 printers filosunu yönetmek için Webhooks özelliğini nasıl kullanıyor, görün
Order queueing is a webhook that feeds into the SimplyPrint API.
Tester, échantillonner et inspecter avant d’envoyer quoi que ce soit en production
Les Webhooks devraient être simples. SimplyPrint vous donne trois outils pour qu’ils le soient réellement : consultez ce que vous recevrez, effectuez un envoi de test et retrouvez chaque envoi déjà effectué.
Envoyer un événement de test
Envoyez à la demande une charge utile au format réel depuis n’importe quel abonnement.
Exemples de charges utiles
Consultez la structure exacte des payloads avant d’écrire le moindre code.
Historique des livraisons
URL, statut HTTP, corps de réponse et horodatage de chaque livraison.
À quoi ressemblent vos webhooks une fois livrés
Les formats Discord, Slack et Teams s’affichent sous forme de cartes intégrées natives dans ces applications, avec titre enrichi, données par champ et miniature d’imprimante facultative. Voici trois notifications réelles d’une ferme d’impression utilisant SimplyPrint, capturées directement dans un canal Discord. Configurez le format une fois, SimplyPrint s’occupe de l’intégration.
Maintenance en retard
Une intervention de maintenance planifiée a dépassé son échéance : nom de l’intervention, imprimante, priorité, calendrier, groupe, tout sur une seule carte.
Intervention de maintenance créée
Une nouvelle intervention de maintenance est planifiée : imprimante, groupe et priorité apparaissent immédiatement dans le canal de votre équipe.
Inventaire des pièces détachées
Modifications d’inventaire, suppression de pièces, ajustement de stock et réapprovisionnement, transmises comme événements distincts afin qu’un outil d’automatisation puisse réagir à chacune.
Vérification facultative du secret, prouve que la requête vient bien de SimplyPrint
Définissez un secret par webhook, et SimplyPrint l’envoie avec chaque livraison dans l’en-tête X-SP-Secret, afin que votre récepteur puisse vérifier que la requête vient bien de nous, plutôt que d’une IP inconnue ayant deviné votre URL. Ignorez le secret pour les webhooks du réseau interne lorsque vous n’en avez pas besoin. Renouvelez-le dès qu’une clé fuit, les livraisons passées restent valides, les futures utilisent la nouvelle clé.
Chaque webhook peut aussi être activé ou désactivé indépendamment. Basculez l’interrupteur pour mettre en pause une intégration trop bavarde sans perdre son abonnement aux événements ni son historique.
Ce que les utilisateurs mettent vraiment en place
Voici les cas d’usage que nous observons le plus souvent dans les fermes d’impression, les écoles, les makerspaces et les équipes produit utilisant SimplyPrint.
Publiez job.done et job.failed dans le canal de votre équipe.
Déclenchez la facturation ou le traitement de la commande lorsqu’un élément de la file d’impression est approuvé.
Alertez l’équipe opérationnelle en cas de maintenance en retard ou de faible stock de pièces détachées.
Faites remonter les soumissions des élèves aux enseignants en temps réel.
La partie push d’une expérience développeur complète
Les Webhooks s’intègrent naturellement au reste de l’interface développeur SimplyPrint :
- L’API SimplyPrint permet à votre code de récupérer n’importe quel état à la demande : imprimantes, file, fichiers, filament, impressions.
- Les Webhooks permettent à SimplyPrint d’envoyer les données dès qu’un changement se produit : vous n’avez donc pas à vérifier en permanence si quelque chose a changé.
- Le serveur MCP SimplyPrint permet aux assistants IA (Claude, ChatGPT) de consulter et d’agir sur ce même parc via un registre d’outils validé.
Accès par forfait : quels forfaits incluent les webhooks ?
Les Webhooks sont inclus dans les offres Print Farm et Enterprise, sans frais supplémentaires. Aucun frais par Webhook ni par envoi, aucune limite d’événements.
| Özellik / sınır | Ücretsiz | Basic | Pro | Baskı çiftliği | Kurumsal | Okul | Bulut slicer | Filament yöneticisi |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Système complet de webhooks multicanal : JSON standard, Discord, Slack et Microsoft Teams, avec le catalogue complet d’événements, une vérification par secret facultative et l’historique de chaque livraison.
|
Planlarımız hakkında daha fazla bilgi ister misiniz?
Tam fiyat ve özellik karşılaştırmasını görüntüleQuestions fréquentes
Comment envoyer des événements à Discord, Slack ou Microsoft Teams ?
discord.com/api/webhooks, hooks.slack.com/services ou de flux de travail Teams) et formatons les données nativement pour cette plateforme. Aucun bot à installer, aucune application, aucun middleware.À quels événements puis-je m’abonner ?
Comment vérifier qu’une requête provient bien de SimplyPrint ?
Puis-je voir ce qui a été livré ?
Puis-je tester un webhook avant sa mise en service ?
En quoi cela diffère-t-il de l’API SimplyPrint ?
Qu’en est-il des nouvelles tentatives si mon serveur est indisponible ?
SimplyPrint réessaie-t-il les livraisons échouées ?
Combien de temps les tentatives de livraison sont-elles conservées ?
Quels forfaits incluent les webhooks ?
Guide de configuration pas à pas
Pour un guide de création de votre premier webhook, avec notamment les spécificités des URL Discord, Slack et Microsoft Teams, consultez l’article complet du centre d’aide sur les webhooks.