nextX

Hướng dẫn

Nhúng softphone NextX vào phần mềm của bạn

Tổng đài viên nghe và gọi ngay trong phần mềm của bạn, không mở thêm tab NextX. Một thẻ script, không cần máy chủ.

  1. 1Khai tên miền được nhúng

    developers.nextx.vn › Ứng dụng của tôi › Cài đặt › Softphone nhúng → nhập tên miền phần mềm của bạn (vd https://crm.cong-ty.vn). Trang không có tên ở đây không nhúng được softphone.

    Tích hợp →

  2. 2Dán thẻ script

    Softphone hiện ở góc màn hình. Lần đầu, tổng đài viên bấm Đăng nhập NextX trong cửa sổ bật lên. Trang của bạn chỉ nhận sự kiện cuộc gọi, không bao giờ nhận token hay thông tin máy lẻ. Thêm data-nextx-call vào số điện thoại để bấm là gọi.

    HTML
    <script src="https://developers.nextx.vn/phone/v1/phone.js"></script>
<script>
  const phone = NextXPhone.init({ clientId: "<APP_ID>" });   // lang, workspaceId, position, appUrl
  phone.on("incoming", (c) => openCustomer(c.from));          // screen-pop
  phone.on("ended", (c) => saveCallLog(c.callId, c.status, c.talkSec));
</script>

<!-- click-to-dial: any element with data-nextx-call -->
<a href="#" data-nextx-call="0901234567" data-nextx-contact-ref="CUS-00123">0901 234 567</a>

  3. 3Hoặc dùng gói npm

    Cùng mã với bản script, có kiểu TypeScript. Sự kiện: ready, auth-required, status, incoming, answered, ended, error.

    npm
    npm i @nextxai/sdk

import { NextXPhone } from "@nextxai/sdk/phone";

const phone = NextXPhone.init({ clientId: process.env.NEXT_PUBLIC_NEXTX_APP_ID! });
phone.call("0901234567", { contactRef: "CUS-00123" });
phone.on("answered", ({ callId }) => markInProgress(callId));
// phone.hangup() · phone.logout() · phone.destroy()

    SDK Node · Python →

  4. 4Thử ngay

    Thêm https://developers.nextx.vn vào tên miền được nhúng rồi mở trang thử. Muốn ghi lịch sử phía máy chủ thì dùng thêm webhook call.*.

    Sandbox →REST + webhook →