latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

webhook

Call hangup event

Terminated call webhook, when you hang up a call

To certify that the request was sent by Ringover, verify the request signature with your webhook key — see Securing your webhooks under the webhook tag (V1: JWT HS512 in X-Ringover-Webhook-Signature, with the deprecated Authorization header for backward compatibility; V3, on request: Base64 HMAC-SHA256 in X-Ringover-Webhook-Signature-V3).

postWebhookcall_hangup

Payload

eventstring
resourcestring
timestampnumber
attemptinteger

Example payload

{
  "event": "hangup",
  "resource": "call",
  "timestamp": 1554823493.762305,
  "data": {
    "id": "57622f20-a020-4f9e-814c-62a6123412fa",
    "call_id": 1234567890987654400,
    "channel_id": 123456789,
    "start_time": 1554823400.762305,
    "hangup_time": 1554823442.762305,
    "duration_in_seconds": 32,
    "record": "https://cdr.ringover.com/record/myrecord.mp3",
    "direction": "inbound",
    "from_number": "33601020304",
    "to_number": "33101020304",
    "user_id": 12854321,
    "is_internal": true,
    "is_ivr": true,
    "ivr_data": {
      "number": "33101020304",
      "scenario_name": "Opened",
      "ivr_name": "myIVR"
    },
    "user": {
      "user_id": 123456789,
      "firstname": "Jean",
      "lastname": "Dupont",
      "email": "jean.dupont@ringover.com",
      "photo": "https://cdn.ringover.com/img/users/default.jpg"
    }
  },
  "attempt": 2
}

Response

Successful operation