Tích hợp store có sẵn

Hiện tại Inkble đã có sẵn chế độ tích hợp đối với các nền tảng thương mại điện tử phổ biến nhất trên thế giới, bao gồm Shopifty, Amazon, Etsy, WooCommerce, Wix.

Shopify

Để kết nối với cửa hàng đã có sẵn của mình, tại dashboard, ở thanh công cụ bên trái, bạn vào mục Setting -> Store, sau đó bấm vào Add Store ở góc phải màn hình:

Cửa sổ Add Store hiện có 2 chế độ, chuyển đổi bằng thanh tab ở đầu form:

• Manual: nhập tay Token đã lấy sẵn từ Shopify.
• Auto: kết nối tự động qua OAuth bằng Client ID / Client Secret của một app tạo trên Shopify, không cần copy Token thủ công.

Cách 1: Kết nối store thủ công (Manual)

Ở tab Manual, màn hình sẽ hiển thị các trường thông tin bạn phải nhập như ảnh:

Trong đó:

• Name: điền tên cửa hàng của bạn

• Url: link đường dẫn đến website cửa hàng của bạn trên nền tảng Shopify, là url gốc do Shopify tạo ra

• Token: mã bảo mật từ nền tảng Shopify để đảm bảo liên kết của bạn an toàn

• BrandCode: mã brand dùng để phân loại/gắn nhãn cửa hàng, không bắt buộc

Sau khi điền đủ thông tin, bấm Submit để hoàn tất, hoặc Cancel để huỷ.

Hướng dẫn lấy Token cho các cửa hàng

Tại dashboard cho người bán của Shopify, bạn bấm vào Settings ở góc trái màn hình.

Tại menu settings, bạn bấm vào Apps and sales channels => Develop apps để bắt đầu tạo app.

Nếu tài khoản Shopify của bạn chưa tích hợp một app nào khác trước đây, nền tảng sẽ yêu cầu quyền cho phép được tích hợp các app cho lần đầu tiên bạn sử dụng tính năng này. Bấm Allow custom app development để bắt đầu tạo app.

Tại màn hình app development, bấm vào Create an app.

Sau khi đặt tên cho app của bạn, màn hình sẽ hiển thị giao diện App development như bên dưới.

Để có thể bắt đầu Install app, Shopify sẽ yêu cầu bạn lựa chọn các tính năng mà app có thể thực hiện được trên Shopify. Vào mục Configuration và lựa chọn các tính năng mà bạn cho phép app được truy cập.

Cụ thể, các bạn cần phải cho phép apps Inkble quyền truy cập vào các tính năng sau của cửa hàng:

• Products: Cho phép hệ thống truy cập để lấy danh sách sản phẩm trên cửa hàng khi đồng bộ, tạo sản phẩm từ Inkble và tạo liên kết để nhận thông tin khi có sản phẩm mới trên cửa hàng
• Orders: Cho phép hệ thống lấy danh sách đơn hàng trên cửa hàng khi đồng bộ dữ liệu, tạo liên kết để nhận thông tin khi có đơn hàng mới trên cửa hàng
• Các quyền để hệ thống tự động cập nhật trạng thái vận chuyển đơn hàng:
  • Assigned fulfillment orders
  • Fulfillment services
  • Merchant-managed fulfillment orders
• Store content: Cho phép tạo các bản ghi link rút gọn khi tạo sản phẩm

Sau khi đã thiết lập xong quyền truy cập, vào phần API credentials bắt đầu Install app.

Khi đó màn hình sẽ hiển thị token như ảnh, bạn bấm vào Reveal token once và sao chép token để nhập vào phần token ở Shopify ở ảnh 4.

Lưu ý, token chỉ có thể được hiển thị và sao chép một lần duy nhất, sau khi bạn đã tích hợp app trên shopify và muốn tái sử dụng lại app thì phải bấm Uninstall app và thực hiện lại quy trình tích hợp app.

Sau khi hoàn thiện các thông tin, lựa chọn Submit để hoàn thiện việc tích hợp cửa hàng.

Sau khi tích hợp xong cửa hàng, bạn sẽ thấy hiện thông tin cửa hàng đã tích hợp tại dashboard của Inkble như hình.

Lưu ý, sau khi đã tích hợp xong app, hãy kiểm tra lại phần Hook của cửa hàng, bởi nếu không có thông tin này, Inkble sẽ không thể nhận được thông tin của các sản phẩm, đơn hàng trên store. Để đồng bộ real-time thông tin mới của cửa hàng trên nền tảng Shopify về hệ thống Inkble, vui lòng chọn Hook => Sync.

Cách 2: Kết nối store build bằng app dashboard (Auto)

Chế độ Auto dùng để kết nối store thông qua một app tạo sẵn trên Shopify, sử dụng Client ID / Client Secret của app để tạo yêu cầu cấp quyền truy cập API (API access request). Sau khi được phê duyệt, Inkble tự động nhận access token và hoàn tất kết nối, không cần copy Token thủ công.

Chuẩn bị app trên Shopify

Trước khi tạo app, mở Inkble, vào Add Store, chuyển sang tab Auto và bấm Copy để lấy sẵn Redirect URL — URL này sẽ cần dán vào app tạo trên Shopify ở các bước bên dưới.

Tại Shopify Admin, vào Settings ở góc dưới bên trái màn hình.

Trong màn hình Settings, chọn menu Apps, sau đó bấm Develop apps ở góc trên bên phải.

Tại màn hình App development, bấm Build apps in Dev Dashboard.

Tại Dev Dashboard, vào mục Apps, bấm Create app ở góc trên bên phải.

Ở màn hình Create an app, chọn Start from Dev Dashboard, nhập App name, sau đó bấm Create.

Sau khi tạo app, ở màn hình cấu hình phiên bản (Create version), điền các thông tin sau:

• App URL: điền phần domain đứng trước cụm /api/webhook/shopify/callback trong Redirect URL đã copy ở trên (ví dụ https://<domain>)
• API access => Scopes: nên chọn Use legacy install flow để đảm bảo app được cấp đầy đủ scope cần thiết sau khi connect, hoặc có thể tự chọn từng scope lẻ bằng Select scopes
• Redirect URLs: dán y nguyên Redirect URL đã copy từ Inkble ở bước đầu

Sau đó bấm Release để tạo version. Tiếp theo, vào mục Settings trong menu app (bên trái) để lấy Client ID và Secret tại khung Credentials.

Trước khi quay lại Inkble để Connect, cần tạo API access request cho app tại Shopify Partner:

Tại Shopify Partner Dashboard, vào mục App distribution => All apps, chọn app đã release (Distribution) trên Shopify.

Sau đó bấm vào tab API access requests, chọn Request access.

Tại màn hình Protected customer data access, select đầy đủ thông tin: chọn Reason cho mục Protected customer data, hoàn thành phần Provide your data protection details (trả lời các câu hỏi ở mục Data protection details), sau đó Save lại.

Sau khi gửi yêu cầu, đợi Shopify xét duyệt quyền truy cập trước khi thực hiện Connect ở bước tiếp theo.

Thêm store trên Inkble

Tại màn hình Add Store, chuyển sang tab Auto:

Trong đó:

• Name: điền tên cửa hàng của bạn

• Url: link đường dẫn đến website cửa hàng của bạn trên nền tảng Shopify

• Client ID: Client ID của app vừa tạo trên Shopify

• Client Secret: Client Secret của app vừa tạo trên Shopify

• BrandCode: mã brand dùng để phân loại/gắn nhãn cửa hàng, không bắt buộc

Form sẽ hiển thị sẵn Redirect URL (dạng https://<domain>/api/webhook/shopify/callback). URL này sinh riêng theo từng tài khoản Inkble, bạn bấm Copy và dán y nguyên URL đó vào mục Allowed redirection URL(s) trong cấu hình app trên Shopify. Riêng mục App URL, chỉ điền phần domain đứng trước cụm /api/webhook/shopify/callback (ví dụ https://<domain>). Nếu khai báo sai, Shopify sẽ chặn kết nối.

Sau khi khai báo xong Redirect URL ở phía Shopify, quay lại Inkble và bấm Connect. Nếu app đã được thiết lập đầy đủ, hệ thống sẽ tự động hoàn tất kết nối (không cần đăng nhập/approve thêm) và chuyển sang màn hình Webhook:

Màn hình này hiển thị:

• Nút Sync để đồng bộ lại webhook nếu cần
• Danh sách các webhook được tạo tự động (ID Webhook, Address, Topic như products/create, products/update, orders/updated, orders/paid...)
• Cảnh báo nếu token của store còn thiếu scope, kèm tên các scope còn thiếu

Nếu thấy cảnh báo thiếu scope, vào bổ sung các scope được liệt kê cho app bằng cách vào lại app tương ứng tại Dev Dashboard, tạo một version mới có bổ sung đầy đủ các scope còn thiếu, bấm Release để áp dụng version đó, sau đó quay lại Inkble bấm Reconnect lại.

Nếu có bất kỳ vấn đề nào liên quan đến việc tích hợp cửa hàng Shopify trên hệ thống Inkble, vui lòng liên hệ với bộ phận support của Inkble qua Telegram hoặc Facebook để được hỗ trợ.