Cơ sở kiến thức GetMyBot

Yêu cầu web và webhook

Dùng sự kiện từ website để chạy bot hoặc gửi yêu cầu từ phản ứng tới dịch vụ khác. Thiết lập hai chiều kết nối.

Trên trang này

Website có thể báo cho bot khi có yêu cầu mới, còn bot có thể hỏi website về trạng thái đơn hàng. Đây là hai chiều trao đổi khác nhau:

Chiều trao đổiBên bắt đầuVí dụ
Webhook đếnDịch vụ khác báo cho GetMyBot và chạy phản ứngCó yêu cầu mới trên website, bot báo nhân viên
Yêu cầu web điPhản ứng hỏi dịch vụ khác và nhận câu trả lờiBot hỏi giá hoặc trạng thái đơn hàng

Webhook là thông báo tự động từ dịch vụ này đến dịch vụ khác. Cả hai cách dùng HTTP, giao thức mà trình duyệt dùng để truy cập website. Với các kết nối có sẵn, xem Tích hợp.

Webhook đầu vào (trình kích hoạt)

Trình kích hoạt Yêu cầu web đến (webhook) chạy phản ứng khi có yêu cầu HTTP từ bên ngoài:

  • Địa chỉ: bật trình kích hoạt và lưu phản ứng. Sau khi lưu, GetMyBot tạo URL webhook cho phản ứng và hiển thị ở đây. Bạn có thể sao chép nhưng không thể sửa địa chỉ.
  • Token bí mật: ngăn người lạ chạy phản ứng qua địa chỉ đó.
  • Phương thức: POST / GET / PUT / ANY.

Các trường của yêu cầu đến được lưu trong dữ liệu tạm của phản ứng (ctx). Ví dụ, trường order_id có thể dùng trong hành động qua {{ctx.order_id}}. Sau khi thiết lập, hãy gửi yêu cầu thử và kiểm tra phản ứng nhận đúng các trường.

Yêu cầu web đi (hành động)

Hành động Yêu cầu web gửi yêu cầu HTTP từ phản ứng:

  • phương thức (GET, HEAD, OPTIONS, POST, PUT, PATCH hoặc DELETE), header và nội dung JSON hoặc văn bản;
  • mã thành công, thời gian chờ và số lần thử lại khi có lỗi;
  • lưu câu trả lời vào tham số người dùng hoặc ctx; dùng JSONPath để chọn trường cần lấy;
  • chế độ bất đồng bộ: bot tiếp tục phản ứng mà không chờ dịch vụ. Một phản ứng riêng có thể xử lý kết quả thành công hoặc lỗi.

Các hành động liên quan là Tải URL (lấy văn bản trang vào ctx), Truy vấn nguồn dữ liệu và Ghi vào nguồn dữ liệu cho những kết nối đã lưu. Xem Nguồn dữ liệu và khóa.

Tích hợp webhook

Để thường xuyên gửi dữ liệu đến cùng một dịch vụ, thiết lập tích hợp Webhook. Nhập URL và chữ ký HMAC để bên nhận kiểm tra người gửi. Xem Tích hợp.

Bảo mật

Đặt token bí mật cho yêu cầu đến để người lạ không thể chạy phản ứng. Yêu cầu đi không được truy cập địa chỉ nội bộ qua nền tảng nhằm ngăn tấn công SSRF. Kích thước câu trả lời cũng có giới hạn.

Tiếp theo