@nextxai/sdk 0.2.0 → 0.3.0-beta.31

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 Theo [Semantic Versioning](https://semver.org/lang/vi/). Chính sách phiên bản: [VERSIONING.md](VERSIONING.md).
 
+## 0.3.0 (2026-10-31)
+
+### Thêm mới
+
+- Kiểm chữ ký webhook theo chuẩn Standard Webhooks: Node `@nextxai/sdk/webhooks` (`verifyWebhook`, `signWebhook`, kiểu sự kiện `call.*` · `agent.status_changed`), Python `nextx_sdk.webhooks` (`verify_webhook`, `sign_webhook`).
+- `NextXPhone.answer()`: nhấc cuộc đang đổ chuông từ phần mềm của bạn (ví dụ nút "Nghe" trên màn khách hàng khi nhận sự kiện `incoming`). Chuyển máy dùng REST `POST /api/v1/call/partner/calls/{id}/transfer`.
+- `GET /api/v1/call/calls/{id}/transcript`: Transcript STT
+- `GET /api/v1/call/calls/{id}/summary`: AI summary + sentiment
+- `POST /api/v1/call/partner/calls`: Bấm gọi thay tổng đài viên (click-to-call)
+- `GET /api/v1/call/partner/calls/{id}`: Chi tiết một cuộc gọi
+- `POST /api/v1/call/partner/calls/{id}/hangup`: Gác máy
+- `POST /api/v1/call/partner/calls/{id}/transfer`: Chuyển máy
+- `GET /api/v1/call/partner/calls/{id}/recording`: Link tải ghi âm (15 phút)
+- `GET /api/v1/call/partner/active-calls`: Cuộc gọi đang diễn ra
+- `GET /api/v1/call/partner/agents/status`: Trạng thái tổng đài viên
+- `PUT /api/v1/call/partner/agents/status`: Đặt trạng thái tổng đài viên
+- `#/ContractSummaryDto`: Thêm trường autoRenewStatus
+- `#/PartnerSetAgentStatusRequest`: Thêm kiểu
+- `#/PartnerAgentStatusDto`: Thêm kiểu
+- `#/PartnerAgentDto`: Thêm kiểu
+- `#/PartnerRecordingLinkDto`: Thêm kiểu
+- `#/PartnerTransferRequest`: Thêm kiểu
+- `#/PartnerAgentRefRequest`: Thêm kiểu
+- `#/PartnerCallDto`: Thêm kiểu
+- `#/PartnerOriginateRequest`: Thêm kiểu
+- `#/CallSummaryAiDto`: Thêm kiểu
+- `#/ActionItemDto`: Thêm kiểu
+- `#/CallTranscriptDto`: Thêm kiểu
+- `#/TranscriptSegmentDto`: Thêm kiểu
+
 ## 0.2.0 (2026-10-30)
 
 ### Thêm mới

package/README.md

@@ -31,6 +31,32 @@ for (const c of data.items ?? []) console.log(c.fullName);
 const nx = createNextXClient({ accessToken: () => tokenStore.current() });
 ```
 
+## Nhận webhook
+
+Kiểm chữ ký theo chuẩn [Standard Webhooks](https://www.standardwebhooks.com) (chỉ chạy trên máy chủ). Truyền thân gốc, không phải JSON đã parse:
+
+```ts
+import { verifyWebhook } from "@nextxai/sdk/webhooks";
+
+app.post("/nextx/webhook", express.raw({ type: "application/json" }), (req, res) => {
+  const event = verifyWebhook(req.body, req.headers, process.env.NEXTX_WEBHOOK_SECRET!);
+  if (event.type === "call.completed") console.log(event.data.object.talkSec, event.data.object.contactRef);
+  res.sendStatus(204);
+});
+```
+
+Sai chữ ký hoặc lệch giờ quá 5 phút thì ném `WebhookVerificationError`. Dùng `event.id` để bỏ qua lần giao trùng.
+
+## Softphone nhúng (trình duyệt)
+
+```ts
+import { NextXPhone } from "@nextxai/sdk/phone";
+
+const phone = NextXPhone.init({ clientId: "nxa_…" });
+phone.on("incoming", (c) => openCustomer(c.from));
+phone.call("0901234567");   // phone.answer() · phone.hangup()
+```
+
 ## Ghi chú
 
 - Mặc định client gọi môi trường production. Khi thử nghiệm, dùng `SANDBOX_URL` với khoá sandbox.

package/dist/cjs/phone.d.ts

@@ -73,6 +73,8 @@ export declare class NextXPhone {
     call(number: string, opts?: {
         contactRef?: string;
     }): void;
+    /** Nhấc cuộc đang đổ chuông (sự kiện `incoming`) — y như tổng đài viên bấm "Nghe" trong khung. */
+    answer(): void;
     /** Gác cuộc gọi đang diễn ra. */
     hangup(): void;
     /** Đăng xuất NextX trong khung softphone. */

package/dist/cjs/phone.js

@@ -100,6 +100,10 @@ class NextXPhone {
     call(number, opts = {}) {
         this.send({ type: "call", number: String(number), contactRef: opts.contactRef });
     }
+    /** Nhấc cuộc đang đổ chuông (sự kiện `incoming`) — y như tổng đài viên bấm "Nghe" trong khung. */
+    answer() {
+        this.send({ type: "answer" });
+    }
     /** Gác cuộc gọi đang diễn ra. */
     hangup() {
         this.send({ type: "hangup" });