Skip to content

Releases: leecats/smax-woo-integration

Release list

2.1.4

2.1.4 Latest
Latest

Choose a tag to compare

View all tags
@leecats leecats released this 10 Jul 09:45
v2.1.4
d7ec22a

Smax.AI – WooCommerce Integration v2.0

Plugin tự động gọi API Smax.ai mỗi khi đơn hàng WooCommerce thay đổi trạng thái.

Tính năng chính

Nhiều kết nối (Multi-Connection)

  • Khai báo nhiều biz alias + API key khác nhau
  • Mỗi kết nối có tên riêng, bật/tắt độc lập
  • Một quy tắc chọn 1 kết nối → cùng trạng thái đơn có thể gọi nhiều biz khác nhau

Nhiều quy tắc

  • Tạo bao nhiêu quy tắc tùy ý cho mỗi trạng thái đơn hàng
  • Mỗi quy tắc gắn với 1 kết nối cụ thể
  • Có thể giới hạn quy tắc theo một hoặc nhiều sản phẩm có trong đơn hàng
  • Bật/tắt từng quy tắc mà không cần xóa

Phân nhánh theo Platform

  • custom / zaloweb / whatsappweb: Gọi API /customers để tạo customer → lấy pid → gọi /send
  • facebook: Bỏ qua tạo customer, lấy pid từ tham số URL (tự bắt ?smax_pid=ctmXXX → lưu order meta)

Xử lý bất đồng bộ

  • Dùng Action Scheduler (tích hợp sẵn WooCommerce) để chạy background
  • Khách hàng checkout không bị chậm dù có bao nhiêu quy tắc

Placeholder & Order Meta

  • Hỗ trợ 25+ placeholder: {billing_phone}, {order_total}, {order_key}, {product_names},…
  • Hỗ trợ {meta:tên_key} để lấy bất kỳ order meta nào

Cài đặt

  1. Upload thư mục smax-woo-integration vào /wp-content/plugins/
  2. Kích hoạt plugin
  3. Vào WooCommerce → Smax.AI

Hướng dẫn sử dụng

Bước 1: Tạo kết nối

  • Tab Kết nối → + Thêm kết nối
  • Nhập tên, Biz Alias, API Key
  • Có thể tạo nhiều kết nối cho nhiều business khác nhau

Bước 2: Tạo quy tắc

  • Tab Quy tắc → + Thêm quy tắc
  • Chọn kết nối, trạng thái đơn hàng, platform
  • Cấu hình thông tin customer và block

Bước 3: Theo dõi

  • Tab Nhật ký xem log request/response
  • Mỗi đơn hàng có ghi chú kết quả gọi API

API Flow

Đơn hàng đổi trạng thái
        │
    ┌───┴───┐
    │ Rule  │ ← chọn Connection (biz + key)
    └───┬───┘
        │
   Platform?
    ┌───┴────────────────────┐
    │ custom/zaloweb/        │ facebook
    │ whatsappweb            │
    │                        │
    ▼                        ▼
 POST /customers          Đọc order meta
 → lấy pid               _smax_pid
    │                        │
    └────────┬───────────────┘
             ▼
       POST /send
       { block_id, page_pid,
         customer_pid, attrs }

Yêu cầu

  • WordPress 5.8+
  • WooCommerce 6.0+
  • PHP 7.4+
Assets 3
Loading