Tích hợp vận chuyển GHN, GHTK
Kết nối GHN Express hoặc GHTK để tra trạng thái vận đơn, ước tính phí ship ngay trong hội thoại và tạo đơn vận chuyển bằng workflow.
Kết nối tài khoản GHN Express hoặc Giao Hàng Tiết Kiệm (GHTK) để tra trạng thái vận đơn và ước tính phí ship ngay trong hội thoại khi khách hỏi; dùng Workflow để tự trả lời tình trạng đơn hoặc tạo đơn giao hàng.
Tạo đơn vận chuyển làm trong Workflow (bước GHN: Tạo đơn vận chuyển / GHTK: Tạo đơn vận chuyển); bảng Tích hợp nhanh trong hội thoại dùng để tra cứu và tính phí.
Đơn vị hỗ trợ & thông tin cần nhập
| Đơn vị | Thông tin cần nhập | Ghi chú |
|---|---|---|
| GHN Express | Token GHN · Shop ID · Môi trường | Lấy Token và Shop ID trong tài khoản GHN. Trong form kết nối, phần Cài đặt → Môi trường: Production (mặc định) cho đơn thật, Sandbox (test) khi dùng Token môi trường thử nghiệm của GHN. Test kết nối thành công sẽ báo số shop trong tài khoản. |
| GHTK (Giao Hàng Tiết Kiệm) | Token GHTK | API Token trong tài khoản GHTK. Test kết nối thành công sẽ hiện số dư tài khoản GHTK. |
Cách kết nối
- Lấy Token: đăng nhập tài khoản GHN / GHTK, lấy Token API (GHN lấy thêm Shop ID).
- Mở Công cụ → Tích hợp: chọn tab Vận chuyển → bấm GHN Express hoặc GHTK.
- Nhập thông tin rồi bấm Kết nối: dán Token (GHN: thêm Shop ID và chọn Môi trường), bấm Kết nối để lưu.
- Bấm Test kết nối: thành công thì thẻ chuyển sang Đã kết nối và đơn vị vận chuyển xuất hiện trong bảng Tích hợp nhanh của hội thoại.
Trong hội thoại: Tích hợp nhanh
| Thao tác | Mô tả |
|---|---|
| Tra cứu vận đơn | GHN: nhập Mã vận đơn GHN; GHTK: nhập Mã tracking GHTK → trạng thái hiện tại của đơn |
| Tính phí vận chuyển | Ước tính phí ship. GHN: ID quận nhận, trọng lượng (gram), loại dịch vụ; GHTK: tỉnh/TP, quận/huyện nhận, trọng lượng |
| Danh sách tỉnh / quận / phường (GHN) | Xem ID địa chỉ theo chuẩn GHN để điền khi tính phí hoặc tạo đơn GHN |
| Dịch vụ khả dụng (GHN) | Các gói dịch vụ GHN giữa quận gửi và quận nhận |
Mở bằng nút Tích hợp nhanh (hình mắt xích) trên thanh tiêu đề hội thoại → chọn GHN / GHTK → chọn thao tác. Thao tác hay dùng (vd. Tra cứu vận đơn) ghim được ra thanh công cụ ô soạn tin.
Dùng trong Workflow
Nhóm Vận chuyển trong bảng node có: GHN: Tạo đơn vận chuyển, GHN: Tra cứu vận đơn, GHN: Danh sách tỉnh/thành, quận/huyện, phường/xã, GHN: Dịch vụ khả dụng, GHTK: Tạo đơn vận chuyển, GHTK: Tra cứu vận đơn.
- GHN: Tạo đơn vận chuyển, điền Tên người nhận, SĐT người nhận, Địa chỉ giao hàng, ID Quận/Huyện (GHN), Mã Phường/Xã (GHN), Trọng lượng (gram); phần Nâng cao có Loại dịch vụ và Tiền thu hộ COD. Bước này trả về mã vận đơn để gửi cho khách.
- GHTK: Tạo đơn vận chuyển, nhập dữ liệu đơn dạng JSON theo mẫu gợi ý trong ô (người gửi, người nhận, khối lượng, tiền thu hộ, danh sách hàng).
Ví dụ: khách gửi mã vận đơn → tự trả trạng thái
- Khi nhận tin nhắn: đặt Từ khóa kích hoạt và Cách khớp từ khóa (Bắt đầu bằng từ khóa, hoặc Regex theo dạng mã của shop) để chỉ chạy khi khách gửi mã vận đơn.
- GHN: Tra cứu vận đơn (hoặc GHTK: Tra cứu vận đơn), ô mã vận đơn: bấm Chèn biến → Nội dung tin nhắn.
- Gửi tin nhắn: gửi lại trạng thái đơn cho khách.
Lưu ý
- Phí trong Tích hợp nhanh là ước tính; phí thực tế theo cân nặng, kích thước và dịch vụ khi giao.
- ID tỉnh / quận và mã phường của GHN là mã riêng của GHN: tra trong các danh sách GHN, không dùng mã hành chính khác.
- Token môi trường thử nghiệm chỉ chạy với Môi trường Sandbox (test); khi giao thật chọn Production.
- Báo lỗi xác thực: lấy Token mới, dán lại, bấm Cập nhật rồi Test kết nối.
- Tắt Kích hoạt thì các bước GHN / GHTK trong workflow báo lỗi chưa kết nối.
Chưa tìm thấy câu trả lời?
Nhắn hỗ trợ qua Telegram