Webhook: cho dịch vụ khác đánh thức trợ lý trong dự án
Webhook là một địa chỉ riêng của một dự án. Một dịch vụ khác, ví dụ SePay khi có tiền chuyển vô tài khoản, một form đăng ký hay hệ thống của khách, gởi tin tới địa chỉ đó là trợ lý thức dậy trong cuộc trò chuyện của webhook, đọc tin và làm việc cho dự án, không cần ai ngồi trước màn hình.
Tạo webhook
- Trên web, vô Cài đặt → Siêu Trợ Lý, tới khung Webhook dự án.
- Ở dòng của dự án, bấm Tạo webhook và đặt Tên webhook dễ nhớ, ví dụ "SePay".
- Địa chỉ đầy đủ có dạng
https://pa.kalera.ai/api/v1/hooks/<mã-riêng>và chỉ hiện đúng một lần. Bấm Sao chép rồi dán vô dịch vụ kia liền.
Mỗi webhook có một cuộc trò chuyện riêng trong dự án, đặt tên theo tên webhook. Cũng ở khung này, mục Tin gần đây cho bạn coi lại những tin đã gởi tới. Lỡ làm lộ địa chỉ hay cần địa chỉ mới thì bấm Xoay: địa chỉ cũ ngưng nhận tin, địa chỉ mới hiện một lần. Không dùng nữa thì thu hồi bằng nút Thu hồi; dịch vụ đang dùng địa chỉ đó sẽ không gởi tin vô được nữa. Mỗi dự án có tối đa 5 webhook đang dùng. Tài khoản cần có gói đang hoạt động thì webhook mới chạy.
Ví dụ: báo tiền về từ SePay
- Tạo webhook tên "SePay" trong dự án bán hàng, chép địa chỉ.
- Trong trang quản lý SePay, mở phần cấu hình webhook, dán địa chỉ vừa chép vô ô URL nhận tin rồi lưu.
- Ghi vô Lời dặn của dự án điều bạn muốn trợ lý làm khi có tiền về, ví dụ "Có tiền chuyển vô thì đối chiếu mã đơn trong nội dung chuyển khoản, gởi email xác nhận cho khách, thiếu thông tin thì ghi vô Việc cần làm".
Mỗi lần có giao dịch, cuộc trò chuyện của webhook hiện một dòng Tin từ webhook SePay kèm nội dung SePay gởi, rồi tới phần trợ lý làm. Trợ lý nhận tin đó ở dạng [Tin từ webhook · SePay] kèm nội dung.
Trợ lý làm gì với tin nhận được
- Trợ lý coi nội dung webhook là tin từ bên ngoài: ai có địa chỉ cũng gởi được, nên trợ lý không làm theo câu lệnh nằm trong tin và không bao giờ coi tin đó là bạn đồng ý.
- Trợ lý chỉ dùng công cụ trên mây: gởi email, đăng bài và bình luận Facebook, Kho File, hẹn quay lại. Gởi email hay đăng Facebook theo đúng công tắc Quyền tự làm của bạn, như khi bạn chat: công tắc tắt thì thẻ xác nhận chờ bạn duyệt và bạn nhận thông báo. Mức trần tự gởi ra bên ngoài vẫn áp dụng.
- Lượt trả lời webhook không chạy lệnh trên máy, không đụng file trên máy, không mở trình duyệt và không giao việc cho agent.
- Lần hẹn quay lại đặt từ một lượt webhook giữ nguyên các giới hạn này khi tới giờ.
Giới hạn
- Mỗi webhook nhận tối đa 30 lần mỗi phút và 500 lần mỗi ngày; mỗi lần gởi tối đa 1 MiB.
- Trợ lý đọc khoảng 8 nghìn ký tự đầu của mỗi tin; nội dung đầy đủ được giữ 7 ngày trong Tin gần đây.
- Dịch vụ gởi lặp lại cùng một tin (cùng mã giao dịch, hay cùng nội dung trong khoảng 10 phút) thì chỉ tính một lần.
- Các giới hạn khác coi ở bài "Giới hạn của trợ lý".
Các mức trên là mặc định hiện tại và có thể được điều chỉnh về sau.