iMessage 透過 BlueBubbles Server 搭橋，將 Apple 裝置上的訊息事件即時轉發至 SMSGO 平台。此整合方案採「僅接收」架構——SMSGO 作為被動監聽端，由 BlueBubbles 主動推送訊息，無法透過此管道對外發送。
✅ 接收端 (BlueBubbles Webhook)
在 BlueBubbles Server 後台新增 Webhook，指向 SMSGO 的 Callback URL，將 iMessage 事件即時推送至平台統一管理。
🚫 發送端限制
iMessage 屬封閉生態，發送須透過 Apple 設備本機的 Messages.app。SMSGO 在此模式下不支援主動發送，請勿嘗試透過此管道回傳訊息。
📚 安裝與設定步驟
| 步驟 |
動作 |
關鍵細節 |
| 1. 安裝伺服器 |
在 Mac 下載並執行 BlueBubbles Server .dmg |
授予「完全磁碟存取權」與「輔助功能」權限 |
| 2. 設定公網網址 |
啟用 Cloudflare Tunnel 或 Ngrok Proxy |
取得固定 HTTPS 網址供 Webhook 回調使用 |
| 3. 新增 Webhook |
在 BlueBubbles「API & Webhooks」新增 Webhook |
填入下方 SMSGO Callback URL，訂閱 new-message 事件 |
| 4. SMSGO 串接 |
在 SMSGO 後台填寫伺服器位址與 API 金鑰 |
僅限接收，確認連線狀態為綠燈 |
🔗 SMSGO Callback URL
在 BlueBubbles「API & Webhooks」頁面，將以下網址填入 Webhook URL 欄位：
// SMSGO iMessage Callback URL
https://smsgo.com.tw/imessage/receiver.aspx
📌 重要提醒：
Callback URL 必須與 BlueBubbles 設定中的連線位址完全一致，否則 SMSGO 將無法正確接收推播數據。請確保 Mac 設備長時間開機且 iCloud 帳號已登入 Messages.app，否則 iMessage 訊息流將中斷。
