9.24. TIKTOKSHOP CUSTOM APP - SMAXAI

1. Tạo tài khoản develop của tiktok

• Điền các thông tin cơ bản:
  • Email
  • SĐT(optional)
  • Mật khẩu

2. Tạo custom app, xác thực app, cần có giấy đăng ký kinh doanh

• Tạo custom app:
  • Hạng mục thị trường
    • Bấm nút "Thêm hạng mục thị trường"

• Nhấn nút "Bắt đầu" ở mục Bắt đầu hoạt động kinh doanh của bạn

• Chọn Khu vực đăng ký công ty và Thị trường mục tiêu(VD: Việt Nam)

• Hạng mục kinh doanh:
  • chọn Nhà phát triển ứng dụng > Quản lý thương mại điện tử > Lập kế hoạch nguồn lực doanh nghiệp

• Thông tin đối tác
  • Tên đối tác
  • Email
  • SĐT (optional)

• Bấm "Nhận khoá ứng dụng ngay" để đến trang tạo Custom App
• Tạo ứng dụng và dịch vụ: chọn dịch vụ tuỳ chỉnh(custom app)

• Thể loại dịch vụ: Chọn Dịch vụ khách hàng

• Tên app
• Logo(optional)

• Thị trường người bán:
  • Khu vực: Việt Nam
  • Loại người bán: Người bán địa phương

• Bật API

  • URL chuyển hướng(redirect url):
    • prod: https://smax.ai/connected

• Bấm tạo app

• Xác thực đối tác (Partner registration approval)

  • Tên đối tác
  • Giấy chứng nhận công ty
  • Thông tin đăng ký công ty
    • Mã số đăng ký công ty
    • Tên hợp pháp của công ty
    • Thời gian hiệu lực của giấy chứng nhận
    • Địa chỉ đăng ký của công ty
    • Quy mô kinh doanh của công ty (tuỳ chọn)
  • Giới thiệu về công ty
    • Mô tả về doanh nghiệp
    • Website

• Xác thực app(Xét duyệt ứng dụng): chỉ thực hiện được sau khi xác thực đối tác được xét duyệt, điền các mục :

  • Thông tin gói API
  • Kiểm thử sản phẩm
  • Ảnh chụp màn hình sản phẩm

  \

3. Xin các quyền API

• Vào mục Quản lý API, chọn các scopes:

  • Customer Service: Nhận & gửi tin nhắn, nhận webhook new_message

    

    • Để xin quyền cần cung cấp:

      • Lý do xin quyền:

      javascript
      Our application is built for TikTok Shop sellers to manage customer inquiries efficiently. 
      We need the Customer Service API to:
      - Fetch customer chat messages from TikTok Shop
      - Send automated replies and order support information
      - Improve response time with chatbot integration
      - Assign conversations to support staff inside our system
      
      This API will help enhance customer satisfaction, reduce response delays, and support business growth on TikTok Shop. The feature will only be used for authorized TikTok Shop accounts through official OAuth.

      • Danh sách ảnh kèm theo(3-10 ảnh, tối đa 10Mb mỗi ảnh), các ảnh có nội dung liên quan đến:
        • Trang home Smax.AI
        • Các step kết nối với Tiktokshop
        • Màn hình list danh sách tin nhắn
        • Giao diện chat giữa khách và nhân viên
        • Giao diện quản lý trả lời tin nhắn

  • Global Shop Information: Lấy thông tin cơ bản của shop

  • Order Information: Lấy đơn hàng, nhận webhook order_status_change

  • Product Basic: Lấy thông tin sản phẩm

  • Shop Authorized Information: Quản lý shop đã ủy quyền cho app

  • Update Delivery Status: Cập nhật trạng thái giao hàng cho đơn

4. Kết nối với webhook chung (mục Quản lý webhook)

• Webhook url:
  • Prod: https://api.smax.ai/webhooks/tiktokshop
• Webhook topics:
  • Order Status Change: khi trạng thái đơn hàng thay đổi
  • Reverse Status Update: khi trạng thái hoàn/đổi trả đơn hàng thay đổi
  • Recipient Address Update: khi người nhận cập nhật địa chỉ giao hàng của đơn hàng
  • Package Update: khi có cập nhật liên quan đến gói hàng
  • Product Status Change: khi trạng thái sản phẩm thay đổi
  • Seller Deauthorization: khi người bán hủy quyền truy cập app
  • Auth Expire: khi token gần hết hạn
  • New conversation: khi có cuộc hội thoại với khách mới
  • New message: khi có tin nhắn của shop và khách