Bot cho Workplace
Tổng quan
Với các tiện ích tích hợp tùy chỉnh dành cho Workplace, giờ đây, bạn có thể tạo các bot mạnh mẽ để tương tác với mọi người trong các nhóm và đoạn chat.
Bạn có thể tạo một bot để tự động đăng nội dung vào các nhóm, phản hồi các câu hỏi bằng thông tin bổ sung hoặc thực hiện hành động khi được nhắc đến trong các bình luận trên một bài viết. Bạn cũng có thể tạo bot có khả năng trò chuyện với mọi người trong Work Chat, cung cấp thông tin trong thời gian thực hoặc xử lý các yêu cầu với những yếu tố trò chuyện có cấu trúc như trả lời nhanh và menu cố định.
Để tạo bot cho cộng đồng, bạn sẽ cần có vai trò Quản trị viên hệ thống.
Nếu không phải là quản trị viên của cộng đồng Workplace, bạn sẽ phải hợp tác với một quản trị viên để tạo bot.
Bot dưới dạng Trang
Trên Workplace, tương tự như Nền tảng Messenger, bot được trình bày dưới dạng trang. Một trang sẽ tự động được tạo khi bạn tạo ứng dụngtích hợp tùy chỉnh. Mọi người trong cộng đồng Workplace có thể khám phá và tương tác với bot của bạn thông qua trang này
Các trang bot hiển thị công khai trong công ty nên mọi thành viên trong cộng đồng Workplace đều có thể xem, gắn thẻ và nhắn tin cho bot. Tuy nhiên, tùy thuộc vào cấp độ quyền mà bạn chọn khi tạo bot, bot của bạn có thể không xem và tương tác được với tất cả nội dung trên Workplace.
Ví dụ: nếu có quyền Đọc nội dung trong nhóm, bot của bạn có thể xem nội dung trong các nhóm. Nếu không có quyền Đăng lên nhóm, bot của bạn sẽ không thể trả lời nội dung trong bất kỳ nhóm nào.
Ngoài ra, mọi người chỉ có thể tìm và nhắn tin cho bot của bạn trong Work Chat nếu bot có quyền Nhắn tin cho mọi thành viên.
Bot trong các nhóm
Trong nhóm, bot có thể thực hiện nhiều việc mà mọi người có thể làm. Điều này nghĩa là bạn có thể tạo bot để đăng nội dung mới, bình luận về nội dung có thông tin mới và thích các bài viết để biểu thị việc xác nhận hoặc phê duyệt.
Bot cũng có thể @nhắc đến người để thu hút sự chú ý của họ và @được nhắc đến để bắt đầu một quy trình cụ thể hoặc đặt câu hỏi.
Cuối cùng, bot có thể đăng ký nhóm và @nhắc đến webhook. Những webhook này cho phép giám sát nội dung và tương tác với người dùng theo cách linh hoạt.
Bot trong đoạn chat
Mặc dù trong nhóm, bot có thể sử dụng và chia sẻ thông tin trong một nhóm người theo cách không đồng bộ, bot trong đoạn chat rất phù hợp để tương tác trực tiếp trong thời gian thực với một người hoặc một nhóm người đã xác định.
Ví dụ: một bot chat có thể được dùng để gửi lời nhắc hoặc thông báo quan trọng cho ai đó dựa trên một sự kiện sắp tới như cuộc phỏng vấn hoặc cuộc họp. Các bot work chat cũng có thể được dùng để tương tác với người dùng trong cuộc trò chuyện và thực hiện hành động tiếp theo dựa trên phản hồi nhận được.
Mô hình tương tác này dựa trên các khái niệm tương tự dùng trong Nền tảng Messenger. Do đó, các bot work chat có thể sử dụng những tính năng như menu cố định, tin trả lời nhanh và mẫu để làm phong phú trải nghiệm người dùng.
Đoạn chat giữa bot và người dùng
Khi có quyền Nhắn tin cho mọi thành viên, bot sẽ được phép nhắn tin trực tiếp cho bất kỳ người nào trên Workplace thông qua địa chỉ email hoặc ID Workplace của họ qua API Gửi trên Messenger.
Quyền Nhắn tin cho mọi thành viên cũng cho phép bot của bạn hiển thị trong menu đề xuất trên các giao diện Chat trên Workplace.
Bằng cách đăng ký webhook Tin nhắn trên trang, bot của bạn cũng sẽ nhận được thông báo khi người dùng nhắn tin cho bot và bạn có thể tạo cuộc trò chuyện bằng cách kết hợp gửi và nhận.
Đoạn chat giữa bot và nhóm
Khi bot có quyền Nhắn tin cho mọi thành viên và Chat bot nhóm, bot có thể tạo, quản lý và được thêm vào chuỗi trò chuyện trong nhóm nhiều người. Bot có thể tạo chuỗi trò chuyện nhóm mới bằng cách chỉ định danh sách người nhận và có thể đổi tên chuỗi trò chuyện để tạo cuộc thảo luận trò chuyện về các chủ đề cụ thể với những người cụ thể.
Bằng cách bật hỗ trợ chat nhóm, bot của bạn sẽ hiển thị trong menu đề xuất Thêm người trong đoạn chat nhóm hiện tại. Sau đó, bot sẽ nhận được webhook cho mỗi tin nhắn gửi bởi những người trong chuỗi trò chuyện đó và có thể trả lời chuỗi trò chuyện đó bằng cách sử dụng thread ID.
Tạo chuỗi trò chuyện mới được đặt tên
Để tạo một chuỗi trò chuyện mới với những người nhận cụ thể, hãy gửi yêu cầu POST đến điểm cuối /me/messages chỉ định mảng recipient IDs và phần tải dữ liệu message ban đầu như sau:
POST /me/messages
{
"recipient": {
"ids": [<user_ids>]
},
"message": <message_payload>
}Bạn sẽ nhận được phần tải dữ liệu phản hồi có chứa thread ID. Bạn có thể sử dụng phần tải dữ liệu này cho các tin nhắn tiếp theo.
Nếu bạn sử dụng lại cùng một điểm cuối với cùng danh sách người nhận, một chuỗi trò chuyện mới sẽ được tạo. Để gửi tin nhắn tiếp theo cho chuỗi trò chuyện đã tạo, hãy gửi yêu cầu POST đến điểm cuối /me/messages bằng cách sử dụng thread_id trong phần tải dữ liệu recipient, như sau:
POST /me/messages
{
"recipient": {
"thread_key": <thread_id>
},
"message": <message_payload>
}Để đổi tên chuỗi trò chuyện do bot của bạn tạo, hãy gửi yêu cầu POST đến cạnh /{thread}/threadname, như sau:
POST /t_<thread_id>/threadname
{
"name": "new name"
}Lưu ý là bạn cần thêm "t_" vào trước thread_id trong đường dẫn cạnh.
Bạn cũng có thể thêm và xóa người tham gia khỏi chuỗi trò chuyện bằng cách gửi yêu cầu POST hoặc DELETE trên cạnh /{thread}/participants, như sau:
POST t_<thread_id>/participants
{
"to": [<user_ids>]
}
DELETE t_<thread_id>/participants
{
"to": [<user_ids>]
}Lưu ý rằng bạn có thể sử dụng các thao tác trên cạnh /{thread}/participants cho chuỗi trò chuyện do tiện ích tích hợp tạo ra.
Được nhắc đến trong chuỗi trò chuyện
Khi bot được nhắc đến trong tin nhắn, webhook của chúng tôi sẽ gửi danh sách thành viên được gắn thẻ trong tin nhắn đó ở dạng phần tải dữ liệu sau đây:
{
"object":"page",
"entry":[{
"id":"746230239054322",
"time":1539281406974,
"messaging":[{
...
"message":{
"mid":"<message id>",
"seq":2192,
"text":"@Edu Gomes @Example Bot What's 2+2?"
},
"mentions":[{
"offset":0,
"length":10,
"id":"100017376437045"
},
{
"offset":11,
"length":12,
"id":"746230239054322"
}]
}]
}]
} Đối tác nền tảng bot
Workplace có một số đối tác nền tảng bot đã tích hợp hỗ trợ bot trên Workplace. Bạn có thể xem danh sách các đối tác tại đây. Bạn có thể sử dụng một trong những nền tảng này để tạo bot mạnh mẽ mà không cần viết dòng mã nào.
Cách làm tốt nhất
Sử dụng kênh phù hợp
Khi quyết định có nên xây dựng các tương tác nhóm hoặc chat cho bot của bạn hay không, bạn nên xem xét nơi bot sẽ hữu ích nhất.
- Nếu đang tạo một bot mà nhiều người có thể tương tác cùng lúc hoặc một bot đăng nội dung cho nhiều người xem, bạn nên tạo bot đăng lên nhóm và trả lời các bình luận cũng như lượt nhắc trên các bài viết trong nhóm.
- Nếu bạn đang tạo một bot cần thông báo ngay cho ai đó về điều gì đó, điều gì đó có thể cần theo dõi nhanh hoặc điều gì đó mà mọi người nên tương tác riêng tư, bạn nên hỗ trợ cuộc trò chuyện trong Work Chat cho bot của mình.
Một ứng dụng có thể xử lý cả hai kênh. Ví dụ: Đôi khi bot bộ phận trợ giúp sẽ nhận được tin nhắn trong work chat và cũng có lúc bot đó cần đăng lên nhóm và nhận câu trả lời.
Liên kết sâu đến bot
Sử dụng định dạng liên kết https://w.m.me/{page-id} để liên kết trực tiếp với một chat bot trên Workplace. Hiện tại, chúng tôi hỗ trợ Chat trên Workplace khi sử dụng web, Android và iOS. Trên các nền tảng di động có cài đặt ứng dụng Chat trên Workplace, liên kết sẽ được mở ngay trong ứng dụng.
Thông số tham chiếu
Bạn cũng có thể sử dụng Thông số tham chiếu để kết hợp thêm thông tin vào liên kết. Ví dụ: điều này có thể cho phép bot thực hiện các thao tác tùy chỉnh dựa trên việc người dùng nào đã nhấp vào để chuyển đến bot.
Để sử dụng tính năng, hãy sử dụng định dạng liên kết https://w.m.me/{page-id}?ref={referral_parameter}. Tính năng này được triển khai theo cách giống như Nền tảng Messenger. Vui lòng xem tài liệu về Messenger để biết thêm chi tiết.
Trường webhook liên quan là messaging_referrals và cần một hoạt động đăng ký mới. Trước đây, trường này không phải là trường webhook có sẵn cho ứng dụng Workplace. Tuy nhiên, hiện giờ bạn có thể đăng ký trường này theo cách thông thường.
Phần tải dữ liệu webhook có cùng định dạng với Messenger. Điểm khác biệt phổ biến là Workplace sử dụng id trong ứng dụng, thay cho id trong trang. Ngoài ra, Workplace cũng cung cấp một trường cộng đồng trong webhook, có chứa id cộng đồng.
Lượt tương tác với nhóm
Sau khi ứng dụng được đăng ký webhook, bot của bạn sẽ nhận được thông báo khi được nhắc đến trong một bài viết hoặc bình luận trong nhóm. Bot của bạn cần kịp thời trả lời các lượt nhắc. Nếu bot của bạn phải xử lý một yêu cầu trước khi trả lời, bạn nên nhấn thích bình luận để cho người đó biết rằng bot biết là được nhắc đến.
Sau đó, nếu bạn định cung cấp thông tin sau khi được nhắc đến trong một bình luận, hãy thêm câu trả lời theo chuỗi để tiếp tục duy trì cuộc trò chuyện nhóm.
Nếu bot của bạn cần cung cấp thông tin cho người đăng ban đầu, hãy thêm bình luận về chính bài viết để họ cũng nhận được thông báo.
Lượt tương tác với đoạn chat
Các tương tác với bot trong Work Chat hỗ trợ chức năng tương tự với nền tảng Messenger. Trong đó có các nút và mẫu trả lời nhanh giúp bạn triển khai cây quyết định trong các cuộc trò chuyện với bot.
Điều này giúp việc tạo các quy trình hữu ích trở nên đơn giản hơn nhiều và giảm lượng dữ liệu nhập của mọi người mà không cần xử lý ngôn ngữ tự nhiên phức tạp. Nhờ vậy mà hoạt động quốc tế hóa trở nên đơn giản hơn nhiều nếu bạn định tạo bot cho lực lượng lao động toàn cầu.