Entity References

Entity references turn FreeMaint Chat into a CMMS-aware messenger. Mention a Work Order, Asset, Part or any of 8 supported entity types and the message renders an inline card with status, title and a clickable link.

Supported entity types

• WorkOrder
• Asset
• Part
• Location
• Request
• PurchaseOrder
• Vendor
• Customer

Two ways to add a reference

• From any Work Order page, click the 'Discuss' button in the toolbar — opens Chat with the WO already attached as a reference chip in the composer
• Manually attach via API by adding `references: [{entityType, entityId}]` to the sendMessage payload

Restricted cards

If a recipient does not have permission to see the referenced entity (cross-company, deleted, or scope-restricted), the card renders as 'Restricted' with only the type and ID — no leaking title or status.