← Tất cả bài viết
Nhật ký thay đổi

UnifyPort Exporter chính thức ra mắt: Tiện ích trình duyệt kết nối tài khoản X và TikTok chỉ trong một cú nhấp — UnifyPort

Bản cập nhật lần này

UnifyPort Exporter (v1.0.0) hiện đã có mặt trên Chrome Web Store. Đây là một tiện ích trình duyệt chỉ nặng 37 KB, làm đúng một việc: khi bạn đang đăng nhập X (Twitter) hoặc TikTok trên trình duyệt, nó sẽ ghi lại thông tin phiên (session) của tài khoản đó và lưu thành file JSON ngay trên máy tính của bạn — không tải lên đâu cả, không qua bên thứ ba nào.

File JSON đó chính là mảnh ghép còn thiếu trong luồng kết nối auth_mode=session của UnifyPort. Trước đây, để có một bản export session hợp lệ cho X hoặc TikTok, bạn thường phải dùng công cụ khác hoặc làm thủ công. Với UnifyPort Exporter, mọi thứ chỉ còn là: đăng nhập, bấm icon, bấm export — xong.

Với các đội nhóm ở Việt Nam đang dùng cả WhatsApp lẫn Zalo qua webhook hợp nhất của UnifyPort, đây là cách dễ nhất để bổ sung thêm kênh X hoặc TikTok mà không cần thêm bước cấu hình phức tạp.

X (Twitter): toàn bộ luồng nhập phiên

X đã hỗ trợ auth_mode=session từ khi API v1 ra mắt — bạn cung cấp một phiên đã được xác thực, UnifyPort sẽ hoàn tất việc nhập. Luồng thực hiện như sau:

1. Tạo bản ghi tài khoản

POST /v1/accounts
Content-Type: application/json

{
  "provider": "twitter",
  "auth_mode": "session"
}

2. Export session bằng UnifyPort Exporter

Mở X trên trình duyệt, đảm bảo bạn đã đăng nhập đúng tài khoản muốn kết nối, nhấp vào icon UnifyPort Exporter và chọn Export X session. Tiện ích sẽ tạo ra một file JSON chứa cookie và thông tin phiên/người dùng của trang cho tài khoản đó.

3. Nhập session

POST /v1/accounts/{account_id}/auth/session/import
Content-Type: application/json

{
  "params": {
    "session_url": "<đường dẫn tới file JSON session đã export>",
    "pin": "0000"
  }
}

params.pin chỉ cần thiết nếu tài khoản bật xác thực hai lớp (2FA) — giá trị mặc định là 0000. Nếu cần định tuyến theo vị trí địa lý ở bước này, bạn cũng có thể truyền thêm params.proxy_config.

4. Khởi động runtime

Sau khi phản hồi xác nhận session hợp lệ, khởi động runtime như bình thường:

POST /v1/accounts/{account_id}/runtime/start

Từ đây, tin nhắn từ X sẽ được gửi đến webhook của bạn dưới dạng sự kiện message.received, theo cùng một schema chuẩn hóa như các kênh khác.

TikTok: cũng chỉ một cú nhấp để export

TikTok không có API tin nhắn riêng (DM API) chính thức — các đội nhóm cần nhận tin nhắn TikTok đã sử dụng phương thức kết nối dựa trên session của UnifyPort cho kênh này (xem bài viết trước của chúng tôi về cách nhận tin nhắn TikTok khi không có DM API). UnifyPort Exporter bổ sung thêm tùy chọn TikTok session export bên cạnh X, theo cùng cách thức: đăng nhập, bấm export, và nhận file JSON sẵn sàng để dùng cho luồng kết nối tài khoản.

Với cả X và TikTok, tiện ích yêu cầu bạn phải đang đăng nhập sẵn vào tài khoản mục tiêu trên trình duyệt — nó không xử lý việc đăng nhập, chỉ ghi lại session đã có sẵn.

Quyền riêng tư và phạm vi

Một vài điểm đáng chú ý từ trang mô tả tiện ích:

  • Chỉ xử lý cục bộ. File export được ghi thẳng vào máy tính của bạn, bản thân tiện ích không tự động gửi đi đâu cả.
  • Hiện hỗ trợ hai nền tảng. v1.0.0 hỗ trợ X và TikTok. Nếu đội của bạn đang kết nối WhatsApp, Telegram, LINE hoặc Zalo, các nhà cung cấp này đã có sẵn luồng mã/QR/session riêng qua /v1/accounts/{id}/auth/session/* và không cần dùng tiện ích này.
  • Không bán dữ liệu. Nhà phát triển (unifyport.ai) khẳng định tiện ích không thu thập, bán hoặc chuyển giao dữ liệu người dùng cho bên thứ ba ngoài chức năng cốt lõi.

Bắt đầu như thế nào

  1. Cài đặt UnifyPort Exporter từ Chrome Web Store.
  2. Đăng nhập X hoặc TikTok trên cùng trình duyệt đó.
  3. Nhấp vào icon tiện ích và export session cho tài khoản muốn kết nối.
  4. Tạo tài khoản qua POST /v1/accounts với provider: "twitter" (hoặc provider tương ứng cho TikTok) và auth_mode: "session".
  5. Nhập session qua /auth/session/import, sau đó khởi động runtime.

Nếu đội của bạn đã dùng UnifyPort để nhận tin nhắn WhatsApp hoặc Telegram nhưng vẫn ngần ngại thêm kênh X hay TikTok vì bước export session quá rườm rà, giờ thì lý do đó không còn nữa — chỉ cần thêm vài cú nhấp chuột trên cùng webhook hợp nhất bạn đang dùng.