← Back to recipes
Recipe

Lead Qualification

This recipe creates one qualification playbook with an extract schema, rents and binds a sender number, places the qualification call, and retrieves the summary with structured output.

Estimated cost~$0.50 / lead
ChannelsVoice
Voice
Get started in docs →
Step 1

Set lead variables

Define the lead phone number and the area code for the rented caller ID.

Set lead variables
export LEAD_PHONE="+19175550987"
export AREA_CODE="415"
Step 2

Create the qualification playbook

Add an extract schema so the summary command can return structured qualification data after the call.

Create the qualification playbook
CALL_PLAYBOOK_ID=$(spix --json playbook create \
  --type call \
  --name "Lead qualification" \
  --goal "Determine budget range, implementation timeline, and whether the contact is the decision-maker. Classify as hot, warm, or cold." \
  --persona "Curious, professional business development rep" \
  --extract '{"qualification":"string","budget":"string","timeline":"string","decision_maker":"boolean"}' \
  | jq -r '.data.playbook_id')
Step 3

Rent and bind the sender number

Rent one number and bind it to the lead-qualification playbook.

Rent and bind the sender number
SENDER_NUMBER=$(spix --json phone rent --area-code "$AREA_CODE" --limit 1 | jq -r '.data[0].number')

spix --json phone rent \
  --number "$SENDER_NUMBER" \
  --bind-channel call \
  --bind-playbook "$CALL_PLAYBOOK_ID" \
  --confirm
Step 4

Call the lead and inspect the summary

Create the call, then retrieve the summary and extracted fields with the session ID.

Call the lead and inspect the summary
CALL_SESSION_ID=$(spix --json call create "$LEAD_PHONE" \
  --playbook "$CALL_PLAYBOOK_ID" \
  --sender "$SENDER_NUMBER" \
  | jq -r '.data.session_id')

spix --json call summary "$CALL_SESSION_ID"
More recipes

Related workflows

Start with a nearby pattern, then swap the playbook goal, sender, and message copy for your own use case.

~$0.50 / appointment

Appointment Confirmation

Call a provider to confirm an upcoming appointment, then text the final details back to the person you are helping.

VoiceSMS
View recipe →
~$0.52 / reschedule

Doctor Appointment Reschedule

Call a clinic to move an appointment to a better time, then text the new slot back to the person you are helping.

VoiceSMS
View recipe →
~$0.01 / request

Subscription Cancellation Request

Send a clean cancellation email to a service provider from a dedicated inbox and keep the thread in one place.

View recipe →
Build your own recipe

Install Spix, then turn this pattern into your own production flow.

Use the docs to adjust the playbook goal, numbers, inboxes, and follow-up messages for your own customers, leads, patients, or operators.

Open the docs →