@cemscale-voip/voip-sdk 1.55.0 → 1.55.1

package/README.md

@@ -124,13 +124,14 @@ import type {
   CallAnsweredEvent,
   CallForwardedEvent,
   CallEndedEvent,
+  VoicemailNewEvent,
 } from '@cemscale-voip/voip-sdk';
 
 // Register a webhook subscription
 await voip.createWebhook({
   name: 'CRM Events',
   url: 'https://your-crm.com/api/voip-webhook',
-  events: ['call.started', 'call.answered', 'call.forwarded', 'call.ended'],
+  events: ['call.started', 'call.answered', 'call.forwarded', 'call.ended', 'voicemail.new'],
   secret: 'your-hmac-secret', // optional — enables X-Webhook-Signature header
 });
 ```
@@ -185,11 +186,26 @@ app.post('/api/voip-webhook', (req, res) => {
 
     case 'call.ended': {
       const ended = envelope.data as CallEndedEvent;
+      // ended.status: 'completed' | 'failed' | 'missed' | 'voicemail'
       // ended.forwardedTo is non-null when the call was forwarded
+      // ended.was_voicemail is true when a voicemail message was left
+      if (ended.status === 'voicemail') {
+        console.log(`Voicemail left for ${ended.destination}`);
+      }
       saveCdr(ended);
       break;
     }
 
+    case 'voicemail.new': {
+      const vm = envelope.data as VoicemailNewEvent;
+      // vm.extension: '1001' (extension that received the voicemail)
+      // vm.caller: '+17861234567'
+      // vm.duration: 23 (seconds)
+      // vm.recordingFile: '/var/lib/voip-voicemail/.../msg.mp3'
+      notifyVoicemail(vm);
+      break;
+    }
+
     case 'call.answered': {
       const answered = envelope.data as CallAnsweredEvent;
       // answered.forwardedTo is present when a forwarded call was answered
@@ -248,6 +264,23 @@ app.post('/api/voip-webhook', (req, res) => {
 }
 ```
 
+**`voicemail.new`:**
+```json
+{
+  "event": "voicemail.new",
+  "timestamp": "2026-05-14T18:15:30Z",
+  "data": {
+    "callUuid": "a1b2c3d4-...",
+    "extension": "1001",
+    "caller": "+17861234567",
+    "callerName": "John Doe",
+    "duration": 23,
+    "recordingFile": "/var/lib/voip-voicemail/.../msg.mp3",
+    "timestamp": "2026-05-14T18:15:30Z"
+  }
+}
+```
+
 ### Call Queues
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cemscale-voip/voip-sdk",
-  "version": "1.55.0",
+  "version": "1.55.1",
   "description": "VoIP SDK for CemScale multi-tenant platform — API client, WebRTC, React hooks",
   "type": "module",
   "main": "dist/index.js",