[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F851GVAKVC8Z8J0GZ08WWA":3,"skill-same:01M6F851GVAKVC8Z8J0GZ08WWA":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":6,"ownerHtmlUrl":57,"ownerBlogUrl":58,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M6F851GVAKVC8Z8J0GZ08WWA","maintainx-webhooks-events",null,"Implement MaintainX webhook handling and event-driven integrations.\nUse when setting up webhooks, handling MaintainX events,\nor building real-time integrations with MaintainX.\nTrigger with phrases like \"maintainx webhook\", \"maintainx events\",\n\"maintainx notifications\", \"maintainx real-time\", \"maintainx triggers\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-webhooks-events\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"maintainx webhooks events","events","webhooks","when","implement","with","event","event-driven","trigger","io","webhook","triggers","time","up","use","edit","write","read","curl","integrations","webhook handling","Bash","real-time","notifications","2026-11-10 10:12:30",false,"---\nname: maintainx-webhooks-events\ndescription: |\n  Implement MaintainX webhook handling and event-driven integrations.\n  Use when setting up webhooks, handling MaintainX events,\n  or building real-time integrations with MaintainX.\n  Trigger with phrases like \"maintainx webhook\", \"maintainx events\",\n  \"maintainx notifications\", \"maintainx real-time\", \"maintainx triggers\".\nallowed-tools: Read, Write, Edit, Bash(curl:*), Bash(npm:*)\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# MaintainX Webhooks & Events\n\n## Overview\n\nBuild real-time integrations with MaintainX using webhooks and event-driven patterns for work order updates, asset changes, and maintenance notifications.\n\n## Prerequisites\n\n- MaintainX account with webhook access\n- HTTPS endpoint accessible from internet\n- Understanding of webhook security patterns\n\n## MaintainX Event Types\n\n| Event | Description | Use Case |\n|-------|-------------|----------|\n| `workorder.created` | New work order created | Notify team, sync to external system |\n| `workorder.updated` | Work order modified | Track status changes |\n| `workorder.completed` | Work order marked done | Trigger follow-up actions |\n| `asset.updated` | Asset information changed | Sync asset data |\n| `request.created` | Work request submitted | Auto-create work orders |\n\n## Instructions\n\n### Step 1: Webhook Endpoint Setup\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fhandler.ts\nimport express, { Request, Response, NextFunction } from 'express';\nimport crypto from 'crypto';\n\nconst router = express.Router();\n\n\u002F\u002F Webhook secret from MaintainX (configure in dashboard)\nconst WEBHOOK_SECRET = process.env.MAINTAINX_WEBHOOK_SECRET;\n\n\u002F\u002F Raw body parser for signature verification\nrouter.use('\u002Fwebhooks\u002Fmaintainx', express.raw({ type: 'application\u002Fjson' }));\n\n\u002F\u002F Signature verification middleware\nfunction verifySignature(req: Request, res: Response, next: NextFunction) {\n  const signature = req.headers['x-maintainx-signature'] as string;\n  const timestamp = req.headers['x-maintainx-timestamp'] as string;\n\n  if (!signature || !timestamp || !WEBHOOK_SECRET) {\n    return res.status(401).json({ error: 'Missing signature or configuration' });\n  }\n\n  \u002F\u002F Verify timestamp is recent (prevent replay attacks)\n  const timestampMs = parseInt(timestamp) * 1000;\n  const fiveMinutesAgo = Date.now() - 5 * 60 * 1000;\n\n  if (timestampMs \u003C fiveMinutesAgo) {\n    return res.status(401).json({ error: 'Timestamp too old' });\n  }\n\n  \u002F\u002F Compute expected signature\n  const payload = `${timestamp}.${req.body.toString()}`;\n  const expectedSignature = crypto\n    .createHmac('sha256', WEBHOOK_SECRET)\n    .update(payload)\n    .digest('hex');\n\n  \u002F\u002F Timing-safe comparison\n  const isValid = crypto.timingSafeEqual(\n    Buffer.from(signature),\n    Buffer.from(expectedSignature)\n  );\n\n  if (!isValid) {\n    return res.status(401).json({ error: 'Invalid signature' });\n  }\n\n  \u002F\u002F Parse body for handlers\n  req.body = JSON.parse(req.body.toString());\n  next();\n}\n\n\u002F\u002F Main webhook endpoint\nrouter.post('\u002Fwebhooks\u002Fmaintainx', verifySignature, async (req, res) => {\n  const event = req.body;\n\n  console.log(`Received webhook: ${event.type}`, event.id);\n\n  try {\n    await handleMaintainXEvent(event);\n    res.status(200).json({ received: true });\n  } catch (error) {\n    console.error('Webhook processing error:', error);\n    res.status(500).json({ error: 'Processing failed' });\n  }\n});\n\nexport { router as webhookRouter };\n```\n\n### Step 2: Event Handler Pattern\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fevent-handlers.ts\n\ninterface MaintainXEvent {\n  id: string;\n  type: string;\n  data: any;\n  createdAt: string;\n}\n\ntype EventHandler = (event: MaintainXEvent) => Promise\u003Cvoid>;\n\n\u002F\u002F Handler registry\nconst eventHandlers: Map\u003Cstring, EventHandler[]> = new Map();\n\n\u002F\u002F Register handler\nfunction on(eventType: string, handler: EventHandler) {\n  const handlers = eventHandlers.get(eventType) || [];\n  handlers.push(handler);\n  eventHandlers.set(eventType, handlers);\n}\n\n\u002F\u002F Process event\nasync function handleMaintainXEvent(event: MaintainXEvent): Promise\u003Cvoid> {\n  const handlers = eventHandlers.get(event.type) || [];\n\n  if (handlers.length === 0) {\n    console.log(`No handlers for event type: ${event.type}`);\n    return;\n  }\n\n  \u002F\u002F Execute all handlers (parallel or sequential based on needs)\n  await Promise.all(handlers.map(h => h(event)));\n}\n\n\u002F\u002F Register handlers\non('workorder.created', async (event) => {\n  console.log('New work order:', event.data.title);\n\n  \u002F\u002F Example: Send Slack notification\n  await sendSlackNotification({\n    channel: '#maintenance',\n    text: `New work order: ${event.data.title}`,\n    attachments: [{\n      fields: [\n        { title: 'Priority', value: event.data.priority },\n        { title: 'Asset', value: event.data.asset?.name || 'N\u002FA' },\n        { title: 'Location', value: event.data.location?.name || 'N\u002FA' },\n      ],\n    }],\n  });\n});\n\non('workorder.updated', async (event) => {\n  const { previousStatus, currentStatus } = event.data;\n\n  if (previousStatus !== currentStatus) {\n    console.log(`Work order status changed: ${previousStatus} -> ${currentStatus}`);\n\n    \u002F\u002F Track status transitions\n    await trackStatusChange(event.data.id, previousStatus, currentStatus);\n  }\n});\n\non('workorder.completed', async (event) => {\n  console.log('Work order completed:', event.data.id);\n\n  \u002F\u002F Example: Update external system\n  await syncToExternalSystem(event.data);\n\n  \u002F\u002F Example: Create follow-up tasks\n  if (event.data.requiresFollowUp) {\n    await createFollowUpWorkOrder(event.data);\n  }\n});\n\non('request.created', async (event) => {\n  console.log('New work request:', event.data.title);\n\n  \u002F\u002F Auto-create work order from request\n  const workOrder = await autoCreateWorkOrder(event.data);\n  console.log('Auto-created work order:', workOrder.id);\n});\n\nexport { handleMaintainXEvent, on };\n```\n\n### Step 3: Idempotency Handling\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fidempotency.ts\nimport { Redis } from 'ioredis';\n\nconst redis = new Redis(process.env.REDIS_URL);\n\ninterface IdempotencyResult {\n  isProcessed: boolean;\n  result?: any;\n}\n\nasync function checkIdempotency(eventId: string): Promise\u003CIdempotencyResult> {\n  const key = `maintainx:webhook:${eventId}`;\n  const result = await redis.get(key);\n\n  if (result) {\n    return { isProcessed: true, result: JSON.parse(result) };\n  }\n\n  return { isProcessed: false };\n}\n\nasync function markProcessed(eventId: string, result: any): Promise\u003Cvoid> {\n  const key = `maintainx:webhook:${eventId}`;\n  \u002F\u002F Store for 7 days\n  await redis.set(key, JSON.stringify(result), 'EX', 7 * 24 * 60 * 60);\n}\n\n\u002F\u002F Idempotent event handler wrapper\nasync function processIdempotent(\n  event: MaintainXEvent,\n  handler: EventHandler\n): Promise\u003Cvoid> {\n  \u002F\u002F Check if already processed\n  const { isProcessed, result } = await checkIdempotency(event.id);\n\n  if (isProcessed) {\n    console.log(`Event ${event.id} already processed, skipping`);\n    return;\n  }\n\n  \u002F\u002F Process event\n  const handlerResult = await handler(event);\n\n  \u002F\u002F Mark as processed\n  await markProcessed(event.id, { processedAt: new Date(), result: handlerResult });\n}\n```\n\n### Step 4: Webhook Testing Tools\n\n```typescript\n\u002F\u002F scripts\u002Ftest-webhook.ts\nimport crypto from 'crypto';\nimport axios from 'axios';\n\nconst WEBHOOK_URL = process.env.WEBHOOK_URL || 'http:\u002F\u002Flocalhost:3000\u002Fwebhooks\u002Fmaintainx';\nconst WEBHOOK_SECRET = process.env.MAINTAINX_WEBHOOK_SECRET || 'test-secret';\n\nasync function sendTestWebhook(eventType: string, data: any) {\n  const timestamp = Math.floor(Date.now() \u002F 1000).toString();\n\n  const payload = JSON.stringify({\n    id: `evt_${Date.now()}`,\n    type: eventType,\n    data,\n    createdAt: new Date().toISOString(),\n  });\n\n  \u002F\u002F Generate signature\n  const signedPayload = `${timestamp}.${payload}`;\n  const signature = crypto\n    .createHmac('sha256', WEBHOOK_SECRET)\n    .update(signedPayload)\n    .digest('hex');\n\n  try {\n    const response = await axios.post(WEBHOOK_URL, payload, {\n      headers: {\n        'Content-Type': 'application\u002Fjson',\n        'X-MaintainX-Signature': signature,\n        'X-MaintainX-Timestamp': timestamp,\n      },\n    });\n\n    console.log('Webhook sent successfully:', response.status);\n    console.log('Response:', response.data);\n  } catch (error: any) {\n    console.error('Webhook failed:', error.response?.data || error.message);\n  }\n}\n\n\u002F\u002F Test different event types\nasync function runTests() {\n  console.log('Testing workorder.created...');\n  await sendTestWebhook('workorder.created', {\n    id: 'wo_test_001',\n    title: 'Test Work Order',\n    priority: 'HIGH',\n    status: 'OPEN',\n    asset: { id: 'asset_001', name: 'Test Asset' },\n    location: { id: 'loc_001', name: 'Test Location' },\n  });\n\n  console.log('\\nTesting workorder.completed...');\n  await sendTestWebhook('workorder.completed', {\n    id: 'wo_test_001',\n    title: 'Test Work Order',\n    completedAt: new Date().toISOString(),\n    completedBy: { id: 'user_001', name: 'Test User' },\n  });\n\n  console.log('\\nTesting request.created...');\n  await sendTestWebhook('request.created', {\n    id: 'req_test_001',\n    title: 'Emergency Repair Request',\n    description: 'Machine making strange noise',\n    requestedBy: { id: 'user_002', name: 'Operator' },\n  });\n}\n\nrunTests().catch(console.error);\n```\n\n### Step 5: Webhook Retry Handler\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fretry-queue.ts\nimport Bull from 'bull';\n\ninterface WebhookJob {\n  event: MaintainXEvent;\n  attempt: number;\n  maxAttempts: number;\n}\n\nconst webhookQueue = new Bull\u003CWebhookJob>('maintainx-webhooks', {\n  redis: process.env.REDIS_URL,\n  defaultJobOptions: {\n    attempts: 5,\n    backoff: {\n      type: 'exponential',\n      delay: 1000,\n    },\n  },\n});\n\n\u002F\u002F Process jobs\nwebhookQueue.process(async (job) => {\n  const { event, attempt, maxAttempts } = job.data;\n\n  console.log(`Processing webhook ${event.id} (attempt ${attempt}\u002F${maxAttempts})`);\n\n  try {\n    await handleMaintainXEvent(event);\n    console.log(`Webhook ${event.id} processed successfully`);\n  } catch (error) {\n    console.error(`Webhook ${event.id} failed:`, error);\n    throw error;  \u002F\u002F Bull will retry based on config\n  }\n});\n\n\u002F\u002F Add event to queue\nasync function queueWebhook(event: MaintainXEvent): Promise\u003Cvoid> {\n  await webhookQueue.add({\n    event,\n    attempt: 1,\n    maxAttempts: 5,\n  });\n}\n\n\u002F\u002F Failed job handler\nwebhookQueue.on('failed', (job, err) => {\n  console.error(`Webhook job ${job.id} failed after ${job.attemptsMade} attempts:`, err);\n\n  \u002F\u002F Alert on final failure\n  if (job.attemptsMade >= job.opts.attempts!) {\n    alertOnWebhookFailure(job.data.event, err);\n  }\n});\n```\n\n### Step 6: Webhook Dashboard\n\n```typescript\n\u002F\u002F src\u002Froutes\u002Fwebhook-admin.ts\nimport { Router } from 'express';\n\nconst router = Router();\n\n\u002F\u002F List recent webhooks\nrouter.get('\u002Fadmin\u002Fwebhooks', async (req, res) => {\n  const webhooks = await getRecentWebhooks(50);\n\n  res.json({\n    total: webhooks.length,\n    webhooks: webhooks.map(w => ({\n      id: w.id,\n      type: w.type,\n      status: w.status,\n      processedAt: w.processedAt,\n      error: w.error,\n    })),\n  });\n});\n\n\u002F\u002F Get webhook details\nrouter.get('\u002Fadmin\u002Fwebhooks\u002F:id', async (req, res) => {\n  const webhook = await getWebhookById(req.params.id);\n\n  if (!webhook) {\n    return res.status(404).json({ error: 'Webhook not found' });\n  }\n\n  res.json(webhook);\n});\n\n\u002F\u002F Retry failed webhook\nrouter.post('\u002Fadmin\u002Fwebhooks\u002F:id\u002Fretry', async (req, res) => {\n  const webhook = await getWebhookById(req.params.id);\n\n  if (!webhook) {\n    return res.status(404).json({ error: 'Webhook not found' });\n  }\n\n  await queueWebhook(webhook.event);\n\n  res.json({ message: 'Webhook queued for retry' });\n});\n\nexport { router as webhookAdminRouter };\n```\n\n## Output\n\n- Webhook endpoint with signature verification\n- Event handler pattern implemented\n- Idempotency handling\n- Testing tools configured\n- Retry queue for reliability\n- Admin dashboard for monitoring\n\n## Webhook Best Practices\n\n1. **Always verify signatures** - Never process unsigned webhooks\n2. **Respond quickly** - Return 200 within 5 seconds, process async\n3. **Implement idempotency** - Handle duplicate deliveries\n4. **Use queues** - Don't block webhook response on processing\n5. **Monitor failures** - Alert on repeated failures\n\n## Resources\n\n- [MaintainX API Documentation](https:\u002F\u002Fmaintainx.dev\u002F)\n- [Webhook Security Best Practices](https:\u002F\u002Fhookdeck.com\u002Fwebhooks\u002Fguides\u002Fwebhook-security-vulnerabilities-guide)\n- [Bull Queue Documentation](https:\u002F\u002Fgithub.com\u002FOptimalBits\u002Fbull)\n\n## Next Steps\n\nFor performance optimization, see `maintainx-performance-tuning`.\n","# MaintainX Webhooks & Events\n\n## Overview\n\nBuild real-time integrations with MaintainX using webhooks and event-driven patterns for work order updates, asset changes, and maintenance notifications.\n\n## Prerequisites\n\n- MaintainX account with webhook access\n- HTTPS endpoint accessible from internet\n- Understanding of webhook security patterns\n\n## MaintainX Event Types\n\n| Event | Description | Use Case |\n|-------|-------------|----------|\n| `workorder.created` | New work order created | Notify team, sync to external system |\n| `workorder.updated` | Work order modified | Track status changes |\n| `workorder.completed` | Work order marked done | Trigger follow-up actions |\n| `asset.updated` | Asset information changed | Sync asset data |\n| `request.created` | Work request submitted | Auto-create work orders |\n\n## Instructions\n\n### Step 1: Webhook Endpoint Setup\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fhandler.ts\nimport express, { Request, Response, NextFunction } from 'express';\nimport crypto from 'crypto';\n\nconst router = express.Router();\n\n\u002F\u002F Webhook secret from MaintainX (configure in dashboard)\nconst WEBHOOK_SECRET = process.env.MAINTAINX_WEBHOOK_SECRET;\n\n\u002F\u002F Raw body parser for signature verification\nrouter.use('\u002Fwebhooks\u002Fmaintainx', express.raw({ type: 'application\u002Fjson' }));\n\n\u002F\u002F Signature verification middleware\nfunction verifySignature(req: Request, res: Response, next: NextFunction) {\n  const signature = req.headers['x-maintainx-signature'] as string;\n  const timestamp = req.headers['x-maintainx-timestamp'] as string;\n\n  if (!signature || !timestamp || !WEBHOOK_SECRET) {\n    return res.status(401).json({ error: 'Missing signature or configuration' });\n  }\n\n  \u002F\u002F Verify timestamp is recent (prevent replay attacks)\n  const timestampMs = parseInt(timestamp) * 1000;\n  const fiveMinutesAgo = Date.now() - 5 * 60 * 1000;\n\n  if (timestampMs \u003C fiveMinutesAgo) {\n    return res.status(401).json({ error: 'Timestamp too old' });\n  }\n\n  \u002F\u002F Compute expected signature\n  const payload = `${timestamp}.${req.body.toString()}`;\n  const expectedSignature = crypto\n    .createHmac('sha256', WEBHOOK_SECRET)\n    .update(payload)\n    .digest('hex');\n\n  \u002F\u002F Timing-safe comparison\n  const isValid = crypto.timingSafeEqual(\n    Buffer.from(signature),\n    Buffer.from(expectedSignature)\n  );\n\n  if (!isValid) {\n    return res.status(401).json({ error: 'Invalid signature' });\n  }\n\n  \u002F\u002F Parse body for handlers\n  req.body = JSON.parse(req.body.toString());\n  next();\n}\n\n\u002F\u002F Main webhook endpoint\nrouter.post('\u002Fwebhooks\u002Fmaintainx', verifySignature, async (req, res) => {\n  const event = req.body;\n\n  console.log(`Received webhook: ${event.type}`, event.id);\n\n  try {\n    await handleMaintainXEvent(event);\n    res.status(200).json({ received: true });\n  } catch (error) {\n    console.error('Webhook processing error:', error);\n    res.status(500).json({ error: 'Processing failed' });\n  }\n});\n\nexport { router as webhookRouter };\n```\n\n### Step 2: Event Handler Pattern\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fevent-handlers.ts\n\ninterface MaintainXEvent {\n  id: string;\n  type: string;\n  data: any;\n  createdAt: string;\n}\n\ntype EventHandler = (event: MaintainXEvent) => Promise\u003Cvoid>;\n\n\u002F\u002F Handler registry\nconst eventHandlers: Map\u003Cstring, EventHandler[]> = new Map();\n\n\u002F\u002F Register handler\nfunction on(eventType: string, handler: EventHandler) {\n  const handlers = eventHandlers.get(eventType) || [];\n  handlers.push(handler);\n  eventHandlers.set(eventType, handlers);\n}\n\n\u002F\u002F Process event\nasync function handleMaintainXEvent(event: MaintainXEvent): Promise\u003Cvoid> {\n  const handlers = eventHandlers.get(event.type) || [];\n\n  if (handlers.length === 0) {\n    console.log(`No handlers for event type: ${event.type}`);\n    return;\n  }\n\n  \u002F\u002F Execute all handlers (parallel or sequential based on needs)\n  await Promise.all(handlers.map(h => h(event)));\n}\n\n\u002F\u002F Register handlers\non('workorder.created', async (event) => {\n  console.log('New work order:', event.data.title);\n\n  \u002F\u002F Example: Send Slack notification\n  await sendSlackNotification({\n    channel: '#maintenance',\n    text: `New work order: ${event.data.title}`,\n    attachments: [{\n      fields: [\n        { title: 'Priority', value: event.data.priority },\n        { title: 'Asset', value: event.data.asset?.name || 'N\u002FA' },\n        { title: 'Location', value: event.data.location?.name || 'N\u002FA' },\n      ],\n    }],\n  });\n});\n\non('workorder.updated', async (event) => {\n  const { previousStatus, currentStatus } = event.data;\n\n  if (previousStatus !== currentStatus) {\n    console.log(`Work order status changed: ${previousStatus} -> ${currentStatus}`);\n\n    \u002F\u002F Track status transitions\n    await trackStatusChange(event.data.id, previousStatus, currentStatus);\n  }\n});\n\non('workorder.completed', async (event) => {\n  console.log('Work order completed:', event.data.id);\n\n  \u002F\u002F Example: Update external system\n  await syncToExternalSystem(event.data);\n\n  \u002F\u002F Example: Create follow-up tasks\n  if (event.data.requiresFollowUp) {\n    await createFollowUpWorkOrder(event.data);\n  }\n});\n\non('request.created', async (event) => {\n  console.log('New work request:', event.data.title);\n\n  \u002F\u002F Auto-create work order from request\n  const workOrder = await autoCreateWorkOrder(event.data);\n  console.log('Auto-created work order:', workOrder.id);\n});\n\nexport { handleMaintainXEvent, on };\n```\n\n### Step 3: Idempotency Handling\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fidempotency.ts\nimport { Redis } from 'ioredis';\n\nconst redis = new Redis(process.env.REDIS_URL);\n\ninterface IdempotencyResult {\n  isProcessed: boolean;\n  result?: any;\n}\n\nasync function checkIdempotency(eventId: string): Promise\u003CIdempotencyResult> {\n  const key = `maintainx:webhook:${eventId}`;\n  const result = await redis.get(key);\n\n  if (result) {\n    return { isProcessed: true, result: JSON.parse(result) };\n  }\n\n  return { isProcessed: false };\n}\n\nasync function markProcessed(eventId: string, result: any): Promise\u003Cvoid> {\n  const key = `maintainx:webhook:${eventId}`;\n  \u002F\u002F Store for 7 days\n  await redis.set(key, JSON.stringify(result), 'EX', 7 * 24 * 60 * 60);\n}\n\n\u002F\u002F Idempotent event handler wrapper\nasync function processIdempotent(\n  event: MaintainXEvent,\n  handler: EventHandler\n): Promise\u003Cvoid> {\n  \u002F\u002F Check if already processed\n  const { isProcessed, result } = await checkIdempotency(event.id);\n\n  if (isProcessed) {\n    console.log(`Event ${event.id} already processed, skipping`);\n    return;\n  }\n\n  \u002F\u002F Process event\n  const handlerResult = await handler(event);\n\n  \u002F\u002F Mark as processed\n  await markProcessed(event.id, { processedAt: new Date(), result: handlerResult });\n}\n```\n\n### Step 4: Webhook Testing Tools\n\n```typescript\n\u002F\u002F scripts\u002Ftest-webhook.ts\nimport crypto from 'crypto';\nimport axios from 'axios';\n\nconst WEBHOOK_URL = process.env.WEBHOOK_URL || 'http:\u002F\u002Flocalhost:3000\u002Fwebhooks\u002Fmaintainx';\nconst WEBHOOK_SECRET = process.env.MAINTAINX_WEBHOOK_SECRET || 'test-secret';\n\nasync function sendTestWebhook(eventType: string, data: any) {\n  const timestamp = Math.floor(Date.now() \u002F 1000).toString();\n\n  const payload = JSON.stringify({\n    id: `evt_${Date.now()}`,\n    type: eventType,\n    data,\n    createdAt: new Date().toISOString(),\n  });\n\n  \u002F\u002F Generate signature\n  const signedPayload = `${timestamp}.${payload}`;\n  const signature = crypto\n    .createHmac('sha256', WEBHOOK_SECRET)\n    .update(signedPayload)\n    .digest('hex');\n\n  try {\n    const response = await axios.post(WEBHOOK_URL, payload, {\n      headers: {\n        'Content-Type': 'application\u002Fjson',\n        'X-MaintainX-Signature': signature,\n        'X-MaintainX-Timestamp': timestamp,\n      },\n    });\n\n    console.log('Webhook sent successfully:', response.status);\n    console.log('Response:', response.data);\n  } catch (error: any) {\n    console.error('Webhook failed:', error.response?.data || error.message);\n  }\n}\n\n\u002F\u002F Test different event types\nasync function runTests() {\n  console.log('Testing workorder.created...');\n  await sendTestWebhook('workorder.created', {\n    id: 'wo_test_001',\n    title: 'Test Work Order',\n    priority: 'HIGH',\n    status: 'OPEN',\n    asset: { id: 'asset_001', name: 'Test Asset' },\n    location: { id: 'loc_001', name: 'Test Location' },\n  });\n\n  console.log('\\nTesting workorder.completed...');\n  await sendTestWebhook('workorder.completed', {\n    id: 'wo_test_001',\n    title: 'Test Work Order',\n    completedAt: new Date().toISOString(),\n    completedBy: { id: 'user_001', name: 'Test User' },\n  });\n\n  console.log('\\nTesting request.created...');\n  await sendTestWebhook('request.created', {\n    id: 'req_test_001',\n    title: 'Emergency Repair Request',\n    description: 'Machine making strange noise',\n    requestedBy: { id: 'user_002', name: 'Operator' },\n  });\n}\n\nrunTests().catch(console.error);\n```\n\n### Step 5: Webhook Retry Handler\n\n```typescript\n\u002F\u002F src\u002Fwebhooks\u002Fretry-queue.ts\nimport Bull from 'bull';\n\ninterface WebhookJob {\n  event: MaintainXEvent;\n  attempt: number;\n  maxAttempts: number;\n}\n\nconst webhookQueue = new Bull\u003CWebhookJob>('maintainx-webhooks', {\n  redis: process.env.REDIS_URL,\n  defaultJobOptions: {\n    attempts: 5,\n    backoff: {\n      type: 'exponential',\n      delay: 1000,\n    },\n  },\n});\n\n\u002F\u002F Process jobs\nwebhookQueue.process(async (job) => {\n  const { event, attempt, maxAttempts } = job.data;\n\n  console.log(`Processing webhook ${event.id} (attempt ${attempt}\u002F${maxAttempts})`);\n\n  try {\n    await handleMaintainXEvent(event);\n    console.log(`Webhook ${event.id} processed successfully`);\n  } catch (error) {\n    console.error(`Webhook ${event.id} failed:`, error);\n    throw error;  \u002F\u002F Bull will retry based on config\n  }\n});\n\n\u002F\u002F Add event to queue\nasync function queueWebhook(event: MaintainXEvent): Promise\u003Cvoid> {\n  await webhookQueue.add({\n    event,\n    attempt: 1,\n    maxAttempts: 5,\n  });\n}\n\n\u002F\u002F Failed job handler\nwebhookQueue.on('failed', (job, err) => {\n  console.error(`Webhook job ${job.id} failed after ${job.attemptsMade} attempts:`, err);\n\n  \u002F\u002F Alert on final failure\n  if (job.attemptsMade >= job.opts.attempts!) {\n    alertOnWebhookFailure(job.data.event, err);\n  }\n});\n```\n\n### Step 6: Webhook Dashboard\n\n```typescript\n\u002F\u002F src\u002Froutes\u002Fwebhook-admin.ts\nimport { Router } from 'express';\n\nconst router = Router();\n\n\u002F\u002F List recent webhooks\nrouter.get('\u002Fadmin\u002Fwebhooks', async (req, res) => {\n  const webhooks = await getRecentWebhooks(50);\n\n  res.json({\n    total: webhooks.length,\n    webhooks: webhooks.map(w => ({\n      id: w.id,\n      type: w.type,\n      status: w.status,\n      processedAt: w.processedAt,\n      error: w.error,\n    })),\n  });\n});\n\n\u002F\u002F Get webhook details\nrouter.get('\u002Fadmin\u002Fwebhooks\u002F:id', async (req, res) => {\n  const webhook = await getWebhookById(req.params.id);\n\n  if (!webhook) {\n    return res.status(404).json({ error: 'Webhook not found' });\n  }\n\n  res.json(webhook);\n});\n\n\u002F\u002F Retry failed webhook\nrouter.post('\u002Fadmin\u002Fwebhooks\u002F:id\u002Fretry', async (req, res) => {\n  const webhook = await getWebhookById(req.params.id);\n\n  if (!webhook) {\n    return res.status(404).json({ error: 'Webhook not found' });\n  }\n\n  await queueWebhook(webhook.event);\n\n  res.json({ message: 'Webhook queued for retry' });\n});\n\nexport { router as webhookAdminRouter };\n```\n\n## Output\n\n- Webhook endpoint with signature verification\n- Event handler pattern implemented\n- Idempotency handling\n- Testing tools configured\n- Retry queue for reliability\n- Admin dashboard for monitoring\n\n## Webhook Best Practices\n\n1. **Always verify signatures** - Never process unsigned webhooks\n2. **Respond quickly** - Return 200 within 5 seconds, process async\n3. **Implement idempotency** - Handle duplicate deliveries\n4. **Use queues** - Don't block webhook response on processing\n5. **Monitor failures** - Alert on repeated failures\n\n## Resources\n\n- [MaintainX API Documentation](https:\u002F\u002Fmaintainx.dev\u002F)\n- [Webhook Security Best Practices](https:\u002F\u002Fhookdeck.com\u002Fwebhooks\u002Fguides\u002Fwebhook-security-vulnerabilities-guide)\n- [Bull Queue Documentation](https:\u002F\u002Fgithub.com\u002FOptimalBits\u002Fbull)\n\n## Next Steps\n\nFor performance optimization, see `maintainx-performance-tuning`.\n",{"name":5,"author":48,"license":15,"version":49,"description":50,"allowed-tools":51},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Implement MaintainX webhook handling and event-driven integrations.\nUse when setting up webhooks, handling MaintainX events,\nor building real-time integrations with MaintainX.\nTrigger with phrases like \"maintainx webhook\", \"maintainx events\",\n\"maintainx notifications\", \"maintainx real-time\", \"maintainx triggers\".\n","Read, Write, Edit, Bash(curl:*), Bash(npm:*)","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-webhooks-events",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-webhooks-events",{"tool":67,"command":68},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-webhooks-events",{"tool":70,"command":71},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-webhooks-events","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-webhooks-events\u002FSKILL.md",true,[],[76,109,144,167,193,219],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":89,"publishedAt":108},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[84],{"categoryNo":85,"categoryName":86,"taxonomyType":87,"taxonomyTypeDesc":88},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,24,106,107],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","you","fonts","2026-11-11 15:11:14",{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":113,"sourceHtmlUrl":114,"categories":115,"keywords":119,"publishedAt":43},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[116],{"categoryNo":117,"categoryName":118,"taxonomyType":87,"taxonomyTypeDesc":88},"01JBSEEDCAT000000000000009","前端开发",[120,121,96,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,33,101,137,138,139,140,141,142,143],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":148,"sourceHtmlUrl":149,"categories":150,"keywords":155,"publishedAt":43},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[151,154],{"categoryNo":152,"categoryName":153,"taxonomyType":87,"taxonomyTypeDesc":88},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":117,"categoryName":118,"taxonomyType":87,"taxonomyTypeDesc":88},[156,157,158,124,159,160,121,161,94,162,134,163,164,165,166,24,141],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":168,"name":169,"nameZh":6,"description":170,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":171,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":43},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[175,176,177,178,179,180,181,182,33,183,184,185,186,187,188,189,24,190,191,192,141,22],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":197,"sourceHtmlUrl":198,"categories":199,"keywords":203,"publishedAt":43},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[200],{"categoryNo":201,"categoryName":202,"taxonomyType":87,"taxonomyTypeDesc":88},"01JBSEEDCAT000000000000023","Skill与智能体开发",[204,205,206,207,208,209,210,211,38,212,213,214,215,216,24,141,217,22,218],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":220,"name":221,"nameZh":6,"description":222,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":223,"sourceHtmlUrl":224,"categories":225,"keywords":227,"publishedAt":43},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[226],{"categoryNo":201,"categoryName":202,"taxonomyType":87,"taxonomyTypeDesc":88},[221,228,229,230,231,232,233,162,234,235,33,236,237,238,239,141,240],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]