適用於 Workplace 的 Bot

在社團和聊天室中建置適用於 Workplace 的 Bot

總覽

Workplace 自訂整合功能可讓您建立效用強大的 Bot,在社團中或聊天時與用戶互動。

您可以建立自動將貼文發佈到社團、使用其他資訊回答問題,或在貼文留言中被提及時採取行動的 Bot。您還可以建立能與 Work Chat 用戶交談以即時提供資訊,或處理具結構性對話元素(例如快速回覆和常設功能表)之要求的 Bot。

若要為您的社群建立 Bot,您需要「系統管理員」管理員角色。

如果您不是 Workplace 社群的管理員,必須與管理員合作才能建立 Bot。

Bot 表示為粉絲專頁

Bot 在 Workplace 與在 Messenger 平台類似,都可表示為粉絲專頁。當您建立自訂整合應用程式時,系統會自動建立粉絲專頁。Workplace 社群的用戶可透過此粉絲專頁探索 Bot 並與之互動

Bot 粉絲專頁是向內部公開的,因此 Workplace 社群的任何成員都可以查看、標註和傳送訊息給 Bot。但是,根據您建立 Bot 時所選擇的權限層級,它就無法查看 Workplace 的所有內容並與之互動。

例如,如果您的 Bot 具有「讀取社團內容」權限,它就可以查看社團內容。如果您的 Bot 不具「張貼到社團」權限,它將無法回覆任何社團內容。

此外,如果您的 Bot 具有「向任何成員傳送訊息」權限,用戶將只能在 Work Chat 中尋找並向其傳送訊息。

社團的 Bot

Bot 可以在社團中做出許多用戶能做的事,這代表您可以建立 Bot 用以張貼新內容、使用新資訊對內容留言,以及對貼文按讚來表示確認或核准。

Bot 也可以提及用戶以取得他們的注意,並被提及以啟用特定的工作流程或提出問題。

最後,Bot 可訂閱社團和提及 Webhooks,以彈性的方式提供監控內容並與用戶互動的能力。

聊天室的 Bot

雖然社團的 Bot 能夠非同步地在用戶群組之間取用和分享資訊,聊天室的 Bot 仍最適合與單一用戶或已定義的用戶群組進行直接即時互動。

例如,聊天 Bot 可用於根據即將到來的活動(如面試或會議)向某人傳送重要的提醒或通知。Work Chat Bot 還可用於在對話中與用戶互動,並根據收到的意見回饋採取後續行動。

此互動模式所使用的概念與 Messenger 平台相同。因此,Work Chat Bot 可使用常設功能表快速回覆範本等功能,讓用戶體驗更加豐富。

Bot 對用戶聊天室

當 Bot 具有「向任何成員傳送訊息」權限時,將可透過其電子郵件地址傳送 direct 訊息給 Workplace 的任何用戶,或透過 Messenger 傳送 API 傳送其 Workplace 編號。

新訊息自動提示的 Bot

向任何成員傳送訊息」權限還可讓您的 Bot 顯示在 Workplace Chat 介面的自動提示中。

新訊息自動提示的 Bot

透過訂閱粉絲專頁訊息 Webhooks,您的 Bot(機器人程式)也會在用戶向其傳送訊息時收到通知,您可以結合傳送和接收來建立對話流程。

Bot 對用戶對話

Bot 對社團聊天室

當 Bot 具有「向任何成員傳送訊息」和「社團聊天室 Bot 」權限時,就可以建立、管理和新增至多人群組聊天對話串。Bot 可指定收件者名單來建立新社團對話串,還可以重新命名對話串,以便與特定用戶針對特定主題建立聊天討論。

包含特定用戶的命名對話串,由 Bot 所建立。

啟用群組聊天支援,可讓 Bot 顯示在現有群組聊天對話串中的新增用戶自動提示中。接著,Bot 將接收該對話串用戶傳送之每則訊息的 Webhooks,並可以使用其 thread ID 回覆該對話串。

將 Bot 新增到群組聊天中,然後提及 Bot

建立新命名對話串

若要建立具有特定收件者的新對話串,請向 /me/messages 端點發出 POST 要求,並指定 recipient IDs 陣列和初始 message 承載,如下所示:

POST /me/messages
{
  "recipient": {
    "ids": [<user_ids>]
  },
  "message": <message_payload>
}

您將取回包含 thread ID 的回應承載,可在後續追蹤訊息中使用。

如果您再次使用包含相同收件者名單的同一端點,系統將建立新對話串。若要將後續追蹤訊息傳送至已建立的對話串,請使用 recipient 承載中的 thread_id 向 /me/messages 端點發出 POST 要求,如下所示:

POST /me/messages
{
  "recipient": {
    "thread_key": <thread_id>
  },
  "message": <message_payload>
}

若要將 Bot 建立的對話串重新命名,請向 /{thread}/threadname 關係連線發出 POST 要求,如下所示:

POST /t_<thread_id>/threadname
{
  "name": "new name"
}

請注意,您必須在關係連線路徑中的 thread_id 前面加上「t_」。

您還可在 /{thread}/participants 關係連線發出 POSTDELETE 要求,以新增和移除對話串的參與者,如下所示:

POST t_<thread_id>/participants
{
  "to": [<user_ids>]
}

DELETE t_<thread_id>/participants
{
  "to": [<user_ids>]
}

請注意,您可在 /{thread}/participants 關係連線操作經由整合所建立的對話串。

在對話串中被提及

當 Bot 在訊息中被提及時,我們的 Webhooks 將傳送該訊息的標註成員名單作為以下承載:

{
    "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"
            }]
        }]
    }]
} 

Bot 平台合作夥伴

Workplace 中有許多 Bot 平台合作夥伴,已為 Workplace 的 Bot 建立支援,您可在這裡看到他們的名單。您可使用其中任一平台建立強大的 Bot,且不需撰寫任何程式碼。

最佳作法

使用正確的管道

在決定是否要為 Bot 建立社團或聊天互動時,務必考慮 Bot 在哪裡能充分發揮效用。

  • 如果您要建立的 Bot 可供多人立即互動,或發佈供多人查看的貼文內容,建議可將此 Bot 建立為將貼文發佈至社團中,並回覆社團中的貼文留言和提及。
  • 如果您要建立的 Bot 需要立即提醒用戶某些事物、可能需要快速後續追蹤的事物,或用戶應私下互動的事物,則應為 Bot 提供 Work Chat 對話支援。

單一應用程式可同時處理兩個管道。例如,您的客服中心 Bot 有時會在 Work Chat 中接收訊息,有時則需要在社團中發佈貼文並接收回覆。

深層連結至 Bot

使用 https://w.m.me/{page-id} 連結格式,直接連結至 Workplace 的聊天 Bot。網頁、Android 和 iOS 目前皆支援 Workplace Chat。在安裝 Workplace Chat 應用程式的行動平台上,連結將直接在應用程式中開啟。

轉介參數

轉介參數也可用於將更多資訊併入連結。例如,這可讓 Bot 根據已點擊到達 Bot 的用戶來執行自訂動作。

若要使用此功能,請使用 https://w.m.me/{page-id}?ref={referral_parameter} 連結格式。此功能的實作方式與 Messenger 平台相同。如需詳細資料,請參閱 Messenger 文件

相關的 Webhook 欄位為 messaging_referrals,且需要新的訂閱。在先前,Workplace 應用程式無法使用此 Webhook 欄位,但現在您可以透過一般方式訂閱。

Webhook 承載與 Messenger 的格式相同,但兩者之間有所差異:Workplace 使用應用程式範圍編號,不是粉絲專頁範圍編號。此外,Workplace 也會在 Webhook 中提供社群欄位,內含社群編號。

社團互動

應用程式訂閱 Webhooks 後,當社團貼文或留言中提及 Bot 時,它就會收到通知。Bot 需要能及時回覆提及。如果 Bot 在回覆之前必須處理要求,對此留言按讚是有幫助的,因為這樣可告知用戶 Bot 已知道被提及。

然後,如果您在留言中被提及後想要提供資訊,請新增對話串回覆,讓其他的社團對話保持暢通。

如果 Bot 需要向原始貼文者提供資料,請對貼文本身留言,讓貼文者也能收到通知。

聊天互動

Work Chat 的 Bot 互動支援的功能與 Messenger 平台類似。這些功能包括快速回覆按鈕和範本,可協助您在 Bot 對話中實作決策樹。

如此可更輕鬆地建立實用的工作流程,並減少用戶必須輸入的數量,無需任何複雜的自然語言處理,如果您正在建立供全球員工使用的 Bot,這可讓國際化變得簡單許多。