voice_lead_qualifier

Place an asynchronous sales qualification call and score captured evidence against a configurable rubric.

When to use

Use when an agent needs structured lead qualification from a lawful customer conversation rather than an ungrounded free-form model opinion.

Selection guidance

Role: primary. Use when an agent needs structured lead qualification from a lawful customer conversation rather than an ungrounded free-form model opinion.

Use cases

• lead qualification
• sales discovery call
• qualification score

Access

• REST: POST https://api.rafidsystem.com/api/v1/voice/lead-qualifier
• x402: POST https://api.rafidsystem.com/api/v1/x402/voice/lead-qualifier
• MCP tool: voice_lead_qualifier

Price: $0.75 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• ai_call_agent
• appointment_call_agent

Example input

{
  "phoneNumber": "+96891234567",
  "language": "en",
  "maxDurationSeconds": 300,
  "criteria": {
    "requiredInterest": false,
    "minimumBudget": 1000,
    "currency": "OMR",
    "targetTimelineDays": 30,
    "decisionMakerRequired": false
  }
}

Example output

{
  "callId": "call_example",
  "status": "queued",
  "answered": false,
  "durationSeconds": 0,
  "outcome": null,
  "summary": null,
  "nextAction": null,
  "structuredFacts": {},
  "transcript": [],
  "createdAt": "2026-01-01T00:00:00.000Z",
  "completedAt": null,
  "qualification": {
    "score": 0,
    "classification": "unqualified",
    "intent": "low",
    "budget": null,
    "timeline": null,
    "decisionMaker": null,
    "objections": [],
    "evidence": []
  },
  "recommendedNextAction": "nurture"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "phoneNumber": {
      "type": "string",
      "pattern": "^\\+[1-9]\\d{7,14}$"
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    },
    "maxDurationSeconds": {
      "default": 300,
      "type": "integer",
      "minimum": 1,
      "maximum": 3600
    },
    "context": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      }
    },
    "criteria": {
      "default": {
        "requiredInterest": false,
        "currency": "USD",
        "targetTimelineDays": 30,
        "decisionMakerRequired": false
      },
      "type": "object",
      "properties": {
        "requiredInterest": {
          "default": false,
          "type": "boolean"
        },
        "minimumBudget": {
          "type": "number",
          "minimum": 0
        },
        "currency": {
          "default": "USD",
          "type": "string",
          "minLength": 3,
          "maxLength": 3
        },
        "targetTimelineDays": {
          "default": 30,
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "decisionMakerRequired": {
          "default": false,
          "type": "boolean"
        }
      },
      "required": [
        "requiredInterest",
        "currency",
        "targetTimelineDays",
        "decisionMakerRequired"
      ],
      "additionalProperties": false
    },
    "safety": {
      "type": "object",
      "properties": {
        "consentNotice": {
          "type": "string",
          "maxLength": 500
        },
        "recording": {
          "default": false,
          "type": "boolean"
        },
        "transcription": {
          "default": false,
          "type": "boolean"
        },
        "timezone": {
          "type": "string",
          "maxLength": 100
        }
      },
      "required": [
        "recording",
        "transcription"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "phoneNumber",
    "language",
    "maxDurationSeconds",
    "criteria"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "callId": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "created",
        "queued",
        "dialing",
        "ringing",
        "answered",
        "in_progress",
        "completed",
        "no_answer",
        "busy",
        "rejected",
        "failed",
        "cancelled"
      ]
    },
    "answered": {
      "type": "boolean"
    },
    "durationSeconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "outcome": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextAction": {
      "type": [
        "string",
        "null"
      ]
    },
    "structuredFacts": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "transcript": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "speaker": {
            "type": "string",
            "enum": [
              "agent",
              "customer"
            ]
          },
          "text": {
            "type": "string"
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          }
        },
        "required": [
          "speaker",
          "text",
          "at"
        ],
        "additionalProperties": false
      }
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "completedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "qualification": {
      "type": "object",
      "properties": {
        "score": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "classification": {
          "type": "string",
          "enum": [
            "unqualified",
            "needs_review",
            "qualified"
          ]
        },
        "intent": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high"
          ]
        },
        "budget": {
          "type": [
            "string",
            "null"
          ]
        },
        "timeline": {
          "type": [
            "string",
            "null"
          ]
        },
        "decisionMaker": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "objections": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "evidence": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string"
              },
              "value": {},
              "source": {
                "type": "string",
                "enum": [
                  "customer_statement",
                  "provider_event",
                  "derived"
                ]
              }
            },
            "required": [
              "field",
              "value",
              "source"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "score",
        "classification",
        "intent",
        "budget",
        "timeline",
        "decisionMaker",
        "objections",
        "evidence"
      ],
      "additionalProperties": false
    },
    "recommendedNextAction": {
      "type": "string"
    }
  },
  "required": [
    "callId",
    "status",
    "answered",
    "durationSeconds",
    "outcome",
    "summary",
    "nextAction",
    "structuredFacts",
    "transcript",
    "createdAt",
    "completedAt",
    "qualification",
    "recommendedNextAction"
  ],
  "additionalProperties": false
}

Category: Voice / Communication · hierarchy: primary · idempotent: no · side effects: yes