Tạo webhook

Webhook là công cụ để truy xuất và lưu trữ dữ liệu từ một sự kiện nhất định. Webhook cho phép đăng ký URL https:// để lưu trữ dữ liệu sự kiện ở định dạng JSON hoặc XML. Webhook thường được dùng cho các mục đích sau:

  • Đặt hàng
  • Thay đổi giá sản phẩm
  • Thông báo cho trình khách IM hoặc máy nhắn tin khi ngoại tuyến
  • Thu thập dữ liệu để lưu kho dữ liệu
  • Tích hợp phần mềm kế toán
  • Lọc các mặt hàng trong đơn hàng và thông báo cho nhiều bên giao hàng về đơn hàng
  • Xóa dữ liệu khách hàng khỏi cơ sở dữ liệu khi họ gỡ cài đặt ứng dụng

Sự kiện webhook được hỗ trợ

Khi tạo webhook, bạn có thể chọn từ bất kỳ sự kiện nào trong danh sách. Ví dụ: nếu muốn tạo webhook được gửi mỗi khi đơn hàng đã được thanh toán, hãy chọn Thanh toán đơn hàng. Một ví dụ khác: nếu muốn tạo webhook được gửi mỗi khi thuộc tính cửa hàng được cập nhật, hãy chọn Cập nhật cửa hàng.

Bảng liệt kê các sự kiện webhook được hỗ trợ trong bảng điều khiển quản trị Shopify.
Danh mụcSự kiện
Giỏ hàng
  • Tạo giỏ hàng
  • Cập nhật giỏ hàng
Trang thanh toán
  • Tạo trang thanh toán
  • Xóa trang thanh toán
  • Cập nhật trang thanh toán
Bộ sưu tập
  • Tạo bộ sưu tập
  • Xóa bộ sưu tập
  • Cập nhật bộ sưu tập
Khách hàng
  • Cập nhật đồng ý nhận thông tin tiếp thị qua SMS của khách hàng
  • Cập nhật cài đặt tài khoản khách hàng
  • Tạo khách hàng
  • Xóa khách hàng
  • Vô hiệu hóa khách hàng
  • Cập nhật đồng ý nhận thông tin tiếp thị qua email của khách hàng
  • Kích hoạt khách hàng
  • Tạo nhóm khách hàng
  • Xóa nhóm khách hàng
  • Cập nhật nhóm khách hàng
  • Đã thêm thẻ khách hàng
  • Đã xóa thẻ khách hàng
  • Cập nhật khách hàng
Giảm giá
  • Tạo giảm giá
  • Xóa giảm giá
  • Cập nhật giảm giá
Đơn hàng nháp
  • Tạo đơn hàng nháp
  • Xóa đơn hàng nháp
  • Cập nhật đơn hàng nháp
Hoàn tất đơn hàng
  • Tạo thông tin hoàn tất đơn hàng
  • Dịch vụ hoàn tất đơn hàng không thể hoàn thành đơn hàng cần hoàn tất
  • Mục hàng của đơn hàng cần hoàn tất đã chuẩn bị để lấy hàng
  • Đã di chuyển đơn hàng cần hoàn tất
  • Đơn hàng cần hoàn tất bị tạm dừng
  • Đã lên lại lịch cho đơn hàng cần hoàn tất
  • Đơn hàng cần hoàn tất đã lên lịch đến hạn
  • Đã hoàn thành định tuyến đơn hàng cần hoàn tất
  • Đã hủy đơn hàng cần hoàn tất
  • Đã chấp nhận yêu cầu hủy đơn hàng cần hoàn tất
  • Đã từ chối yêu cầu hủy đơn hàng cần hoàn tất
  • Đã gửi yêu cầu hủy đơn hàng cần hoàn tất
  • Đã chấp nhận yêu cầu hoàn tất đối với đơn hàng cần hoàn tất
  • Đã từ chối yêu cầu hoàn tất đối với đơn hàng cần hoàn tất
  • Đã gửi yêu cầu hoàn tất đối với đơn hàng cần hoàn tất
  • Đã gỡ tạm dừng đơn hàng cần hoàn tất
  • Mục hàng của đơn hàng cần hoàn tất đã chuẩn bị cho giao hàng tận nơi
  • Đã gộp đơn hàng cần hoàn tất
  • Đã tách đơn hàng cần hoàn tất
  • Cập nhật hoàn tất đơn hàng
Hàng tồn kho
  • Tạo mặt hàng tồn kho
  • Xóa mặt hàng tồn kho
  • Cập nhật mặt hàng tồn kho
  • Kết nối mức tồn kho
  • Ngắt kết nối mức tồn kho
  • Cập nhật mức tồn kho
Địa điểm
  • Kích hoạt địa điểm
  • Tạo địa điểm
  • Hủy kích hoạt địa điểm
  • Xóa địa điểm
  • Cập nhật mặt hàng tại địa điểm
Thị trường
  • Tạo thị trường
  • Xóa thị trường
  • Cập nhật thị trường
Đơn hàng
  • Hủy đơn hàng
  • Tạo đơn hàng
  • Xóa đơn hàng
  • Chỉnh sửa đơn hàng
  • Hoàn tất đơn hàng
  • Thanh toán đơn hàng
  • Đánh giá rủi ro đơn hàng đã thay đổi
  • Cập nhật đơn hàng
Sản phẩm
  • Tạo sản phẩm
  • Xóa sản phẩm
  • Cập nhật sản phẩm
Hoàn tiền
  • Tạo hoàn tiền
Cửa hàng
  • Cập nhật cửa hàng
Phương thức thanh toán
  • Tạo giao dịch qua phương thức thanh toán
Chủ đề
  • Tạo chủ đề
  • Xóa chủ đề
  • Đăng chủ đề
  • Cập nhật chủ đề
Giao dịch
  • Tạo giao dịch

Tạo webhook

Bạn có thể tạo webhook bất cứ lúc nào. Các webhook được ký bằng một ID bao gồm tổ hợp chữ cái và số dành riêng cho cửa hàng của bạn.

Các bước:

Máy tính để bàn
  1. Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Thông báo.

  2. Nhấp vào Webhook.

  3. Nhấp vào ⊕ Tạo webhook.

  4. Trong menu thả xuống Sự kiện, chọn bất kỳ sự kiện webhook được hỗ trợ nào để sử dụng làm sự kiện webhook. Bạn không thể thay đổi sự kiện webhook sau khi đã tạo webhook.

  5. Trong menu thả xuống Định dạng, chọn định dạng bạn muốn Shopify dùng để gửi thông tin này. Có hai lựa chọn là JSON hoặc XML.

  6. Trong trường URL, nhập URL nơi bạn muốn lưu trữ dữ liệu. Không thể trả webhook về các URL sau:

    • Localhost
    • Bất kỳ URL nào kết thúc bằng từ "internal" (ví dụ: example.com/internal)
    • Bất kỳ URL nào từ tên miền tùy chỉnh gắn với cửa hàng
    • Các miền "giả" (ví dụ: www.example.com)
    • Các miền Shopify (ví dụ: shopify.commyshopify.com)
  7. Trong phần Phiên bản API webhook, chọn phiên bản webhook mong muốn.

  8. Nhấp vào Lưu.

Thiết bị di động
  1. Từ ứng dụng Shopify, chạm vào Menu, rồi chạm vào Settings Cài đặt.

  2. Trong phần Cài đặt cửa hàng, chạm vào Thông báo.

  3. Chạm vào Webhook.

  4. Chạm vào ⊕ Tạo webhook.

  5. Trong menu thả xuống Sự kiện, chọn bất kỳ sự kiện webhook được hỗ trợ nào để sử dụng làm sự kiện webhook. Bạn không thể thay đổi sự kiện webhook sau khi đã tạo webhook.

  6. Trong menu thả xuống Định dạng, chọn định dạng bạn muốn Shopify dùng để gửi thông tin này. Có hai lựa chọn là JSON hoặc XML.

  7. Trong trường URL, nhập URL nơi bạn muốn lưu trữ dữ liệu. Không thể trả webhook về các URL sau:

    • Localhost
    • Bất kỳ URL nào kết thúc bằng từ "internal" (ví dụ: example.com/internal)
    • Bất kỳ URL nào từ tên miền tùy chỉnh gắn với cửa hàng
    • Các miền "giả" (ví dụ: www.example.com)
    • Các miền Shopify (ví dụ: shopify.commyshopify.com)
  8. Trong phần Phiên bản API webhook, chọn phiên bản webhook mong muốn.

  9. Chạm vào Lưu hoặc .

Sau khi webhook mới được lưu, webhook sẽ hiển thị trên trang Webhook.

Chỉnh sửa webhook

Bạn có thể chỉnh sửa cấu hình của webhook sau khi tạo. Tuy nhiên, bạn không thể sửa đổi sự kiện webhook đã chọn.

Các bước:

Máy tính để bàn
  1. Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Thông báo.

  2. Nhấp vào Webhook.

  3. Trong hàng chứa webhook cần chỉnh sửa, nhấp vào ... > Chỉnh sửa.

  4. Trong hộp thoại Chỉnh sửa webhook, sửa đổi webhook theo yêu cầu.

  5. Nhấp vào Lưu.

Thiết bị di động
  1. Từ ứng dụng Shopify, chạm vào Menu, rồi chạm vào Settings Cài đặt.

  2. Trong phần Cài đặt cửa hàng, chạm vào Thông báo.

  3. Chạm vào Webhook.

  4. Trong hàng chứa webhook cần chỉnh sửa, chạm vào ... > Chỉnh sửa.

  5. Trong hộp thoại Chỉnh sửa webhook, sửa đổi webhook theo yêu cầu.

  6. Chạm vào Lưu hoặc .

Thử nghiệm webhook

Bạn có thể thử nghiệm webhook để đảm bảo thông tin sự kiện mong muốn được gửi đến đúng URL.

Các bước:

Máy tính để bàn
  1. Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Thông báo.

  2. Nhấp vào Webhook.

  3. Trong hàng chứa webhook cần thử nghiệm, nhấp vào ... > Gửi bản thử nghiệm.

  4. Tại URL đã chỉ định cho webhook, hãy xác minh thông báo hoạt động bình thường.

Thiết bị di động
  1. Từ ứng dụng Shopify, chạm vào Menu, rồi chạm vào Settings Cài đặt.

  2. Trong phần Cài đặt cửa hàng, chạm vào Thông báo.

  3. Chạm vào Webhook.

  4. Trong hàng chứa webhook cần thử nghiệm, chạm vào ... > Gửi bản thử nghiệm.

  5. Tại URL đã chỉ định cho webhook, hãy xác minh thông báo hoạt động bình thường.

Xóa webhook

Bạn có thể xóa webhook từ bảng điều khiển quản trị Shopify. Không thể hoàn tác hành động này.

Các bước:

Máy tính để bàn
  1. Từ bảng điều khiển quản trị Shopify, đi tới Cài đặt > Thông báo.

  2. Nhấp vào Webhook.

  3. Trong hàng chứa webhook cần xóa, nhấp vào ... > Xóa.

Thiết bị di động
  1. Từ ứng dụng Shopify, chạm vào Menu, rồi chạm vào Settings Cài đặt.

  2. Trong phần Cài đặt cửa hàng, chạm vào Thông báo.

  3. Chạm vào Webhook.

  4. Trong hàng chứa webhook cần xóa, chạm vào ... > Xóa.