@cemscale-voip/voip-sdk 1.55.2 → 1.55.3

package/README.md

@@ -1208,9 +1208,65 @@ phone.on('error', (err) => console.error('Phone error:', err));
 ### Presence
 | Method | Description |
 |--------|-------------|
+| `setPresence(extensionId, status)` | Set manual status (`'busy'` / `'available'`) |
 | `getPresence()` | Simple map |
 | `getPresenceDetailed()` | Detailed with call info |
 
+### Presence Status Management
+
+Control extension availability from the CRM. When an agent sets themselves
+as `busy`, the phone still rings but the call is rejected with SIP 486
+and routed to voicemail. Setting back to `available` restores normal behavior.
+
+```typescript
+// Get current presence for all extensions
+const { presence } = await client.getPresence();
+// { '1001': 'available', '1002': 'busy', '1003': 'offline' }
+
+// Set an extension to busy (next call → voicemail)
+await client.setPresence('ext-uuid-here', 'busy');
+
+// Set back to available (calls ring normally)
+await client.setPresence('ext-uuid-here', 'available');
+```
+
+**WebSocket (real-time):** When any extension changes presence, all connected
+CRM clients receive `presence_change` instantly.
+
+```typescript
+client.connectWebSocket();
+
+client.onWsEvent('presence_change', (event) => {
+  // event.data.extension → '1001'
+  // event.data.status → 'busy'
+  updateAgentBadge(event.data.extension, event.data.status);
+});
+```
+
+**React with `usePresence` hook:**
+
+```tsx
+import { usePresence } from '@cemscale-voip/voip-sdk/hooks';
+
+function AgentPanel({ client, extensionId }) {
+  const { presence, getStatus } = usePresence(client);
+  const myStatus = getStatus('1001');
+  // 'available' | 'busy' | 'on_call' | 'offline' | 'dnd' | 'ringing'
+
+  return (
+    <div>
+      <span className={`badge ${myStatus}`}>{myStatus}</span>
+      <button onClick={() => client.setPresence(extensionId, 'busy')}>
+        Set Busy
+      </button>
+      <button onClick={() => client.setPresence(extensionId, 'available')}>
+        Set Available
+      </button>
+    </div>
+  );
+}
+```
+
 ### Reports
 | Method | Description |
 |--------|-------------|

package/package.json

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