Communitygithub.com

AppFolio — 工單與維護管理

透過 AppFolio 自動化租戶管理與租賃作業。觸發詞:「appfolio tenant management」。

AppFolio — 工單與維護管理 是什麼?

此技能提供了一套完整的維護工單生命週期管理流程,適用於 AppFolio 的 Stack API。開發人員或 AI 代理可透過此技能自動建立工單、指派供應商、追蹤維修進度,並在完成後記錄成本與關閉工單。支援多平台整合,但主要設計給 AppFolio 用戶使用。其核心優勢在於減少人工干預,確保每次維修請求都有完整的稽核軌跡,同時強調數據最小化政策,避免在未授權的情況下保存租戶敏感資訊。該流程包含明確的錯誤處理步驟,如處理 401、404 與 429 等常見 API 錯誤,並建議使用指數退避策略應對速率限制。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/plugins/saas-packs/appfolio-pack/skills/appfolio-core-workflow-b

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AppFolio — 工單與維護管理 是做什麼的?

概述

透過 AppFolio 的 Stack API 管理維護工單的完整生命週期。 當租戶提交維護請求、需要指派供應商給未處理工單、跨物業追蹤維修進度,或使用成本記錄完成已完工工作時,可使用此工作流程。這是次要工作流程——如需查看物業儀表板與租賃功能,請參閱 appfolio-core-workflow-a。

先決條件

  • 已驗證的 AppFolio 合約與沙盒組合,包含合成物業、單元、供應商及工單記錄;請勿在已入住的正式單元上測試維護自動化。
  • 使用最低權限的服務身分、支援建立/關閉操作的冪等性,以及針對安全關鍵性維護的已核准升級路徑。
  • 數據最小化政策:僅儲存及傳輸執行工作所需的維護事實,切勿在通用供應商備註或日誌中儲存租戶偏好、存取碼或詳細居住資訊。

操作說明

步驟 1:從維護請求建立工單

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'Synthetic plumbing fixture leak reported in sandbox unit',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`Work order ${workOrder.id} created — status: ${workOrder.status}`);

步驟 2:指派供應商

const assignment = await client.workOrders.assign(workOrder.id, {
  vendor_id: 'vendor_plumb_01',
  scheduled_date: '2026-04-08',
  time_window: '09:00-12:00',
  notes: 'Confirm scheduled appointment through the approved work-order channel.',
});
console.log(`Assigned to ${assignment.vendor_name} on ${assignment.scheduled_date}`);

步驟 3:追蹤工單狀態

const open = await client.workOrders.list({
  property_id: 'prop_4821',
  status: ['open', 'in_progress', 'scheduled'],
  sort: 'priority_desc',
});
open.items.forEach(wo =>
  console.log(`#${wo.id} [${wo.priority}] ${wo.category} — ${wo.status} (due ${wo.due_date})`)
);

步驟 4:關閉工單並記錄成本

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Replaced P-trap and tightened supply line. No further leaks.',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Closed #${closed.id} — total cost: $${closed.total_cost}`);

錯誤處理

問題原因解決方法
401 UnauthorizedAPI 憑證過期或無效在 Stack 儀表板中更新 client_id/secret
404 Work Order Not Found工單 ID 錯誤或已被刪除使用 workOrders.list() 驗證 ID
422 Missing required fields遺漏 category 或 property_id 等必要欄位根據綱要包含所有必要欄位
409 Conflict工單已關閉在嘗試關閉前檢查狀態
429 Rate Limited超過每分鐘 120 次請求限制加入指數退避策略,基本延遲 1 秒

輸出

成功執行後會建立工單、指派給供應商並排定服務時段,最後以成本記錄和解決方案備註完成關閉。物業經理將獲得從請求到完成的完整稽核軌跡。

範例

對於沙盒水管工作流程,請使用穩定的冪等金鑰建立一個合成工單,指派一個沙盒供應商,並在任何轉換前讀取其狀態。僅附加非敏感的測試收據,然後一次性關閉工單,並驗證總金額與稽核記錄,而不記錄租戶或存取詳細資訊。重複相同的請求以證明重複工單和重複成本記錄會被拒絕。如果供應商指派、安全分類、先前狀態或關閉結果不確定,請保持工單開啟,並交由授權的物業操作人員審查。

資源

後續步驟

請參閱 appfolio-sdk-patterns 以了解認證設定與分頁輔助功能。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page for positioning, plan a conversion-optimized page layout, or design a launch page. Examples: "landing page for product launch", "conversion-optimized layout for SaaS

jeremylongshore/tons-of-skills-marketplace

Use when asked to design growth-optimized landing pages, activation funnel layouts, or experiment-friendly page structures. Examples: "growth-optimized landing", "activation funnel layout", "A/B testable page

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout

jeremylongshore/tons-of-skills-marketplace

Generate polished demo videos from a single prompt. Use when the user asks to create a demo video, product walkthrough, feature showcase, or animated presentation. Trigger with "make a demo video", "create a product video", "demo walkthrough", or "feature showcase video".

jeremylongshore/tons-of-skills-marketplace

Track cryptocurrency portfolio with real-time valuations, allocation analysis, and P&L tracking. Use when checking portfolio value, viewing holdings breakdown, analyzing allocations, or exporting portfolio data. Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio allocation", "track my crypto", or "export portfolio".

jeremylongshore/tons-of-skills-marketplace

Runs the full release workflow for the current project. Commits any uncommitted changes, pushes to remote, creates and merges a PR if on a feature branch, determines the next semver version from conventional commits, creates an annotated git tag and GitHub release with generated notes, cleans up merged branches, and returns to a clean main. Use when the user says promote, ship, release, commit and push, tag and release, or get back to main.

jeremylongshore/tons-of-skills-marketplace

Agent skill at plugins/productivity/content-multiplier/skills/channel-formats/SKILL.md

jeremylongshore/tons-of-skills-marketplace

Operate an evidence-backed editorial queue, balance topic and format coverage, schedule approved drafts, and reconcile backlog state with the publishing system. Use when choosing or scheduling the next blog work. Trigger with "show the editorial calendar" or "pick the next topic".

jeremylongshore/tons-of-skills-marketplace

Configure CI/CD pipeline for AppFolio property management integrations. Trigger: "appfolio CI".

jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common AppFolio API integration errors. Trigger: "appfolio error".

jeremylongshore/tons-of-skills-marketplace

Build property management dashboard with AppFolio API data. Trigger: "appfolio property dashboard".

jeremylongshore/tons-of-skills-marketplace

Collect AppFolio API debug evidence for support tickets. Trigger: "appfolio debug".

jeremylongshore/tons-of-skills-marketplace

Deploy AppFolio integration service to cloud infrastructure. Trigger: "deploy appfolio".

jeremylongshore/tons-of-skills-marketplace

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

jeremylongshore/tons-of-skills-marketplace

Configure AppFolio Stack API authentication with OAuth 2.0. Use when setting up property management API access, registering as an AppFolio Stack partner, or configuring client credentials for API calls. Trigger: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

jeremylongshore/tons-of-skills-marketplace

Set up local development for AppFolio property management API integration. Trigger: "appfolio local dev".

jeremylongshore/tons-of-skills-marketplace

Production readiness checklist for AppFolio integrations. Trigger: "appfolio production checklist".

jeremylongshore/tons-of-skills-marketplace

Handle AppFolio API rate limits with throttling and backoff. Trigger: "appfolio rate limit".

jeremylongshore/tons-of-skills-marketplace

Reference architecture for AppFolio property management integration. Trigger: "appfolio architecture".

jeremylongshore/tons-of-skills-marketplace

Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".

相關技能