Buscar quando quiser. Enviar quando importar.
A SimplyPrint API é ótima quando seu sistema faz as perguntas. Webhooks são como SimplyPrint avisa você assim que algo muda, sem polling, sem trabalhos agendados e sem eventos perdidos.
Envie eventos em vez de fazer polling
Um webhook é uma URL que você fornece ao SimplyPrint. Sempre que algo para o qual você se inscreveu acontece na sua conta, uma impressão começa, um trabalho falha, um item da fila é aprovado ou uma peça de reposição fica com estoque baixo, o SimplyPrint envia um HTTP POST para essa URL com os dados do evento. Sem loops de polling, sem administrar limites de taxa, sem "perdemos esse?", apenas um fluxo de eventos que você pode conectar a qualquer coisa que fale HTTP.
Crie quantos webhooks precisar. Escolha exatamente quais eventos importam para cada um. Desative um sem excluí-lo. Inspecione cada entrega na visualização de histórico. É o mesmo recurso básico usado pelo restante da web, agora conectado à sua frota de impressoras 3D.
Quatro formatos de entrega: um sistema de webhooks
O SimplyPrint detecta automaticamente o destino pela URL e formata os dados de acordo com esse destino. Aponte um webhook para o Discord e você terá um embed adequado com cor, campos e data e hora. Aponte-o para o Slack e terá uma mensagem do Slack Block Kit. Aponte-o para o Microsoft Teams e terá um cartão adaptável. Aponte-o para qualquer outro destino e terá JSON bruto e limpo para usar como quiser.
Corpo POST limpo para Zapier, n8n, Make ou seu próprio backend.
Cole uma URL de webhook do canal e tenha embeds ricos, sem bot.
Mensagens Block Kit nativas de qualquer webhook de entrada do Slack.
Cartões adaptáveis enviados a um fluxo de trabalho do Teams ou URL de conector.
Todos os eventos que sua frota gera, agrupados em categorias claras
Inscreva cada webhook exatamente nos eventos que importam para ele. Um canal do Discord para toda a equipe talvez só se interesse por impressão concluída e impressão falhou. Uma automação do Zapier talvez assine item da fila aprovado. Um painel de manutenção pode querer todos os eventos maintenance.*. Você decide para cada webhook.
- Eventos de trabalhos de impressão - iniciados, pausados, retomados, cancelados, concluídos, com falha, mesa livre, objetos ignorados
- Eventos da impressora - estado do AutoPrint, tamanho do bico, material, etiqueta personalizada atribuída / removida, estado fora de serviço, estado da IA, falha de IA detectada, falso positivo de falha de IA, máximo de ciclos do AutoPrint
- Eventos da organização - estado do AutoPrint da conta, cadastro de novo usuário, aprovação pendente de usuário
- Fila de impressão - item adicionado, excluído, movido, reativado, aguardando aprovação, aprovado, recusado, fila esvaziada
- Filamento: criado, atualizado, excluído, atribuído à impressora, desatribuído
- Manutenção - trabalho de manutenção criado / iniciado / concluído / cancelado / atrasado / reaberto / atualizado / excluído, problema relatado / resolvido, peça de reposição criada / atualizada / excluída, estoque ajustado, estoque baixo, tarefa concluída / ignorada, agenda criada / atualizada / excluída
- Saldo - cobrado, reembolsado, recarregado, ajustado
- Cota - nova solicitação, solicitação resolvida, ajustada, redefinida
Um formato de payload fácil de usar no código
Cada entrega de webhook em formato regular tem a mesma aparência externamente: um envelope com o nome do event, um timestamp ISO e o webhook_id de origem, envolvendo um objeto data cuja estrutura é específica do evento.
O objeto data de um evento job.done inclui o trabalho de impressão, a impressora, o arquivo, o usuário e o tempo decorrido. Um evento filament.assigned inclui o filamento, a impressora e a ferramenta à qual foi atribuído. Um evento maintenance.job_overdue inclui o trabalho, a impressora, o usuário responsável e a data de vencimento original. Mesmo envelope, dados específicos de cada evento, então uma única instrução switch no seu código lida com todo o fluxo.
Veja como Weshape usa Webhooks para gerenciar ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Teste, experimente e inspecione antes de enviar algo para produção
Webhooks deveriam ser simples. SimplyPrint oferece três ferramentas para isso: ver o que você receberá, enviar um disparo de teste e consultar cada entrega já realizada.
Enviar evento de teste
Dispare um payload no formato real sob demanda de qualquer assinatura.
Payloads de exemplo
Consulte estruturas exatas de payload antes de escrever código.
Histórico de entregas
URL, status HTTP, corpo da resposta e data e hora de cada entrega.
Como ficam seus webhooks depois da entrega
Os formatos Discord, Slack e Teams aparecem como cards nativos incorporados nesses apps, com título rico, payload com campos e miniatura opcional da impressora. Aqui estão três entregas reais de uma print farm que usa SimplyPrint, capturadas diretamente de um canal do Discord. Configure o formato uma vez, e o SimplyPrint cuida da incorporação.
Manutenção atrasada
Um trabalho de manutenção agendado passou da data de vencimento: nome do trabalho, impressora, prioridade, agenda e grupo, tudo em um cartão.
Trabalho de manutenção criado
Um novo trabalho de manutenção é agendado: impressora, grupo e prioridade aparecem imediatamente no canal da sua equipe.
Inventário de peças de reposição
Alterações no inventário, peças excluídas, estoque ajustado ou reabastecido, entregues como eventos separados para que uma ferramenta de fluxo de trabalho possa reagir a cada um.
Verificação opcional de segredo, comprove que a solicitação realmente veio do SimplyPrint
Defina um segredo para cada webhook, e o SimplyPrint o enviará em todas as entregas no cabeçalho X-SP-Secret, para que seu receptor possa verificar se a solicitação realmente veio de nós, e não de algum IP aleatório que adivinhou sua URL. Não defina o segredo em webhooks da rede interna quando ele não for necessário. Troque-o sempre que uma chave vazar. As entregas anteriores não são invalidadas, e as futuras usam a nova chave.
Cada webhook também é ativado/desativado de forma independente. Altere a chave para pausar uma integração barulhenta sem perder a assinatura de eventos nem o histórico.
O que as pessoas realmente configuram
Estes são os padrões que vemos com mais frequência em print farms, escolas, makerspaces e equipes de produto que usam SimplyPrint.
Envie job.done e job.failed ao canal da sua equipe.
Acione a emissão de faturas ou o processamento de pedidos quando um item da fila for aprovado.
Notifique a equipe de operações sobre manutenções atrasadas ou estoque baixo de peças de reposição.
Mostre os envios dos alunos aos professores em tempo real.
O lado de push de uma experiência completa para desenvolvedores
Webhooks combinam naturalmente com os demais recursos para desenvolvedores do SimplyPrint:
- A SimplyPrint API permite que seu código consulte qualquer estado quando quiser: impressoras, fila, arquivos, filamentos e trabalhos.
- Webhooks permitem que o SimplyPrint envie dados assim que algo muda, para que você não precise consultá-los periodicamente.
- O servidor MCP da SimplyPrint permite que assistentes de IA, Claude e ChatGPT, leiam e atuem na mesma frota por meio de um registro de ferramentas validado.
Acesso por plano: quais planos incluem webhooks?
Webhooks estão incluídos nos planos Print Farm e Enterprise, sem custo adicional. Sem cobrança por webhook ou entrega, nem limites de eventos.
| Recurso / limite | Grátis | Básico | Pro | Print farm | Enterprise | Escola | Fatiador em Nuvem | Gerenciador de filamento |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Sistema completo de webhooks multicanal: JSON normal, Discord, Slack e Microsoft Teams, com catálogo completo de eventos, verificação opcional de segredo e histórico de cada entrega.
|
Quer saber mais sobre nossos planos?
Ver preços e comparação completa de recursosPerguntas frequentes
Como envio eventos para Discord, Slack ou Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services ou URL de fluxo do Teams, e formatamos o payload nativamente para essa plataforma. Sem instalar bot, app ou middleware.Quais eventos posso assinar?
Como verifico se uma solicitação realmente veio do SimplyPrint?
Posso ver o que foi entregue?
Posso testar um webhook antes de entrar em produção?
Como isso difere da API do SimplyPrint?
E se meu servidor estiver fora do ar, haverá novas tentativas?
O SimplyPrint tenta reenviar entregas com falha?
Por quanto tempo as tentativas de entrega são armazenadas?
Quais planos incluem webhooks?
Guia de configuração passo a passo
Para um guia sobre como criar seu primeiro webhook, incluindo detalhes para URLs do Discord, Slack e Microsoft Teams, consulte o artigo completo da central de ajuda sobre webhooks.