Communicate with providers via work order messages.
Communicate with the provider via work order messages. Messages are visible to specified groups and create a communication history.
GET /workorders/{id}/messages
{
"results": [
{
"msg_id": "1001",
"from": {
"id": 12345,
"name": "John Smith",
"role": "provider"
},
"message": "On my way to the site now.",
"role": "ASSIGNEDTECH",
"read": true,
"created": { "utc": "2025-01-15 08:30:00" }
},
{
"msg_id": "1002",
"from": {
"id": 500,
"name": "Dispatch Team",
"role": "buyer"
},
"message": "Please use the side entrance.",
"role": "ASSIGNEDTECH",
"read": false,
"created": { "utc": "2025-01-15 08:00:00" }
}
]
}POST /workorders/{id}/messages
{
"message": "Please use the side entrance.",
"type": "ASSIGNEDTECH"
}POST /workorders/{id}/messages/{message_id}
{
"message": "Understood, heading there now."
}Control message visibility and recipients using the type field:
| Type | Description |
|---|---|
INTERNAL | Internal team only (Staff Note) |
ASSIGNEDTECH | Send to assigned provider |
REQUESTEDTECHS | Send to all requested providers |
SPECIFICTECH | Send to specific provider (use to.id) |
ROUTEDTECHS | Send to all routed providers |
REPLY | Reply to a message |
REPLYTOTHREAD | Reply to a message thread |
TECHTOMANAGER | Provider to manager communication |
STAFF_NOTE | Internal staff note |
{
"message": "Equipment is in the back room.",
"type": "ASSIGNEDTECH"
}{
"message": "Provider seems inexperienced, monitor closely.",
"type": "INTERNAL"
}INTERNAL and STAFF_NOTE messages are only visible to your internal team, not to the provider.
Messages trigger notifications to relevant parties:
Last updated on