Extrae cuando quieras. Envía cuando importe.
La API de SimplyPrint es ideal cuando tu sistema hace las preguntas. Los Webhooks son la forma en que SimplyPrint te informa a ti en cuanto algo cambia, sin sondeos periódicos, sin trabajos programados ni eventos perdidos.
Recibe eventos en lugar de hacer sondeos
Un webhook es una URL que proporcionas a SimplyPrint. Cada vez que ocurre algo en tu cuenta a lo que te hayas suscrito, como que se inicia una impresión, falla un trabajo, se aprueba un elemento de la cola o un recambio se queda con pocas existencias, SimplyPrint envía un HTTP POST a esa URL con los datos del evento. Sin bucles de sondeo, sin malabarismos con límites de frecuencia ni preguntar «¿se nos escapó ese?», solo un flujo de eventos que puedes conectar a cualquier cosa que hable HTTP.
Crea tantos webhooks como necesites. Elige exactamente qué eventos debe recibir cada uno. Desactiva uno sin eliminarlo. Consulta cada entrega en el historial. Es el mismo mecanismo básico que usa el resto de la web, ahora conectado a tu flota de impresoras 3D.
Cuatro formatos de entrega, un sistema de webhooks
SimplyPrint detecta automáticamente el destino a partir de la URL y da formato a la carga útil para que coincida. Apunta un webhook a Discord y recibirás un embed adecuado con color, campos y marca de tiempo. Dirígelo a Slack y recibirás un mensaje de Slack Block Kit. Dirígelo a Microsoft Teams y recibirás una tarjeta adaptativa. Dirígelo a cualquier otro sitio y recibirás JSON sin procesar y limpio para hacer lo que quieras.
Cuerpo POST limpio para Zapier, n8n, Make o tu propio backend.
Pega la URL de un webhook de canal y obtén mensajes enriquecidos, sin bot.
Mensajes nativos de Block Kit desde cualquier webhook entrante de Slack.
Tarjetas adaptables enviadas a un flujo de trabajo de Teams o a la URL de un conector.
Todos los eventos que genera tu flota, agrupados en categorías claras
Suscribe cada webhook solo a los eventos que le importan. Un canal de Discord de todo el equipo quizá solo necesite impresión finalizada y impresión fallida. Una automatización de Zapier podría suscribirse a elemento de cola aprobado. Un panel de mantenimiento podría necesitar todos los eventos maintenance.*. Tú decides para cada webhook.
- Eventos de trabajos de impresión - inicio, pausa, reanudación, cancelación, finalización, fallo, cama despejada y objetos omitidos
- Eventos de impresora - estado de AutoPrint, tamaño de boquilla, material, etiqueta personalizada asignada o retirada, estado fuera de servicio, estado de IA, fallo detectado por IA, falso positivo de IA, ciclos máximos de AutoPrint
- Eventos de organización - estado de AutoPrint de la cuenta, registro de usuarios nuevos y usuarios pendientes de aprobación
- Cola de impresión - elemento añadido, eliminado, movido, reactivado, pendiente de aprobación, aprobado, rechazado, cola vaciada
- Filamento - creado, actualizado, eliminado, asignado a impresora, desasignado
- Mantenimiento - trabajo creado / iniciado / completado / cancelado / vencido / reabierto / actualizado / eliminado, problema informado / resuelto, repuesto creado / actualizado / eliminado, existencias ajustadas, existencias bajas, tarea completada / omitida, programación creada / actualizada / eliminada
- Saldo: cobrado, reembolsado, recargado, ajustado
- Cuota - solicitud nueva, solicitud resuelta, ajustada, restablecida
Un formato de payload fácil de integrar en código
Todas las entregas de webhooks de formato normal tienen el mismo aspecto externo: un sobre con el nombre del evento en event, una marca de tiempo ISO en timestamp y el identificador del webhook de origen en webhook_id. Este sobre contiene un objeto data cuya estructura es específica del evento.
El objeto data de un evento job.done incluye el trabajo de impresión, la impresora, el archivo, el usuario y el tiempo transcurrido. Un evento filament.assigned incluye el filamento, la impresora y la herramienta a la que se asignó. Un evento maintenance.job_overdue incluye el trabajo, la impresora, el usuario responsable y la fecha de vencimiento original. El mismo sobre, datos específicos de cada evento, por lo que una sola instrucción switch en tu código gestiona todo el flujo.
Voir comment Weshape utilise Webhooks pour gérer ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Prueba con ejemplos e inspecciona antes de poner nada en producción
Los Webhooks deberían ser sencillos. SimplyPrint te ofrece tres herramientas para que lo sean: consulta lo que recibirás, envía una prueba y revisa todas las entregas ya realizadas.
Enviar un evento de prueba
Envía una carga útil con estructura real bajo demanda desde cualquier suscripción.
Cargas útiles de ejemplo
Consulta las estructuras exactas de las cargas útiles antes de escribir código.
Historial de entregas
URL, estado HTTP, cuerpo de respuesta y marca de tiempo de cada entrega.
Cómo se ven tus webhooks una vez entregados
Los formatos de Discord, Slack y Teams se muestran como tarjetas integradas nativas en esas aplicaciones: título enriquecido, carga útil con campos y miniatura opcional de la impresora. Aquí tienes tres envíos reales de una granja de impresión que usa SimplyPrint, capturados directamente de un canal de Discord. Configura el formato una vez; SimplyPrint se encarga de la tarjeta integrada.
Mantenimiento vencido
Una orden de mantenimiento programada ha vencido: nombre de la orden, impresora, prioridad, programación y grupo, todo en una sola tarjeta.
Trabajo de mantenimiento creado
Se programa una nueva orden de mantenimiento: impresora, grupo y prioridad aparecen de inmediato en el canal de tu equipo.
Inventario de piezas de repuesto
Las modificaciones de inventario, como eliminar piezas, ajustar existencias o reponerlas, se envían como eventos independientes para que una herramienta de flujo de trabajo pueda reaccionar a cada una.
Verificación opcional mediante un secreto: demuestra que la solicitud procede realmente de SimplyPrint
Configura un secreto personalizado para cada webhook y SimplyPrint lo envía con cada entrega en la cabecera X-SP-Secret, para que tu receptor pueda comprobar que la solicitud realmente procede de nosotros y no de una IP aleatoria que haya adivinado tu URL. Omite el secreto en los webhooks de red interna cuando no lo necesites. Rótalo siempre que se filtre una clave. Las entregas anteriores no se invalidan y las futuras usan la nueva clave.
Cada webhook también se activa o desactiva de forma independiente: usa el interruptor para pausar una integración ruidosa sin perder su suscripción a eventos ni su historial.
Lo que la gente conecta realmente
Estos son los patrones que vemos con más frecuencia en granjas de impresión, centros educativos, makerspaces y equipos de producto que usan SimplyPrint.
Publica job.done y job.failed en el canal de tu equipo.
Activa la facturación o la preparación de pedidos cuando se apruebe un elemento de la cola de impresión.
Avisa al equipo de operaciones del mantenimiento atrasado o de existencias bajas de repuestos.
Muestra al profesorado las entregas de los estudiantes en tiempo real.
La parte de envío de una experiencia completa para desarrolladores
Los Webhooks se combinan de forma natural con el resto de herramientas para desarrolladores de SimplyPrint:
- La API de SimplyPrint permite a tu código consultar cualquier estado cuando lo necesite: impresoras, cola, archivos, filamento, trabajos.
- Los webhooks permiten a SimplyPrint enviar en cuanto cambia algo, para que no tengas que hacer sondeos.
- El servidor MCP de SimplyPrint permite a los asistentes de IA (Claude, ChatGPT) leer y actuar sobre la misma flota mediante un registro de herramientas verificado.
Acceso según el plan: ¿qué planes incluyen webhooks?
Los Webhooks están incluidos en los planes Print Farm y Enterprise sin coste adicional. Sin tarifas por webhook ni entrega, ni límites de eventos.
| Fonctionnalité / limite | Gratuit | Basic | Pro | Ferme d’impression | Enterprise | École | Slicer cloud | Gestionnaire de filament |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Sistema completo de webhooks multicanal: JSON normal, Discord, Slack y Microsoft Teams, con catálogo completo de eventos, verificación opcional mediante secreto e historial de cada entrega.
|
Vous voulez en savoir plus sur nos forfaits ?
Voir tous les tarifs et comparer les fonctionnalitésPreguntas frecuentes
¿Cómo envío eventos a Discord, Slack o Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services o de flujo de trabajo de Teams, y damos formato a la carga útil de forma nativa para esa plataforma. Sin instalar bots, aplicaciones ni middleware.¿A qué eventos puedo suscribirme?
¿Cómo verifico que una solicitud proviene realmente de SimplyPrint?
¿Puedo ver qué se ha entregado?
¿Puedo probar un webhook antes de activarlo?
¿En qué se diferencia de la API de SimplyPrint?
¿Y los reintentos si mi servidor está caído?
¿SimplyPrint reintenta las entregas fallidas?
¿Cuánto tiempo se guardan los intentos de entrega?
¿Qué planes incluyen webhooks?
Guía de configuración paso a paso
Para ver cómo crear tu primer webhook, incluidos detalles específicos para URL de Discord, Slack y Microsoft Teams, consulta el completo artículo de ayuda sobre webhooks.