用 API 取得 WhatsApp 群組邀請連結：讀取不等於重設

要透過 UnifyPort 取得 WhatsApp 群組邀請連結，請呼叫 GET /v1/accounts/{account_id}/groups/invite-code，以查詢參數傳入 group_id。回應包含 data.invite_url 和 data.invite_code。讀取連結不等於重設連結。 WhatsApp 提供管理員停用原連結並建立新連結的原生功能；UnifyPort 公開文件只描述讀取，並非重設。

重點

• 同時確認訊息帳戶及目標群組；邀請碼不是群組 ID。
• 在後端讀取，只向已獲授權的操作人員顯示。
• 取得、分享、入群審批及重設是不同操作。
• 原生重設後重新讀取，並替換應用程式可管理的舊副本。

邀請連結 API 的實際範圍

WhatsApp 的官方群組邀請說明介紹以連結邀請成員，並提醒收件人可以繼續轉發。文件亦說明管理員可停用群組邀請連結並建立新的連結。不要把這項原生操作當成 API 讀取的效果。

UnifyPort 取得群組邀請連結文件定義以下內容：

輸入或輸出	意義
路徑內的 account_id	執行操作的已連接訊息帳戶
查詢參數 group_id	平台群組識別碼
data.invite_url	回傳的邀請網址
data.invite_code	回傳的邀請碼，不是對話 ID

目前操作支援矩陣將此功能對應至 whatsapp，不包括 LINE、Telegram、Zalo 或獨立的 whatsapp-protocol。端點說明提示多數平台需要群組管理員權限。本流程應使用已獲授權的 WhatsApp 群組管理員帳戶，並核實其現有權限；工作空間 API 存取權並不等於群組管理權。

這是已連接帳戶的非官方接口，不是 WhatsApp Cloud API 端點。

讀取連結，同時保護 API Key

先透過群組清單在正確帳戶下選取目標。清單包含帳戶已加入但未曾用作傳訊的群組。按分頁讀取，保留所選項目的 id；群組的 conversation_id 與 id 相同。不要只靠可能重複的顯示名稱識別群組。

以下為示範請求，並非實際執行紀錄。環境變數分別使用後端保存的 API Key、所選帳戶 ID，以及清單回傳的群組 ID：

curl --get \
  "https://api.unifyport.ai/v1/accounts/${UNIFYPORT_ACCOUNT_ID}/groups/invite-code" \
  -H "X-Api-Key: ${UNIFYPORT_API_KEY}" \
  --data-urlencode "group_id=${WHATSAPP_GROUP_ID}"

平台識別碼可能包含 @ 等字元，因此查詢參數需要正確編碼。金鑰應留在伺服器，切勿把這項驗證請求放進瀏覽器 JavaScript。

成功後讀取 data.invite_url 和 data.invite_code，不要用群組 ID 拼出猜測的邀請網址。如果回應失敗或欠缺預期連結，介面應顯示錯誤或暫時未能提供，不要自行補值。

診斷時保留 HTTP 狀態、錯誤碼及伺服器 request_id。請求追蹤指南說明如何記錄證據而不保存整份回應內容。此處回應含邀請連結，不應流入分析屬性或一般應用程式日誌。

不同用途，需要不同按鈕

控制項	預期行為	不代表
顯示現有連結	讀取並顯示 API 結果	已建立新連結
複製連結	複製已顯示網址供授權分享	對方已入群
審核入群申請	開啟審批流程	已重設連結
重設連結	引導管理員使用 WhatsApp 原生功能	存在公開的 UnifyPort 重設呼叫

顯示或複製之前，應檢查應用程式本身的操作權限。避免將連結放在公開儀表板、客服截圖或分析事件屬性。如有快取，應標示為「之前取得的連結」，而非保證仍然有效。

若需要審批，請參考 WhatsApp 入群申請審批佇列，先核對待處理申請，再作決定。讀取邀請連結不會啟用審批，也不會批准任何申請人。

原生重設後，更新已保存的副本

考慮一個假設情境：管理員認為連結已被過度轉發，於是在 WhatsApp 重設，但應用程式仍保留舊網址。

建議處理方式：

1. 管理員進行原生操作期間，暫停分享快取連結。
2. 針對同一帳戶及群組重新讀取邀請連結。
3. 將最新讀取結果交給授權操作人員核對。
4. 替換應用程式管理的連結，以及以舊網址產生的二維碼圖片。
5. 通知其他分享渠道負責人檢查他們保存的副本。

以上是應用程式管理建議，不是原子輪替功能。公開文件沒有定義重設參數、重設端點、連結到期時間欄位或專用重設確認 webhook。不要猜測欄位，也不要因沒有收到事件就判定連結未變。如果重新讀取失敗，應保持暫停分享或清楚標示待確認，不要默默恢復舊快取。

常見問題

每次呼叫 invite-code 都會產生新連結嗎？

文件描述的是取得連結及邀請碼，並未承諾每次讀取都會輪替或建立新連結。

invite_code 可以當成 group_id 嗎？

不可以。請使用該訊息帳戶下所選的平台群組 ID；邀請碼是另一項回傳值。

可以經此 API 重設連結嗎？

目前公開文件沒有重設操作。請使用 WhatsApp 原生管理員功能，再重新讀取現有連結。

讀取失敗是否表示群組已刪除？

不是。請查看 HTTP 狀態及錯誤詳情。get_group_invite_code_failed 表示伺服器或上游讀取失敗，不是群組已刪除的證據。

下一步及參考資料

先按取得群組邀請連結建立唯讀流程。上線前檢查群組選擇、權限不足、查詢編碼、日誌遮蔽，以及經授權原生重設後的副本更新。這些是建議驗收項目，並非已完成的測試結果。

資料核對日期：2026-10-15。

• WhatsApp：建立群組及邀請成員
• UnifyPort：取得群組邀請連結
• UnifyPort：平台操作支援
• UnifyPort：錯誤參考