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 đổi | Bên bắt đầu | Ví dụ |
|---|---|---|
| Webhook đến | Dịch vụ khác báo cho GetMyBot và chạy phản ứng | Có yêu cầu mới trên website, bot báo nhân viên |
| Yêu cầu web đi | Phản ứng hỏi dịch vụ khác và nhận câu trả lời | Bot 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,PATCHhoặcDELETE), 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
- Trình kích hoạt: webhook đến.
- Hành động: Yêu cầu web và Tải URL.
- Biến thay thế và công thức: dữ liệu yêu cầu trong
ctx.