Cài đặt tích hợp GuruCall

Cấu hình này mô phỏng phía backend của 1 đối tác thật — token được lưu ở server của shop (data/config.json), không lộ ra trình duyệt.

Kết nối API

API base URL của GuruCall Mã provider (định danh shop này với GuruCall)

API key gửi đơn (bắt buộc để đặt hàng)

Đây là thứ duy nhất shop cần để gửi đơn (POST /external-orders, header X-Api-Key). Admin GuruCall tạo key này ở màn "API key đối tác" trong callcenter-ui rồi gửi cho bạn — dán key nhận được vào đây, không tự tạo được từ phía shop.

API key

Bản đồ giao hàng

Shop dùng OpenStreetMap + Leaflet để hiển thị bản đồ, Nominatim để tìm tọa độ địa chỉ khách, và OSRM để vẽ tuyến đường. Luồng này chỉ hiển thị chỉ đường, không theo dõi vị trí shipper.

Địa chỉ cửa hàng mặc định

Token admin (chỉ dùng để đăng ký webhook)

JWT admin CHỈ dùng cho nút "Đăng ký webhook" bên dưới. KHÔNG dùng để gửi đơn (đã chuyển sang API key ở trên) và không dùng để tạo API key nữa (việc đó làm ở admin GuruCall). Token hết hạn theo phiên đăng nhập — cần đăng nhập lại nếu nút đăng ký webhook báo lỗi 401/403.

Admin token (JWT) — dán trực tiếp nếu có sẵn

Hoặc đăng nhập nhanh để lấy token

Webhook nhận trạng thái ngược từ GuruCall

Khi admin GuruCall điều phối / huỷ / shipper giao xong đơn, hệ thống sẽ tự gọi ngược vào URL dưới đây để shop cập nhật trạng thái đơn realtime (xem trang "Đơn hàng của tôi").

Callback URL của shop này Secret ký HMAC (tuỳ chọn, nên đặt để xác minh request thật sự từ GuruCall)

Gọi PUT /external-orders/provider-configs/:provider hộ bạn, cần đã lưu token ở trên trước.