Skip to main content
The webchat.session.converted webhook event is triggered when a webchat session is converted into a lead. This is the event that bridges the webchat session identity space (sessionId) with the lead identity space (leadId) — subscribe to it if you need to correlate webchat activity with downstream lead events.

​
Payload

{
  "event": "webchat.session.converted",
  "data": {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "orgId": "org-abc123",
    "profile": "Default Profile",
    "origin": "https://example.com/pricing",
    "leadId": "a7e92c5d-f301-4b89-ae16-8f35d02cx9z",
    "conversionType": "auto",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+12025550189",
    "email": "jane@example.com",
    "summary": "Visitor asked about annual pricing and requested a follow-up."
  },
  "timestamp": "2024-01-15T14:30:00Z"
}

​
Properties

PropertyTypeDescription
eventstringThe webhook event type (webchat.session.converted).
data.sessionIdstringThe unique identifier for the webchat session.
data.orgIdstringThe Apten organization ID that owns the session.
data.profilestringThe name of the webchat profile that handled the session.
data.originstringThe URL of the page where the webchat widget was opened. Only included if set.
data.leadIdstringThe Apten lead ID created from the converted session. Use this to correlate with lead webhooks.
data.conversionTypestringHow the session was converted: auto (automatic) or tool (triggered by an agent tool).
data.firstNamestringThe lead’s first name. Only included if available.
data.lastNamestringThe lead’s last name. Only included if available.
data.phonestringThe lead’s phone number. Only included if available.
data.emailstringThe lead’s email address. Only included if available.
data.summarystringAn AI-generated summary of the webchat conversation. Only included if available.
timestampstringThe ISO 8601 timestamp when the webhook was sent.