Call events

Event

call.finished

Trigger

A phone call is ended.

Event

call.processed

Trigger

Occurs when all post-call analyses are completed (i.e. call.metadata object is fully populated).

data.object contains a call object.

Example of a call.finished event.

{
    "version": "0",
    "id": "5US7xdqKHalKbU8CXjhO",
    "type": "call.finished",
    "agentId": "1R7kHmQ6moHuhpaddTf9",
    "description": "An inboud call was finished.",
    "createdAt": "2024-08-20T15:14:54Z",
    "data": {
        "object": {
        {
          "id": "CAf5c514db0c0c6c85864883276c7de7be",
          "from": "[phone]",
          "to": "[phone]",
          "direction": "inbound",
          "duration": "4",
          "status": "completed",
          "createdAt": "2024-08-20T15:50:00Z",
          "updatedAt": "2024-08-20T15:50:00Z",
          "endedAt": "2024-08-20T15:54:00Z",
          "metadata": {}
       }
    }
}

Example of a call.processed event.

{
    "version": "0",
    "id": "623726f0-804e-4f0e-8fda-8a4f9e06d4a6",
    "agentId": "C2vlFTJFo9C9ufLjugBh",
    "createdAt": "2025-05-30T23:10:32.852Z",
    "description": "A finished call has been processed.",
    "type": "call.processed",
    "data": {
        "object": {
            "id": "CA8ba0b37f5dc8372e4ac33dce3009df2e",
            "from": "[phone]",
            "to": "[phone]",
            "direction": "inbound",
            "duration": 11,
            "status": "completed",
            "answeredBy": "unknown",
            "createdAt": "2025-05-30T23:08:51.880Z",
            "updatedAt": "2025-05-30T23:09:07.517Z",
            "endedAt": "2025-05-30T23:09:02.880Z",
            "customerId": "th22bn5hZ2hG6YKhOVM3",
            "tags": [],
            "flags": [],
            "metadata": {
                "conversation": [
                    {
                        "role": "assistant",
                        "content": "Hello! This is Dental Smile Creations! How Can I help you today?",
                        "timeMark": 243,
                        "id": "voA5fZn7YQLc2oTpfu0n",
                        "createdAt": "2025-05-30T23:08:53.225Z",
                        "updatedAt": "2025-05-30T23:08:53.225Z"
                    }
                ],
                "languages": [
                    "en"
                ],
                "sentiment": {
                    "label": "positive",
                    "score": 0.8,
                    "magnitude": 0.9
                },
                "topics": [
                    {
                        "confidenceScore": 0.9,
                        "id": "ikZeJoKmNu1vwP5bwKSR",
                        "topic": "Caller Does Not Speak"
                    }
                ],
                "purpose": "Missed call",
                "aiMessage": "Hello! I extended a greeting to the person on the line, but unfortunately, I did not receive any response. Please return the call to determine the reason."
            },
            "expanded": {
                "customer": {
                    "id": "th22bn5hZ2hG6YKhOVC56",
                    "firstName": "John",
                    "lastName": "Smith",
                    "phoneNumber": "[phone]",
                    "channel": "voip",
                    "createdAt": "2025-05-30T23:08:51.303Z",
                    "updatedAt": "2025-05-30T23:08:51.303Z"
                },
                "opportunities": [{
                    "id": "V3kzQu9S7AWzofzYBOsz",
                    "name": "Smile Design Appointment Inquiry",
                    "customerId": "th22bn5hZ2hG6YKhOVC56",
                    "score": 80,
                    "removed": false,
                    "stageId": "sFpRk7eIUbe2DJ4OC68b",
                    "pipelineId": "sHYx5EjPlfq59BkZRmrI",
                    "createdAt": "2025-05-22T19:17:04.728Z",
                    "updatedAt": "2025-05-30T22:46:36.540Z",
                    "amount": 1564,
                    "tags": ["qualified"],
                    "ownerId": null
                }]
            }
        }
    }
}