Hướng dẫn này trình bày cách kết nối Shopify với HexaSync để thiết lập Shopify Connector App. Sau khi hoàn tất, bạn có thể truy cập dữ liệu sản phẩm, tồn kho và đơn hàng từ Shopify trên HexaSync để hỗ trợ kiểm tra, làm sạch và chuẩn bị dữ liệu. Đây là bước đầu tiên để tích hợp Shopify với các hệ thống khác, chẳng hạn như Shopify và các phần mềm bán hàng khác.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để truy cập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Tài khoản Shopify có quyền cài đặt ứng dụng cho cửa hàng cần kết nối.
- Shopify Custom App đã được tạo và cấu hình, cùng Client ID và Client Secret của ứng dụng.
- Store Domain của cửa hàng, có dạng
ten-cua-hang.myshopify.com.
Nếu chưa tạo ứng dụng hoặc chưa có các thông tin trên, hãy làm theo hướng dẫn tạo Shopify Custom App để kết nối với HexaSync trước.
Phần 1: Cấp quyền kết nối Shopify trên HexaSync
Bước 1: Đăng nhập HexaSync
- Truy cập HexaSync Automation Engine và đăng nhập bằng tài khoản Beehexa.
Bước 2: Bắt đầu kết nối Shopify
- Mở trang thiết lập kết nối Shopify trên HexaSync.
- Tại màn hình Check connection details, chọn Connect.
Bước 3: Nhập thông tin ứng dụng Shopify
- Trên màn hình Choose an app to connect to Shopify, chọn Use a different app, sau đó chọn I will provide my Shopify app.
- Tại màn hình Register a New Shopify App, nhập Client ID, Client Secret và Store Domain đã chuẩn bị, sau đó chọn Continue.
Lưu ý: Sao chép chính xác các giá trị, không kèm khoảng trắng thừa.
Bước 4: Cấp quyền cho ứng dụng trong Shopify
- Trên trang cài đặt ứng dụng của Shopify, chọn Install.
- Sau khi cấp quyền thành công, Shopify chuyển bạn về HexaSync và hiển thị Connection successful.
Bước 5: Tạo Shopify Connector App
- Sau màn hình Connection successful, kiểm tra tên ứng dụng trên màn hình tiếp theo. Nếu thông tin chính xác, chọn Create Shopify Connector App để hoàn tất thiết lập.
- Mở Connector Apps để tìm và quản lý Shopify Connector App vừa tạo.
Phần 2: Cấp lại quyền kết nối Shopify trên HexaSync
Áp dụng khi bạn đã có Shopify Connector App và cần cấp lại quyền truy cập.
Bước 1: Mở Shopify Connector App
- Mở Connector Apps, chọn Shopify Connector cho cửa hàng của bạn.
- Nhấn chọn Settings ở menu bên trái.
Bước 2: Chọn Re-authorize
- Trong Settings, tìm thông tin kết nối Shopify và chọn Re-authorize.
Không thấy Re-authorize? Chỉ người đã tạo thông tin kết nối này mới có quyền cấp lại quyền. Hãy nhờ họ thực hiện bước này.
Bước 3: Xác nhận ứng dụng và Store Domain
- Xác nhận ứng dụng Shopify và chọn Continue.
- Nhập Store Domain và làm theo hướng dẫn trên màn hình.
Bước 4: Cấp lại quyền trên Shopify
- Tại trang cài đặt ứng dụng trên Shopify, chọn Install để hoàn tất cấp lại quyền.
Phần 3: Lỗi thường gặp và cách xử lý
| Thông báo | Cách xử lý |
|---|---|
| Shopify từ chối cài đặt hoặc báo lỗi redirect URL | Kiểm tra App URL và Allowed redirection URL(s) theo hướng dẫn tạo Shopify Custom App. Nếu Shopify vẫn từ chối cài đặt, liên hệ support@beehexa.com. Quy trình này không yêu cầu tự tạo Distribution Link. |
| We Could Not Find Your Installation Details | Quá trình cài đặt bị hủy hoặc thông tin phiên không được trả về. Bấm Back to installation và thử lại trên cùng trình duyệt. Nếu lỗi lặp lại, kiểm tra lại redirect URL trong Shopify Custom App. |
| HexaSync Could Not Register Your Shopify App | Kiểm tra Client ID và Client Secret thuộc cùng một ứng dụng và không chứa khoảng trắng thừa, rồi quay lại luồng kết nối để nhập lại. |
| We Couldn’t Finish Connecting Your Shopify Store | Kiểm tra Technical details, bấm Back to installation và thực hiện lại. Nếu lỗi lặp lại, liên hệ support@beehexa.com kèm thông báo lỗi. |
| HexaSync Could Not Verify The Stored Credential | Bấm Back to installation và thực hiện lại. Nếu vẫn lỗi, liên hệ support@beehexa.com kèm Status và Detail from gateway. |
Với các trường hợp khác, hãy gửi ảnh chụp màn hình (đã che Client Secret và thông tin nhạy cảm) đến support@beehexa.com.
Câu hỏi thường gặp
Store Domain là gì?
Store Domain là tên miền kỹ thuật của cửa hàng Shopify, có đuôi .myshopify.com, ví dụ ten-cua-hang.myshopify.com. Không dùng URL trang quản trị hoặc tên miền bán hàng tùy chỉnh.
Lấy Client ID và Client Secret ở đâu?
Client ID và Client Secret lấy từ Shopify Custom App bạn đã tạo cho cửa hàng. Xem hướng dẫn tạo Shopify Custom App để biết cách chuẩn bị.
Nếu nhập sai Client ID hoặc Client Secret thì sao?
Kiểm tra lại Client ID và Client Secret trong Shopify Custom App, bảo đảm cả hai thuộc cùng một ứng dụng và không có khoảng trắng thừa. Sau đó quay lại màn hình đăng ký ứng dụng trên HexaSync để nhập lại.
Có cần tạo Distribution Link không?
Không. Quy trình kết nối này không yêu cầu bạn tự tạo Distribution Link.
Ứng dụng của tôi có cần Shopify App Review không?
Ứng dụng riêng do bạn tự tạo cho cửa hàng của mình không cần Shopify App Review như ứng dụng public. Nếu gặp trở ngại khi cài đặt, hãy liên hệ support@beehexa.com.
HexaSync có ghi hoặc sửa dữ liệu trên Shopify không?
Không. Shopify Connector App chỉ đọc dữ liệu, không ghi hoặc sửa dữ liệu trên Shopify.