1 Vấn đề
Vì sao cần làm.
Hiện tại Joy gửi email thông báo bằng một ngôn ngữ cố định do merchant chọn thủ công. Với store bán nhiều thị trường (ví dụ Jana — 5 market: SK / CZ / PL / HU / HR), merchant chỉ chọn được 1 trong 5 ngôn ngữ → 4/5 nhóm khách nhận email sai ngôn ngữ → open rate giảm, conversion campaign thấp.
Để làm thủ công, merchant phải dịch tay 20+ loại email × N ngôn ngữ — bất khả thi.
2 Giải pháp
Merchant chỉ cần 2 thao tác; phần còn lại Joy tự lo.
① Thêm ngôn ngữ (1 lần)
Merchant thêm ngôn ngữ trong Translations admin (màn hình có sẵn). Joy tự động dịch sẵn nội dung tất cả email cho ngôn ngữ đó.
② Review / chỉnh (tuỳ chọn)
Vào email editor, chọn ngôn ngữ trong dropdown để xem & sửa bản dịch nếu muốn. Có nút gửi test "Preview in language".
3 Cách hoạt động
Hai luồng chạy song song.
Luồng A — Khi gửi email cho khách
fr-CA)Luồng B — Khi merchant thêm ngôn ngữ
4 Trải nghiệm trong Email Editor
Merchant chọn ngôn ngữ ngay trên đầu trình soạn — nội dung & preview đổi theo.
- Dropdown "Language": ngôn ngữ chính (gắn nhãn Default) + các ngôn ngữ đã thêm.
- Chuyển ngôn ngữ → editor & live preview đổi sang nội dung của ngôn ngữ đó.
- Tất cả ngôn ngữ lưu chung 1 lần Save (chuyển qua lại không mất chỉnh sửa).
- Shop chưa thêm ngôn ngữ nào → dropdown ẩn, editor hoạt động y như trước (không ảnh hưởng).
5 Bằng chứng demo
Đã chạy thật end-to-end trên môi trường dev (cùng email "Earn points", đổi locale của khách).
| Ngôn ngữ | Tiêu đề email render (biến đã thay) | Nguồn |
|---|---|---|
| 🇬🇧 English (gốc) | xidoke: You've earned 100 points! | Nội dung gốc |
| 🇻🇳 Tiếng Việt | xidoke: Bạn vừa nhận được 100 points! | Bản dịch |
| 🇫🇷 Français | {{shop_name}}: Vous avez gagné une récompense… (Birthday) | Auto-translate (AI) |
| 🇩🇪 Deutsch | {{shop_name}}: Sie haben {{earning_points}} verdient! | Auto-translate (AI) |
Email tiếng Việt render đầy đủ (demo)
Số dư hiện tại của bạn là 100 points. Hãy quay lại cửa hàng và đổi điểm lấy ưu đãi hấp dẫn nhé!
Biến động ({{earning_points}}, {{shop_name}}, {{earning_program}}) được thay đúng; chỉ phần text được dịch, logic giữ nguyên.
6 Phạm vi & Trạng thái
Đã hoàn thành DONE · dev-verified
- Đồng bộ ngôn ngữ khách (Customer.locale) vào Joy
- Tự bổ sung locale khi gửi nếu thiếu (an toàn, 1 lần/khách)
- Render email theo ngôn ngữ khách + fallback ngôn ngữ chính
- Auto-translate ~20 loại email khi thêm ngôn ngữ (AI, chạy nền qua hàng đợi)
- Render email theo ngôn ngữ khách, đã verify E2E (vi/fr/es + field tuỳ chỉnh)
- Dropdown chọn ngôn ngữ trong editor + sửa/preview/xem bản dịch từng ngôn ngữ
- Gửi test "Preview in language"
- Đã qua review chất lượng (max effort)
Follow-up Polish · không chặn
- Nhãn "Language" đa ngôn ngữ hoá (i18n) — đang để tiếng Anh tạm
- Editor bản cũ (legacy V1) chưa có dropdown — chạy ngôn ngữ chính
- Email dạng HTML thuần (custom HTML) chưa dịch nội dung body
- QA đầy đủ + smoke-test staging để xác nhận gửi email thật
7 Ghi chú kỹ thuật (cho BA / Dev)
- Nguồn ngôn ngữ khách:
Customer.localecủa Shopify (BCP47, vdfr-CA) — chỉ có ở GraphQL Admin API, không có ở REST/webhook. Vì vậy Joy lấy qua đồng bộ GraphQL + bổ sung lúc gửi (lazy-fetch), không dựa vào webhook. - Lưu bản dịch: theo từng loại notification, dạng map
translations[locale]= {subject, heading, body, button, footer, unsubscribe}. Lưu/đọc gộp chung với notification (không cần bảng mới). - Chọn ngôn ngữ lúc gửi: khớp chính xác → theo ngôn ngữ (
fr-CA → fr) → biến thể vùng cùng ngôn ngữ → ngôn ngữ chính. Fallback theo từng field (thiếu field nào dùng bản chính field đó). - Auto-translate: tái dùng hạ tầng dịch sẵn của Joy (Gemini), gộp các field thành 1 lần gọi/notification, có giới hạn tần suất.
- Tác động: shop không bật đa ngôn ngữ → hành vi y như cũ. Email test & các đường gửi lại không bị đổi ngôn ngữ ngoài ý muốn.
Chất lượng: đã qua review đa-góc (max effort) + verify E2E trên dev/emulator — render đúng ngôn ngữ khách (kể cả nội dung merchant tự chỉnh), giữ nguyên biến động và không trộn ngôn ngữ.