Webhook Events - Levers

Available Events

Levers sends webhook notifications for the following events:

Event	Description
`phone_call.ended`	Triggered when an AI phone call completes

phone_call.ended

Triggered when an AI phone call finishes. This event includes comprehensive call data including transcription, sentiment analysis, and call outcome.

Payload Schema

{
  "providerCallId": "069652c8-d01e-733e-8000-7c64a16dde5f",
  "numberFrom": "+15074106928",
  "numberTo": "+971585420805",
  "providerStatus": "pass",
  "deliveryStatus": "pass",
  "duration": 53,
  "summary": null,
  "endedReason": null,
  "callOutput": "CALL_RESULT",
  "callOutputReasoning": "Detailed evaluation and reasoning for the call result based on the conversation context and objectives.",
  "sentimentOutput": "NEUTRAL",
  "sentimentOutputReasoning": "Analysis of the contact's emotional tone and engagement level throughout the conversation.",
  "transcription": "Full transcript of the conversation between the AI assistant and the contact.",
  "recordingUrl": "levers-test-bucket:livekit-egress/56d4148b-3e6e-4095-b5c2-ca6e383357dd/6e0ac8cd-26c7-41ee-9e1e-a4cb692ba741/recording_1768238221.mp3",
  "metadata": {
    "requestMetadata": {
      "project_id": "proj_123",
      "extra_id": "custom_id_456"
    }
  }
}

Field Descriptions

Field	Type	Description
`providerCallId`	string (UUID)	Unique identifier for the call from the telephony provider
`numberFrom`	string	The Levers phone number that made the call (E.164 format)
`numberTo`	string	The phone number that received the call (E.164 format)
`providerStatus`	string	Status of the call from provider perspective (`pass`, `fail`)
`deliveryStatus`	string	Whether the call was successfully delivered (`pass`, `fail`)
`duration`	integer	Call duration in seconds
`summary`	string \| null	Brief summary of the call (may be null)
`endedReason`	string \| null	Reason why the call ended (may be null)
`callOutput`	string	Result of the call evaluation based on the conversation outcome
`callOutputReasoning`	string	Detailed evaluation and reasoning for the call result based on the conversation context and objectives
`sentimentOutput`	string	Detected sentiment of the contact (`POSITIVE`, `NEUTRAL`, `NEGATIVE`)
`sentimentOutputReasoning`	string	Analysis of the contact’s emotional tone and engagement level throughout the conversation
`transcription`	string	Full text transcript of the conversation
`recordingUrl`	string	URL to the call recording audio file
`metadata`	object	Additional metadata about the call (key-value pairs). Contains `requestMetadata` which includes any custom data passed when initiating the call (e.g., `project_id`, `extra_id`)

Call Output Values

The callOutput field can include various outcomes such as:

Value	Description
`PAYMENT EXTENSION`	Contact requested more time to pay
`PAYMENT PROMISE`	Contact committed to paying by a specific date
`CALL BACK REQUESTED`	Contact asked to be called again later
`WRONG NUMBER`	The number was invalid or wrong contact
`NOT INTERESTED`	Contact declined to discuss the matter
`PAYMENT COMPLETED`	Payment was made during/after the call

Sentiment Values

Value	Description
`POSITIVE`	Contact was cooperative and engaged
`NEUTRAL`	Contact was neither cooperative nor resistant
`NEGATIVE`	Contact was frustrated, angry, or uncooperative

Learn how to verify webhook signatures to secure your endpoint.