insurance-claims-intake

Service Dispatch Call

Use this skill when an agent needs to phone a service vendor about a specific job and bring back a decision-ready answer, such as "find out if the plumber can attend unit 12B today and what it costs."

service-dispatch-call is a purpose-bound outbound workflow skill. It places exactly one call per authorized dispatch, asks a bounded set of questions, and returns a structured result. It does not book the job, accept a quote, agree to a price, or promise the vendor anything. Those are commitments, and commitments belong to a person.

The distinction this skill exists to enforce: gathering an answer is not the same as acting on it.

When To Use

Use this skill for:

• maintenance and repair dispatch, where a job must be matched to a vendor by phone
• availability checks against a shortlist of vendors
• quote gathering, where the price is unknown until someone is asked
• ETA confirmation for an already-accepted job
• any outbound call whose output must be machine-readable rather than a transcript

When Not To Use

Do not use this skill to:

• accept a quote, confirm a booking, or agree to any cost during the call
• call a vendor who is not on the caller's authorized contact list
• call a number the user supplied for a different purpose in an earlier, unrelated request
• redial a call whose outcome is unknown
• work around a missing price by asking the vendor to start anyway
• read tenant, patient, customer, or resident personal details to the vendor
• negotiate, counter-offer, or discuss a competitor's quote
• place a call when the required job fields are incomplete

Core Workflow

1. Confirm the dispatch is authorized: the job exists, and the vendor is on the authorized contact list for this purpose.
2. Extract the dispatch fields listed under Required Fields. Ask for anything missing. Do not infer a phone number, a trade, or a location from earlier context.
3. Reserve an idempotency key derived from the dispatch's own identifier, not from the current timestamp or a fresh random value. See references/idempotency.md.
4. Record the dispatch as queued before dialling, so a call that is accepted but never reported is still visible.
5. Build the call brief from references/call-brief.md. The brief opens with a disclosure and refers to the job by an opaque reference, never by an address or a person's name.
6. Declare the result schema before placing the call. See references/result-schema.md.
7. Place exactly one call.
8. Validate the returned result against the declared schema. Drop fields you did not ask for. Refuse values outside the declared options rather than coercing them.
9. Classify the outcome as answered, declined, no_answer, or unknown.
10. If the result contains a cost, a commitment, or a low-confidence field, raise it for human approval and stop. Report the reason.