Điều kiện chuẩn bị
Trước khi bắt đầu, hãy đảm bảo bạn có:- Một portal được cấu hình tên miền riêng chạy giao thức bảo mật HTTPS và truy cập được công khai.
- Một tài khoản TikTok Doanh nghiệp (TikTok Business Account) đăng ký tại khu vực được hỗ trợ (tài khoản cá nhân không được hỗ trợ).
- Thiết lập nhận tin nhắn trực tiếp ở chế độ Mọi người (Everyone) trên ứng dụng TikTok.
- Một tài khoản TikTok Developer đăng ký tại trang developers.tiktok.com.
- Quyền quản trị cao nhất (Super Admin) trên Portal của bạn để thiết lập Credentials.
Bước 1: Đăng ký tài khoản TikTok Developer
Để bắt đầu, bạn cần có tài khoản nhà phát triển trên hệ thống của TikTok để khởi tạo và quản lý ứng dụng kết nối.Đăng ký tài khoản nhà phát triển
Truy cập developers.tiktok.com và tiến hành đăng ký tài khoản.
Bước 2: Đăng ký ứng dụng mới
Việc đăng ký ứng dụng trên cổng nhà phát triển giúp bạn lấy được các khóa bảo mật quan trọng (App ID và App Secret) nhằm liên kết hệ thống một cách an toàn.Tạo ứng dụng
Truy cập trang quản trị ứng dụng doanh nghiệp tại business-api.tiktok.com/portal/apps và nhấn Create App.
Nhập thông tin ứng dụng
Điền các thông tin theo yêu cầu:
- App Name: Tên ứng dụng của bạn (ví dụ:
Tên_Thương_Hiệu - ChatconnectX). - App Description: Mô tả ngắn gọn mục đích sử dụng ứng dụng (ví dụ: hỗ trợ khách hàng và tự động hóa tin nhắn).
- App Icon: Tải lên logo thương hiệu của bạn.
- Terms of Service URL: Đường dẫn đến trang Điều khoản dịch vụ của bạn.
- Privacy Policy URL: Đường dẫn đến trang Chính sách bảo mật của bạn.
Bước 3: Gửi yêu cầu cấp quyền Business Messaging API
TikTok yêu cầu bạn gửi hồ sơ xin cấp quyền sử dụng API gửi/nhận tin nhắn để đảm bảo an toàn dữ liệu người dùng.Yêu cầu sản phẩm Business Messaging
Mở ứng dụng của bạn trên cổng TikTok Developer Portal, tìm sản phẩm Business Messaging API và nhấn kích hoạt.
Gửi hồ sơ đăng ký quyền truy cập
Điền biểu mẫu đăng ký bao gồm các nội dung:
- Mô tả chi tiết kịch bản sử dụng (ví dụ: cung cấp dịch vụ CSKH tự động cho doanh nghiệp).
- Giải trình cách hệ thống của bạn xử lý và lưu trữ dữ liệu của người dùng TikTok.
- Cung cấp thông tin đăng ký doanh nghiệp/tổ chức của bạn.
Bước 4: Cấu hình Credentials trên Portal quản trị
Sau khi có các thông số khóa bảo mật từ ứng dụng TikTok, bạn tiến hành lưu chúng trên Portal quản trị của mình.Mở trang quản trị Platform Credentials
Đăng nhập vào Portal của bạn dưới quyền Super Admin, truy cập đường dẫn:
Mở cấu hình TikTok
Tìm thẻ cấu hình TikTok, nhấn nút Edit để mở biểu mẫu và điền mã Client ID (App ID) cùng với App Secret.
Bước 5: Cấu hình Quyền ứng dụng và đường dẫn Redirect URL
Sau khi được phê duyệt quyền API, bạn cần chỉ định quyền cụ thể cho tài khoản và cấu hình nơi TikTok chuyển hướng người dùng về sau khi họ hoàn tất đăng nhập (Redirect URL).Bật quyền tài khoản
Hãy đảm bảo quyền TikTok Accounts (Phạm vi truy cập thông tin tài khoản) đã được bật trong cấu hình ứng dụng của bạn trên TikTok Developer Portal.
Hướng dẫn kết nối cho người dùng
Sau khi hoàn tất cấu hình ứng dụng trên TikTok Developer Portal và nhập Credentials vào Portal quản trị, khách hàng của bạn có thể tự kết nối tài khoản TikTok Business của họ. Xem chi tiết tại Hướng dẫn kết nối TikTok.Xử lý sự cố thường gặp
Kênh TikTok không xuất hiện trên trang Dashboard
Kênh TikTok không xuất hiện trên trang Dashboard
Kiểm tra xem bạn đã kích hoạt tính năng TikTok cho tài khoản của mình trong trang quản trị Super Admin chưa, đồng thời đảm bảo các biến môi trường cấu hình liên quan đã được lưu và máy chủ đã được khởi động lại.
Xác thực OAuth thất bại
Xác thực OAuth thất bại
Hãy kiểm tra lại đường dẫn Redirect URL trên TikTok Developer Portal xem đã khớp chính xác với tên miền của bạn (
https://app.chatconnectx.com/tiktok/callback) chưa. Đồng thời đảm bảo sản phẩm Business Messaging API đã hiển thị trạng thái phê duyệt (Approved).Không nhận được tin nhắn gửi đến
Không nhận được tin nhắn gửi đến
Thử chạy lệnh kiểm tra webhook trong Rails console của hệ thống để xác minh webhook đã đăng ký thành công. Đảm bảo máy chủ của bạn có thể tiếp nhận các yêu cầu HTTPS công khai từ internet và tài khoản TikTok Business của khách được đăng ký tại khu vực địa lý được hỗ trợ.
Không thể gửi phản hồi tin nhắn
Không thể gửi phản hồi tin nhắn
Đảm bảo bạn đang phản hồi tin nhắn trong khung thời gian quy định 48 giờ của TikTok. Hãy kiểm tra xem kênh có yêu cầu kết nối lại (Reauthorize) do token truy cập hết hạn hay không.