在 Coexistence 號碼上連接 WhatsApp 與 Activepieces

如何將 Coexistence 號碼連接到 Activepieces？

在 Activepieces 建立 WhatsApp Business 連接，只需兩個值：存取權杖和 WhatsApp Business 帳戶 id。EasyCoexistence 控制台會顯示該連接的兩個值，助理則可透過 get_api_credentials 取得。該 piece 的說明提到要建立 Meta 應用程式和系統用戶，因為它假設您兩者都沒有。在這裏號碼已經連接好，所以直接貼上這些值即可。

接着建立以 New Incoming Message 觸發器開頭的流程，在觸發器上自訂一個驗證權杖，然後發佈流程。把觸發器的 Webhook URL 複製到 EasyCoexistence 中該號碼的 Webhook 目的地，並填入相同的驗證權杖。Meta 會發出驗證請求，由觸發器回應，之後每則傳到該號碼的訊息都會啟動一次執行。

為何應用程式密鑰必須留空？

因為簽署這些傳送的密鑰不屬於您，無法貼上。Meta 以擁有該訂閱的應用程式的密鑰，為每個 Webhook 簽署；透過 EasyCoexistence 連接的號碼，該應用程式就是 EasyCoexistence 應用程式，其密鑰從不外泄。

該 piece 視此欄位為選填。留空時，觸發器會照單全收；若填入其他應用程式的密鑰，每次傳送都無法通過 X-Hub-Signature-256 檢查並被靜默忽略，情況看起來就像訊息從未送達。

真正防止陌生人介入握手程序的是驗證權杖。請選用一個又長又隨機的值，並保密觸發器 URL，因為它正是啟動流程的位址。

訊息送達後，流程可以做什麼？

觸發器會向流程交出一則整理好的訊息：寄件者、個人檔案名稱、訊息 id、類型、文字、任何媒體 id、按鈕和清單的回覆，以及接收訊息的電話號碼 id。之後它就是一般的 Activepieces 流程，可串接其他 piece，例如 CRM、試算表或 AI 步驟。

回覆同樣使用這個 piece。Send Message 傳送自由格式訊息，只能在客戶最後一則訊息後的 24 小時內送達。Send Template Message 傳送已獲批准的範本，這是超過該時限後唯一能送達的方式。互動按鈕、清單、媒體、位置和回應表情則各有獨立的動作。

Activepieces 的說明指出，Meta 每個應用程式只接受一個回呼 URL。在按號碼設定目的地的情況下，限制變成每個號碼一個 URL，因此需要處理多種事件類型的流程，應在同一個流程內分支。

在手機上輸入的回覆會傳到流程嗎？

這些回覆會傳到 Webhook，但不會觸發這個觸發器。在 Coexistence 號碼上，Meta 會把每則在 WhatsApp Business 應用程式輸入的回覆，以 smb_message_echoes 欄位的回音傳到同一個目的地。該 piece 的 New Incoming Message 觸發器只讀取 messages 欄位，其餘一概忽略。

如果流程需要手機上的回覆，請改以 Activepieces 通用的 Webhook piece 作為起點，它接受任何 HTTP 方法，並在其同步 URL 上以 Return Response 步驟回應驗證用的 GET。之後您需自行解析原始負載，兩個欄位都包括在內。

對大多數流程而言，該 piece 的觸發器是較簡單的選擇：它只回應客戶，而團隊的回覆仍可在手機的應用程式中查看。

常見錯誤

• 把應用程式密鑰貼進 WhatsApp 連接。傳送是以 EasyCoexistence 應用程式的密鑰簽署，因此每一次都會被忽略。
• 在發佈流程前就設定目的地。Meta 會即時驗證，而未發佈的流程無法回應。
• 以為 New Incoming Message 觸發器能看到在手機上輸入的回覆。它只讀取 messages 欄位，不讀取 smb_message_echoes。

常見問題

繼續閱讀