Conversion Tool

capture_lead

Capture a shopper lead for merchant follow-up when an agent identifies buying intent that needs human handoff.

Write operation

This tool creates a lead record for the merchant. Only submit customer contact details when the customer has provided them for follow-up.

Parameters

Parameter	Type	Default	Description
`name`	string	—	Customer's full name.
`email`	string	—	Customer's email address.
`context`	string	—	What the customer needs, including a short summary of the conversation context.
`lead_type`	string	`lead_gen`	Type of lead: handover, lead_gen, callback_request, or a custom value.
`phone`	string \| null	`null`	Customer's phone number.
`agent_id`	string \| null	`null`	Your agent ID for attribution tracking.

Example

Example Call

// Tool call
{
  "name": "capture_lead",
  "arguments": {
    "name": "Jordan Lee",
    "email": "jordan@example.com",
    "context": "Interested in a bulk hoodie order and wants a merchant follow-up.",
    "lead_type": "handover",
    "phone": "+1 555 0100",
    "agent_id": "agent_abc123def456"
  }
}

Response

{
  "message": "Lead captured successfully.",
  "lead_type": "handover"
}