Workflow specification
Make the next handover clear before connecting the tools.
A useful sales workflow gives the next person the context and responsibility to act. Specify what starts the work, what reaches the recipient and how they accept it. Then agree what happens when an account cannot be matched, the owner is away or the connection fails.
In this guide
Name what the next person needs to decide
“Automate our inbound leads” can mean several different tasks: acknowledge a request, identify an existing customer, find an owner, prepare a brief or qualify an opportunity. Separate these decisions. A record assigned to someone is not necessarily accepted by them, and neither event establishes qualification.
Start with the receiving person. What are they trying to decide, and what do they currently have to reconstruct? For a new-branch enquiry from an existing customer, the relationship owner may need the original request, the buying unit, prior commitments and the relevant delivery history. A notification containing only a name and email address leaves most of that work behind.
Write the intended result as an observable state: the correct owner can open the original request, see the checked account context and record whether they accept the next action. This also defines what the workflow does not decide. Inbound qualification explains the later assessment; lead routing deals with assignment and exceptions.
Define a start that another person can recognise
Name the event precisely. Is it a newly submitted enquiry, an approved account change or a daily review of unresolved work? Record where the event comes from, how it is identified and which earlier events should not start the same work again. Decide whether a corrected request updates an existing handover or creates a separate one.
Add entry conditions before implementation. A request might need a valid account reference, an agreed territory or a permitted source. Some conditions will be unknown at the start. Route those cases to a named review step instead of silently excluding them or guessing the missing value.
Test the wording with two people. Give them the same five historical cases and ask which should start the workflow. If their answers differ, settle the rule before connecting tools. A precise trigger is useful even when the first version is handled manually.
Carry only the context the handover needs
List the required fields and their sources. Distinguish information supplied by the customer, confirmed account data, an inferred match and an unresolved question. Include source dates when stale information could change the next action. Make the original request available to the authorised recipient so they can check a summary.
Decide which missing fields block an automatic update and which simply need an explicit unknown. A missing delivery date may be a question for the owner. An uncertain company identity can prevent a record from being attached safely. These are different kinds of exception and should not disappear into one generic error.
Use the shared customer-data contract to settle account/site identity and field responsibility. If someone needs a compact reading packet before a conversation, the account research brief defines that output in more detail.
A handover contract for an existing customer’s enquiry
A wholesaler receives an enquiry for an existing customer’s proposed new site. The first workflow prepares the account context and assigns a review. Delivery commitments, prices and proposals remain decisions for the authorised team.
Start
- Agreed behaviour
- A new enquiry receives a stable request reference, such as R-42
- Evidence at handover
- Original request and received time remain available
Account context
- Agreed behaviour
- Match the legal customer and any confirmed site; leave uncertain matches open
- Evidence at handover
- Matched IDs, source references and unresolved questions travel together
Owner
- Agreed behaviour
- Existing relationship owner takes priority; an absent owner has a named cover rule
- Evidence at handover
- Receiving owner and the rule used are visible
Permitted action
- Agreed behaviour
- Prepare an internal brief and review task
- Evidence at handover
- No quote, customer message or deal-stage change is included
Completion
- Agreed behaviour
- The receiving owner accepts the task or returns it with a reason
- Evidence at handover
- Acceptance is distinguishable from delivery to the queue
Exception
- Agreed behaviour
- Conflicting account identities reach the assigned reviewer
- Evidence at handover
- The request remains available without an unsafe account update
Recovery
- Agreed behaviour
- A repeated event checks the existing request before creating work
- Evidence at handover
- One request reference connects the original attempt, delivery and any investigation
The account owner can now ask the customer the next useful question. If the first task reveals a wider opportunity, qualification and a proposal follow through their own decisions. The initial automation has a useful boundary even when the wider account journey continues.
Put this contract inside the first-release implementation plan. Add a separate custom tool brief only if the owner lacks a workable view in the existing tools.
Give completed, waiting and uncertain different meanings
A successful response from a connected system may confirm that it stored a record. It does not confirm that a person saw the record or accepted responsibility. Decide which event counts as completion for this workflow and which later event belongs to commercial follow-through. Name the person responsible when work remains unaccepted.
The wholesaler’s proposed rule gives the team lead a 10:00 review of unaccepted enquiry tasks each working day. If R-42 is waiting and its owner is absent, the lead assigns the named cover person and records why. The permanent account owner stays unchanged. The receiving person then accepts the task or returns it with a reason. Agree that review interval around the actual team’s working day and customer commitments.
Keep uncertainty visible after an interrupted response. If a receiving system may have saved the task, retrying immediately can create a duplicate. AWS’s discussion of idempotent APIs explains using a stable request identity so retries can refer to the same intended operation. Ask how the actual connection handles that case, including systems that lack such support.
A useful operator message says what is known and what to do next: “The brief may have been saved. Check request R-42 before starting another attempt.” Define who investigates, where they can find the evidence and how the final outcome is recorded. The exact wording should match what the implementation can verify.
Test the contract with the future operator
Prepare a normal enquiry, a repeat of that enquiry, an absent owner, conflicting account references and a connection that becomes unavailable. For each case, write the expected receiving record, the fields that must remain unchanged and the person who should be notified. Include a case where no automatic action is the correct result.
Ask the operator to use the proposed output without your explanation. Can they find the original question, identify what is unresolved and recover a failed handover? Capture the misunderstanding as a repair to the specification or interface. A flowchart alone cannot answer these questions.
The workflow testing checklist supplies the fuller test record. When the proposed workflow includes an agent, add its separate operating contract; permission to prepare this brief does not grant the agent authority over the rest of the account.
Use the specification to agree one release
Walk through one real example with the people sending and receiving the work. For each step, identify what already works, which rule needs agreement and what needs implementing. Scope the smallest release that completes the handover, including a way to handle exceptions and recover from failure.
The first release may be an adjustment to an existing tool, a separately scoped AI workflow or a handover within a Build campaign. Agree who prepares, reviews and acts on the work: your team, ClarityRev or both. A standalone connection has its own scope. If a missing research answer prevents useful implementation, settle that question first. Include the adjacent work needed for a handover people can use.
Where does a useful enquiry lose its context?
We can trace the handover across people and tools, agree the rules and build the connection it needs. The result may be one focused workflow or part of the research, outreach and response handling in a wider assignment.
Discuss your workflow handoverA Fit Call is a free 30-minute video conversation. No preparation needed.