Your AI Connector Docs

iMessage (Bản Beta)

Đưa iMessage vào hộp thư đến tập trung của bạn. Kết nối máy Mac đang chạy BlueBubbles và các tin nhắn iMessage của bạn sẽ đổ về nền tảng cùng với WhatsApp, SMS, Instagram và Messenger — với cùng một AI Agent, Broadcasts và lịch sử liên hệ mà bạn đã sử dụng ở mọi nơi khác.

Kênh Beta. Hỗ trợ iMessage hiện chỉ dành cho người được mời trong khi chúng tôi hoàn thiện trải nghiệm. Hãy liên hệ với bộ phận hỗ trợ để kích hoạt tính năng này trên tài khoản của bạn. Chức năng, giới hạn và hành vi có thể thay đổi khi kênh này hoàn thiện hơn.

Tổng quan

Apple không cung cấp API iMessage chính thức — một tập hợp các quy tắc cho phép các ứng dụng khác kết nối trực tiếp với iMessage. Thay vào đó, tích hợp này kết nối thông qua một ứng dụng cầu nối mã nguồn mở có tên là BlueBubbles, mà bạn chạy trên máy Mac đã đăng nhập vào tài khoản iMessage của mình. Sau khi kết nối, nền tảng sẽ:

  • Nhận các tin nhắn iMessage đến dưới dạng các cuộc hội thoại mới trong Chats.
  • Gửi phản hồi đi thông qua máy Mac của bạn, vì vậy chúng xuất hiện với người nhận như một tin nhắn iMessage bong bóng xanh bình thường từ Apple ID của bạn.
  • Cho phép AI Agent, thẻ và hồ sơ liên hệ của bạn hoạt động chính xác như trên mọi kênh khác.

Việc thiết lập mất khoảng 10 phút sau khi bạn đã cài đặt BlueBubbles.

Những gì bạn cần

Để kết nối iMessage, bạn sẽ cần tất cả những thứ sau:

  • Một máy Mac (laptop hoặc máy tính để bàn) đã đăng nhập vào Apple ID của bạn với iMessage được bật trong ứng dụng Messages.
  • Máy Mac phải luôn trực tuyến và thức. Nếu máy Mac của bạn ở chế độ ngủ, khởi động lại hoặc mất kết nối internet, iMessage sẽ ngừng hoạt động cho đến khi máy trực tuyến trở lại.
  • BlueBubbles Server được cài đặt trên máy Mac đó — một ứng dụng mã nguồn mở miễn phí có sẵn tại bluebubbles.app.
  • Một cách để kết nối máy Mac của bạn với internet — thường là một đường hầm như Cloudflare Tunnel, ngrok hoặc Tailscale. Trình hướng dẫn thiết lập của BlueBubbles sẽ hướng dẫn bạn thực hiện việc này.
  • Một gói trả phí — iMessage được bao gồm như một phần trong hạn mức kênh của bạn trên tất cả các gói hiện tại.

Thiết lập BlueBubbles

BlueBubbles là một ứng dụng bên thứ ba riêng biệt mà bạn cài đặt trên máy Mac của chính mình. Chúng tôi không lưu trữ ứng dụng này — nó chạy cục bộ trên máy của bạn.

  1. Tải xuống và cài đặt BlueBubbles Server từ bluebubbles.app.
  2. Cấp các quyền mà trình cài đặt yêu cầu (Accessibility, Full Disk Access, Automation). Những quyền này cho phép BlueBubbles đọc tin nhắn đến và kích hoạt ứng dụng Messages để gửi tin nhắn đi.
  3. Mở BlueBubbles → Settings → API & Webhooks.
  4. Thiết lập server password.
  5. Sao chép server URL của bạn (một địa chỉ công khai trỏ đến máy Mac của bạn).
  6. Xác minh trong BlueBubbles rằng các tin nhắn thử nghiệm đến và đi hoạt động cục bộ trước khi tiếp tục.

Hướng dẫn thiết lập đầy đủ, khắc phục sự cố và các hướng dẫn dành riêng cho nền tảng nằm trong tài liệu chính thức của BlueBubbles. Nếu bạn gặp khó khăn với chính BlueBubbles, tài liệu và cộng đồng của họ là cách nhanh nhất để giải quyết.

Kết nối BlueBubbles với nền tảng

Sau khi BlueBubbles đang chạy trên máy Mac của bạn:

  1. Ở thanh bên trái, nhấp vào Settings (Cài đặt) ở gần phía dưới.
  2. Trong thanh điều hướng bên trái của Settings, tại mục Channels (Kênh), nhấp vào Channels.
  3. Tìm thẻ iMessage và nhấp vào Connect (Kết nối). (Nút Connect chỉ có thể nhấp được sau khi iMessage đã được kích hoạt cho tài khoản của bạn — cho đến lúc đó, nút này sẽ bị làm mờ và thẻ sẽ hiển thị ghi chú “iMessage is in private beta and isn’t enabled on your account yet.”)
  1. Dán Server URL (URL máy chủ) BlueBubbles của bạn (ví dụ: https://your-tunnel.example.com).
  2. Dán server password (mật khẩu máy chủ) BlueBubbles của bạn.
  3. Nhấp vào Connect (Kết nối).

Chúng tôi xác minh kết nối bằng cách liên hệ với máy chủ BlueBubbles của bạn và tự động thiết lập webhook (webhook là một địa chỉ web cho phép BlueBubbles tự động thông báo cho nền tảng ngay khi có tin nhắn mới đến). Nếu mọi thứ đều ổn, trạng thái sẽ chuyển thành Connected.

  1. Trong BlueBubbles, mở Settings → API & Webhooks → Webhooks và xác nhận (hoặc dán) URL webhook được hiển thị trên trang cài đặt iMessage.
  2. Lưu lại.

Vậy là xong — các tin nhắn iMessage đến sẽ xuất hiện trong hộp thư đến của bạn theo thời gian thực.

Kiểm tra kết nối

Từ trang cài đặt iMessage, bạn có thể gửi một tin nhắn iMessage thử nghiệm đến bất kỳ số điện thoại nào để xác nhận mọi thứ đã được kết nối chính xác. Nhập số điện thoại của người nhận theo định dạng E.164 (ví dụ: +14155551234) cùng với một tin nhắn ngắn và gửi thử nghiệm.

Lần gửi kiểm tra đầu tiên có thể mất đến một phút, vì ứng dụng Messages trên máy Mac của bạn có thể cần bắt đầu một luồng hội thoại mới. Các lần gửi tiếp theo sẽ gần như tức thì.

Luồng tin nhắn hoạt động như thế nào

Tin nhắn đến

  1. Ai đó gửi iMessage đến Apple ID của bạn.
  2. Ứng dụng Messages trên máy Mac của bạn nhận được (giống như bình thường).
  3. BlueBubbles phát hiện tin nhắn mới và POST nó đến URL webhook.
  4. Nền tảng tạo một liên hệ (nếu là liên hệ mới), đưa tin nhắn vào Chats và — nếu AI Agent của bạn cho kênh này đang hoạt động — nó sẽ trả lời.

Tin nhắn đi

  1. Bạn hoặc AI gửi phản hồi từ nền tảng.
  2. Chúng tôi gửi tin nhắn đến máy chủ BlueBubbles của bạn.
  3. BlueBubbles yêu cầu ứng dụng Messages trên máy Mac của bạn gửi tin nhắn iMessage.
  4. Người nhận thấy một tin nhắn iMessage bong bóng xanh bình thường từ Apple ID của bạn.

Các loại tin nhắn được hỗ trợ

  • Tin nhắn văn bản — được hỗ trợ đầy đủ theo cả hai chiều.
  • Tệp đính kèm và phương tiện — các tệp đính kèm đến có thể xem được trong BlueBubbles nhưng chưa được đưa vào nền tảng trong giai đoạn Beta. Tin nhắn đi phải chứa văn bản — việc gửi hình ảnh hoặc tệp qua iMessage hiện chưa khả dụng.

Giới hạn gửi, Khởi động & Kiểm soát theo dõi

iMessage có các loại giới hạn gửi bảo vệ, cơ chế khởi động tự động và công tắc ngắt theo dõi tương tự như WhatsApp Web và Telegram, với một điểm khác biệt đáng lưu ý: trên iMessage, các tin nhắn theo dõi tự động được bật theo mặc định trên tài khoản mới kết nối, vì vậy hãy tự tắt chúng nếu bạn muốn tài khoản giữ trạng thái yên tĩnh trong khi khởi động. Apple gắn cờ mạnh tay đối với các tài khoản có hành vi giống như gửi tin nhắn hàng loạt, vì vậy các rào cản này tồn tại để giữ an toàn cho Apple ID của bạn. Bạn sẽ thấy thẻ Giới hạn gửi & Khởi động và nút chuyển đổi Theo dõi tự động trên trang cài đặt iMessage sau khi bạn đã kết nối.

Khởi động tự động (tăng dần)

Một tài khoản iMessage mới kết nối sẽ bị hạn chế có chủ đích và mở khóa thêm dung lượng theo thời gian. Tài khoản chỉ được tính là “ngày đủ điều kiện” vào những ngày gửi ít nhất 75% hạn mức hiện tại — các ngày không hoạt động sẽ không được tính.

  • Hạn mức tin nhắn hàng ngày = 50 + 8 × (day − 1), giới hạn ở mức 500/ngày (đạt được vào ngày thứ 58).
  • Hạn mức liên hệ mới hàng ngày = floor((day − 1) × 5 / 6), giới hạn ở mức 50/ngày (đạt được vào ngày thứ 61).

Trang cài đặt hiển thị ngày tăng dần hiện tại, mức sử dụng hôm nay so với hạn mức và chặng đường còn lại. Nếu Apple ID của bạn đã có lịch sử iMessage lâu dài và chính thống, bạn có thể di chuyển thanh trượt ngày tăng dần về phía trước — nhưng chỉ thực hiện điều đó một cách trung thực đối với tài khoản thực sự có lịch sử đó.

Ghi đè thủ công sau khi khởi động

Sau khi hoàn tất giai đoạn khởi động 58 ngày, một tùy chọn ghi đè cho phép bạn đẩy hạn mức tin nhắn hàng ngày lên trên 500 (từ 750 đến 5.000, theo các bước 250 tin nhắn). Hãy giữ mức thận trọng — Apple không công bố con số an toàn và việc gửi quá mức sẽ gây rủi ro cho Apple ID của bạn. Tùy chọn ghi đè chỉ khả dụng khi tài khoản đã hoàn tất giai đoạn khởi động.

Bật/tắt giới hạn gửi & công tắc ngắt theo dõi

Một nút chuyển đổi chính cho phép bật hoặc tắt các giới hạn gửi, và giới hạn liên hệ mới hàng ngày cho phép bạn đặt mức trần cho các tin nhắn đầu tiên thấp hơn mức mà quy trình khởi động cho phép. Nút chuyển đổi Theo dõi tự động sẽ dừng tất cả các tin nhắn theo dõi tự động cho tài khoản bất kể cài đặt Phát sóng/chiến dịch. Trên iMessage, nút này bắt đầu ở trạng thái bật, vì vậy một tài khoản mới kết nối sẽ gửi các tin nhắn theo dõi tự động cho đến khi bạn tắt nó đi — và bạn nên tắt nó trong khi tài khoản còn mới (dưới khoảng 30 ngày khởi động). Khi đạt đến giới hạn hàng ngày, các tin nhắn theo dõi đã lên lịch sẽ được đẩy sang ngày hôm sau thay vì bị lỗi.

Các hạn chế của iMessage Beta

Vì iMessage không có API chính thức, kênh này đi kèm với những hạn chế mà bạn sẽ không thấy trên WhatsApp, SMS hoặc Instagram. Vui lòng xem xét kỹ những điều này trước khi dựa vào iMessage cho các hoạt động nhắn tin quan trọng trong kinh doanh.

  • Máy Mac của bạn phải luôn trực tuyến và thức. Không có máy Mac, không có iMessage. Chúng tôi khuyên bạn nên tắt chế độ ngủ trên máy Mac chạy BlueBubbles hoặc sử dụng một chiếc Mac mini chuyên dụng cho việc này.
  • Chỉ dành cho các cuộc hội thoại một-một, số điện thoại. Các cuộc trò chuyện nhóm và Apple-ID (email) không được hỗ trợ chính thức trong bản Beta và có thể hoạt động không mong muốn nếu chúng đến nền tảng — chỉ sử dụng các cuộc hội thoại iMessage một-một qua số điện thoại.
  • Chỉ văn bản. Các tin nhắn chỉ có tệp đính kèm (ảnh, video, tệp) sẽ bị bỏ qua khi đến và các tin nhắn gửi đi phải chứa văn bản. Việc gửi phương tiện sẽ được thêm vào sau trong bản Beta.
  • Không có mẫu hoặc tin nhắn được phê duyệt trước. Tất cả tin nhắn đều là văn bản tự do.
  • Không có xác nhận đã gửi hoặc đã đọc trong giao diện người dùng của nền tảng. Bạn vẫn sẽ thấy chúng trong ứng dụng Messages trên máy Mac của mình.
  • Trạng thái “Sent” có nghĩa là đã chuyển giao, không phải đã nhận. Trạng thái “Sent” có nghĩa là nền tảng đã chuyển tin nhắn đến máy Mac của bạn, không phải là người nhận đã nhận được nó. Vì iMessage không có xác nhận gửi đáng tin cậy, một số tin nhắn gửi đi được đánh dấu “Sent” một cách lạc quan ngay cả khi máy Mac của bạn không thể xác nhận việc gửi (ví dụ: nếu người nhận không sử dụng iMessage). Để chắc chắn tin nhắn đã được gửi đi, hãy kiểm tra ứng dụng Messages trên máy Mac của bạn.
  • Chỉ báo đang nhập (typing indicators) yêu cầu BlueBubbles Private API. Khi AI đang soạn phản hồi, liên hệ của bạn sẽ thấy bong bóng “đang nhập…” — nhưng chỉ khi bạn đã bật các tính năng Private API trong BlueBubbles (Settings → Private API). Nếu không có nó, phản hồi vẫn gửi bình thường; liên hệ chỉ không thấy bong bóng đang nhập trước đó.
  • Tin nhắn gửi đi đầu tiên cho một liên hệ mới có thể chậm. Bắt đầu một cuộc hội thoại hoàn toàn mới có thể mất từ 30–60 giây trong khi macOS mở luồng tin nhắn; các tin nhắn tiếp theo sẽ nhanh hơn.
  • Không gửi hàng loạt / phát sóng (broadcast). Trong bản Beta, iMessage được sử dụng tốt nhất cho các cuộc hội thoại đến và phản hồi một-một, không phải cho các chương trình phát sóng gửi đi với số lượng lớn. Apple giới hạn tốc độ và gắn cờ mạnh mẽ lưu lượng iMessage tự động.
  • Rủi ro tài khoản. Apple không chính thức cho phép tự động hóa iMessage của bên thứ ba. Việc sử dụng quá mức hoặc spam tự động hóa iMessage có thể dẫn đến việc Apple ID của bạn bị gắn cờ hoặc hạn chế bởi Apple. Hãy sử dụng kênh này một cách có trách nhiệm.

Khắc phục sự cố

“Không thể kết nối với máy chủ BlueBubbles”

  • Xác nhận rằng BlueBubbles đang chạy trên máy Mac của bạn và chỉ báo Server running màu xanh lá cây đang hiển thị.
  • Xác nhận rằng đường hầm (tunnel) của bạn (Cloudflare / ngrok / Tailscale) đang hoạt động và URL bạn đã dán có thể truy cập được từ internet công cộng — hãy mở nó trong trình duyệt, bạn sẽ thấy trang chào mừng của BlueBubbles.
  • Kiểm tra kỹ xem mật khẩu máy chủ có khớp với mật khẩu đã đặt trong BlueBubbles → Settings → API hay không.

Tin nhắn đến không xuất hiện trong Hộp thư đến

  • Mở BlueBubbles → Settings → API & Webhooks → Webhooks và xác nhận URL webhook mà chúng tôi đã hiển thị cho bạn được lưu chính xác như đã hiển thị.
  • Từ trang cài đặt iMessage, sử dụng Refresh status để xác minh kết nối vẫn ổn định.
  • Đảm bảo số của người gửi là số điện thoại, không phải địa chỉ email (địa chỉ email không được hỗ trợ trong bản Beta).
  • Xác nhận máy Mac của bạn có kết nối internet và đang ở trạng thái thức.

Tin nhắn gửi đi không thành công

  • Kiểm tra cùng một người nhận trực tiếp từ ứng dụng Messages trên máy Mac của bạn. Nếu Messages.app cũng không thể gửi (ví dụ: người nhận không sử dụng iMessage), thì nền tảng cũng không thể gửi được.
  • Đảm bảo máy Mac của bạn không ở chế độ ngủ, không bị khóa bằng FileVault hoặc không hiển thị hộp thoại cập nhật hệ thống — những điều này chặn tự động hóa AppleScript mà BlueBubbles dựa vào.
  • Xác nhận rằng bạn có đủ tín dụng trong tài khoản của mình.

Trạng thái hiển thị “Connected” nhưng không có gì hoạt động

  • Sử dụng Refresh status (Làm mới trạng thái) trên trang cài đặt iMessage để xác minh lại kết nối.
  • Nếu vẫn thất bại, hãy ngắt kết nối, sau đó kết nối lại với URL máy chủ và mật khẩu mới.

Máy Mac của tôi đã khởi động lại / Mất kết nối internet

Khi máy Mac của bạn trực tuyến trở lại và BlueBubbles khởi động lại, kết nối sẽ tự động tiếp tục. Bất kỳ tin nhắn nào được gửi cho bạn trong khi máy Mac ngoại tuyến sẽ xuất hiện trong ứng dụng Messages sau khi nó kết nối lại, nhưng chúng có thể không được phát lại vào nền tảng — iMessage không cung cấp API sao lưu tin nhắn đáng tin cậy.

Cần trợ giúp?

iMessage hiện đang trong giai đoạn Beta. Nếu bạn gặp phải các vấn đề mà chúng tôi chưa đề cập ở trên, hãy liên hệ với hi@youraiconnector.com cùng với:

  • URL máy chủ bạn đã kết nối (không bao gồm mật khẩu).
  • Mô tả về vấn đề và bất kỳ thông báo lỗi nào từ trang cài đặt iMessage.
  • Thời điểm xảy ra vấn đề.

Chúng tôi sẽ xem xét ngay khi có thể.