Hướng dẫn tích hợp Magento
Tajo kết nối với Adobe Commerce (Magento 2) qua Commerce REST API. Không có extension Tajo nào cần cài vào codebase Magento của bạn: kết nối dùng một integration token, nhờ vậy pipeline deploy của cửa hàng không bị đụng đến.
Hiện tại Magento là kết nối được dựng trong quá trình onboarding: khác với Shopify và WooCommerce, Magento chưa tự phục vụ được, và đội ngũ Tajo sẽ đấu nối phần đồng bộ như một phần của onboarding. Trạng thái triển khai connector theo dõi tiến độ hiện tại. Phần chuẩn bị phía cửa hàng dưới đây là tất cả những gì Magento cần từ phía bạn, và nó chạy được với Magento nguyên bản, không cần thay đổi code.
Điều kiện tiên quyết
- Adobe Commerce / Magento Open Source 2.4+
- Quyền admin để tạo một integration token
- HTTPS trên cửa hàng của bạn (bắt buộc để xác thực bằng token)
- Tài khoản Tajo với gói đăng ký đang hoạt động
Bước 1: Tạo integration token trong Magento
- Trong Magento admin, vào System → Extensions → Integrations → Add New Integration.
- Đặt tên là
Tajo, nhập mật khẩu admin của bạn, và trong mục API cấp quyền đọc cho các tài nguyên Customers, Sales và Catalog. - Lưu lại, sau đó Activate integration và sao chép Access Token.
Tajo xác thực bằng Authorization: Bearer <access token> tới REST base URL của cửa hàng bạn (https://yourstore.com/rest/V1/).
Bước 2: Bàn giao kết nối cho đội ngũ Tajo
Hãy gửi cho người phụ trách onboarding Tajo của bạn:
| Trường | Giá trị |
|---|---|
| URL cửa hàng | https://yourstore.com |
| Access token | Integration token từ Bước 1 |
Kết nối được kiểm chứng bằng một yêu cầu chỉ đọc trước khi bất kỳ lần đồng bộ nào bắt đầu. Bạn có thể xoay vòng token trong Magento bất cứ lúc nào để thu hồi quyền truy cập.
Kết nối Magento đồng bộ những gì
- Khách hàng: các trường định danh và metadata tài khoản phục vụ phân giải liên hệ; sự đồng ý nhận marketing không bao giờ được suy ra từ việc một tài khoản tồn tại
- Đơn hàng: lịch sử mua hàng, tổng tiền, tiền tệ, trạng thái và các dòng hàng để phân khúc theo vòng đời và tự động hóa kéo khách quay lại
- Sản phẩm và danh mục: cấu trúc catalog để phân khúc theo sở thích và chạy chiến dịch bám theo sản phẩm
Quá trình nhập dữ liệu lịch sử chạy trước, sau đó đồng bộ gia tăng giữ cho Tajo luôn cập nhật bằng cách polling các bản ghi đã thay đổi. Sự kiện storefront theo thời gian thực (giỏ hàng, checkout đang diễn ra) cần một extension cài trong cửa hàng, thứ mà Magento chưa có hôm nay; các tự động hóa dựa trên đơn hàng vẫn được hỗ trợ đầy đủ qua đồng bộ.
Tự động hóa marketing
Các tự động hóa (email, SMS, WhatsApp qua Brevo và những nhà cung cấp khác) được cấu hình trong Tajo dựa trên dữ liệu đã đồng bộ, ví dụ chăm sóc sau mua trên đơn hàng mới, kéo khách quay lại với khách hàng đã ngừng mua, và chiến dịch theo sở thích sản phẩm dựa trên lịch sử danh mục.
Xử lý sự cố
| Triệu chứng | Nguyên nhân và cách khắc phục |
|---|---|
| 401 từ cửa hàng | Integration token đã được tạo lại hoặc integration đã bị vô hiệu hóa, hãy kích hoạt lại và cập nhật token trong Tajo |
| Khách hàng đồng bộ được nhưng đơn hàng thì không | Phần cấp quyền API của integration thiếu tài nguyên Sales |
| Nhập dữ liệu ban đầu chậm | Cửa hàng lớn được nhập theo từng trang; người phụ trách Tajo của bạn có thể báo tiến độ bất cứ lúc nào |
Các bước tiếp theo
- Tài liệu connector Magento: trạng thái triển khai và ghi chú kỹ thuật
- Đồng bộ khách hàng: ánh xạ khách hàng Magento vào hệ thống nguồn sự thật của bạn