Skip to content
ContractSpec
Start here

reference

Support resolution workflow (support-resolution-v1)

Recovers a case from conversation evidence, proposes a cited response, dispatches under approval and records the actual resolution outcome.

field.key.label
docs.customer-support.support-resolution
field.version.label
field.type.label
field.title.label
Support resolution workflow (support-resolution-v1)
field.tags.label
supportos,workflow,resolution,intercom,approval
field.owners.label
field.stability.label
public
  1. Recover reads the provider conversation (Intercom stays authoritative) and records the customer issue parts as evidence. One responder is custodian.
  2. Propose prepares a reply or internal note with citations to conversation parts, knowledge or engineering work, plus the agreed resolution criterion. Conversation-part citations must reference parts actually observed.
  3. Approve is required for every customer-visible reply. The approval binds the exact action payload digest; changing the text needs a new approval. Its verified signer must be a human, not the proposer, not the responder and equal to approvedByRef; hosts take approvedByRef from the approval evidence, never from the caller. A host that records a provider admin id as responderRef binds SupportResponderPrincipalPort: an unmapped responder is refused and the mapped principal may not approve. Internal notes need that approval or a Connect admission (standing mandate).
  4. Dispatch is refused for agent or unidentified principals, re-verifies the recorded approval and its signer before the effect, and executes the conversation action. Timeouts or malformed success leave the response response-uncertain until read-back reconciliation; a newer human or bot reply marks the proposal superseded. Absence after the grace window needs a human response.confirm-absent before a new proposal.
  5. Outcome is recorded separately from the reply. resolved requires the criterion's evidence: customer confirmation part, a fixed engineering work item plus an accepted notification, or an accepted answer. A new customer message after resolution reopens the workflow.