Tạo Shopify Custom App để kết nối HexaSync

Q: Store Domain là gì?

Store Domain là tên miền kỹ thuật của cửa hàng, có đuôi .myshopify.com. Tên miền này khác với đường dẫn trang quản trị Shopify và tên miền bán hàng tùy chỉnh.

Hướng dẫn này giúp bạn tự tạo Shopify Custom App trên Shopify Dev Dashboard để chuẩn bị kết nối cửa hàng Shopify với HexaSync Automation Engine. Sau khi hoàn tất, bạn có đủ thông tin ứng dụng để cấp quyền kết nối trên HexaSync.

Lưu ý: Tài liệu cũ dùng tên “Shopify Private App”. Ứng dụng mới hiện được tạo qua Shopify Dev Dashboard, không theo các bước tạo legacy custom app trực tiếp trong Shopify Admin.

Chuẩn bị trước khi bắt đầu

Tài khoản Shopify của chủ cửa hàng, hoặc tài khoản có quyền App development > Develop để tạo và quản lý ứng dụng.
Cửa hàng Shopify cần kết nối và Store Domain kết thúc bằng .myshopify.com.

Tạo và cấu hình Shopify Custom App

Bước 1: Mở Shopify Dev Dashboard

Đăng nhập Shopify Admin bằng tài khoản có quyền tạo và quản lý ứng dụng cho cửa hàng cần kết nối.
Vào Settings > Apps > Develop apps > Build apps in Dev Dashboard để mở Shopify Dev Dashboard.
Trong Shopify Dev Dashboard, chọn đúng tổ chức quản lý cửa hàng cần kết nối, sau đó mở Apps.

Không tìm thấy đường dẫn trên? Truy cập trực tiếp Shopify Dev Dashboard và đăng nhập bằng tài khoản Shopify.

Không thấy tùy chọn tạo ứng dụng? Tài khoản của bạn có thể chưa được cấp quyền phù hợp. Hãy nhờ chủ cửa hàng hoặc quản trị viên tổ chức Shopify cấp quyền App development > Develop trước khi tiếp tục. Bạn cũng có thể tham khảo hướng dẫn sử dụng Shopify Dev Dashboard của Shopify.

Bước 2: Tạo ứng dụng mới

Tại Apps, chọn Create app.
Chọn Start from Dev Dashboard.
Đặt tên dễ nhận biết cho ứng dụng, sau đó chọn Create app.

Bước 3: Cấu hình URL và API access

Trong ứng dụng vừa tạo, mở Versions và chọn Create version.
Tại mục URLs, nhập chính xác:
- App URL: https://app.hexasync.com
- Allowed redirection URL(s): https://app.hexasync.com/callback/install/shopify
Tại mục API access, cấu hình 9 scopes sau:

read_products
read_orders
read_inventory
read_shipping
read_locations
read_fulfillments
read_assigned_fulfillment_orders
read_merchant_managed_fulfillment_orders
read_third_party_fulfillment_orders

Lưu ý: Nếu ứng dụng đã có redirect URL khác, giữ lại địa chỉ cần thiết và bổ sung URL của HexaSync theo định dạng danh sách mà Shopify hỗ trợ.

Nếu màn hình yêu cầu Webhooks API version, hãy dùng phiên bản được chỉ định cho dự án của bạn.

Bước 4: Phát hành phiên bản

Kiểm tra lại App URL, Allowed redirection URL(s) và API scopes.
Chọn Release và xác nhận phát hành nếu Shopify yêu cầu.

Lưu ý: Nếu sau này thay đổi scopes, bạn cần phát hành phiên bản mới và cập nhật quyền cài đặt tương ứng.

Bước 5: Lấy Client ID và Client Secret

Mở Settings > Credentials của ứng dụng trong Dev Dashboard.
Sao chép Client ID và Client Secret để nhập trực tiếp vào biểu mẫu kết nối trên HexaSync.

Lưu ý bảo mật: Không đăng công khai hoặc chia sẻ Client Secret qua email, nhóm chat hay ảnh chụp màn hình.

Bước 6: Xác định Store Domain

Trong Shopify Admin, mở Settings > Domains.
Tìm tên miền .myshopify.com của cửa hàng, ví dụ hexasync-store.myshopify.com.

Lưu ý: Không nhập URL trang quản trị Shopify hoặc tên miền bán hàng tùy chỉnh.

Kiểm tra trước khi chuyển sang HexaSync

Ứng dụng đã có phiên bản được phát hành.
App URL và Allowed redirection URL(s) được khai báo chính xác.
Ứng dụng có đủ 9 scopes ở Bước 3.
Đã có Client ID, Client Secret và Store Domain.

Sau khi chuẩn bị xong, tiếp tục kết nối theo hướng dẫn bắt đầu với Shopify trên HexaSync. Bạn không cần tự mở distribution link để cài ứng dụng trước khi nhập thông tin trên HexaSync.

Câu hỏi thường gặp

Tôi có bắt buộc tự tạo Shopify Custom App không?

Có. Theo quy trình kết nối này, bạn tự tạo và quản lý Shopify Custom App cho cửa hàng của mình.

Có cần cấp quyền ghi dữ liệu không?

Không. Shopify Connector App chỉ đọc dữ liệu, nên ứng dụng chỉ cần 9 scopes ở Bước 3.

Store Domain là gì?

Store Domain là tên miền kỹ thuật của cửa hàng, có đuôi .myshopify.com. Tên miền này khác với đường dẫn trang quản trị Shopify và tên miền bán hàng tùy chỉnh.

Có phải gửi Client Secret cho Beehexa không?

Không. Bạn chỉ nhập Client Secret vào trường tương ứng trong luồng kết nối trên HexaSync và bảo vệ thông tin này như một mật khẩu.

Tạo app xong đã kết nối Shopify với HexaSync chưa?

Chưa. Bạn còn phải cấp quyền kết nối và tạo Shopify Connector App trên HexaSync theo hướng dẫn bắt đầu với Shopify trên HexaSync.