Your AI Connector Docs

iMessage (Beta)

Bawa iMessage ke dalam kotak masuk terpadu Anda. Hubungkan Mac yang menjalankan BlueBubbles dan iMessage Anda akan mengalir ke platform bersama WhatsApp, SMS, Instagram, dan Messenger — dengan Agen AI, Siaran, dan riwayat kontak yang sama yang sudah Anda gunakan di tempat lain.

Saluran Beta. Dukungan iMessage saat ini hanya melalui undangan sementara kami menyempurnakan pengalamannya. Hubungi dukungan untuk mengaktifkannya di akun Anda. Fungsionalitas, batasan, dan perilaku dapat berubah seiring dengan kematangan saluran ini.

Ikhtisar

Apple tidak menawarkan API iMessage resmi — sekumpulan aturan yang memungkinkan aplikasi lain terhubung ke iMessage secara langsung. Sebagai gantinya, integrasi ini terhubung melalui aplikasi jembatan sumber terbuka bernama BlueBubbles, yang Anda jalankan di Mac yang masuk ke akun iMessage Anda. Setelah terhubung, platform akan:

  • Menerima iMessage masuk sebagai percakapan baru di Obrolan.
  • Mengirim balasan keluar melalui Mac Anda, sehingga muncul bagi penerima sebagai iMessage gelembung biru normal dari ID Apple Anda.
  • Memungkinkan Agen AI, tag, dan catatan kontak Anda berfungsi persis seperti yang mereka lakukan di saluran lain.

Penyiapan memakan waktu sekitar 10 menit setelah Anda menginstal BlueBubbles.

Apa yang Anda Butuhkan

Untuk menghubungkan iMessage, Anda memerlukan semua hal berikut:

  • Sebuah Mac (laptop atau desktop) yang masuk ke ID Apple Anda dengan iMessage diaktifkan di aplikasi Pesan.
  • Mac harus tetap daring dan menyala. Jika Mac Anda tidur, memulai ulang, atau kehilangan internet, iMessage akan berhenti mengalir sampai kembali daring.
  • Server BlueBubbles diinstal di Mac tersebut — aplikasi sumber terbuka gratis yang tersedia di bluebubbles.app.
  • Cara untuk mengekspos Mac Anda ke internet — biasanya terowongan seperti Cloudflare Tunnel, ngrok, atau Tailscale. Panduan penyiapan BlueBubbles akan memandu Anda melalui ini.
  • Paket berbayar — iMessage disertakan sebagai bagian dari kuota saluran Anda pada semua paket saat ini.

Menyiapkan BlueBubbles

BlueBubbles adalah aplikasi pihak ketiga terpisah yang Anda instal di Mac Anda sendiri. Kami tidak menghostingnya — aplikasi ini berjalan secara lokal di mesin Anda.

  1. Unduh dan instal BlueBubbles Server dari bluebubbles.app.
  2. Berikan izin yang diminta oleh penginstal (Aksesibilitas, Akses Disk Penuh, Otomatisasi). Ini memungkinkan BlueBubbles membaca pesan masuk dan memicu aplikasi Pesan untuk mengirim pesan keluar.
  3. Buka BlueBubbles → Pengaturan → API & Webhook.
  4. Tetapkan kata sandi server.
  5. Salin URL server Anda (alamat publik yang mengarah ke Mac Anda).
  6. Verifikasi di BlueBubbles bahwa pesan uji masuk dan keluar berfungsi secara lokal sebelum melanjutkan.

Petunjuk penyiapan lengkap, pemecahan masalah, dan panduan khusus platform ada di dokumentasi resmi BlueBubbles. Jika Anda mengalami kendala pada BlueBubbles itu sendiri, dokumentasi dan komunitas mereka adalah jalur tercepat.

Menghubungkan BlueBubbles ke Platform

Setelah BlueBubbles berjalan di Mac Anda:

  1. Di bilah sisi kiri, klik Settings di dekat bagian bawah.
  2. Di rel kiri Settings, di bawah Channels, klik Channels.
  3. Temukan kartu iMessage dan klik Connect. (Tombol Connect hanya dapat diklik setelah iMessage diaktifkan untuk akun Anda — sampai saat itu tombol tersebut akan berwarna abu-abu dan kartu akan menampilkan catatan “iMessage is in private beta and isn’t enabled on your account yet.”)
  1. Tempelkan Server URL BlueBubbles Anda (contoh: https://your-tunnel.example.com).
  2. Tempelkan server password BlueBubbles Anda.
  3. Klik Connect.

Kami memverifikasi koneksi dengan menghubungi server BlueBubbles Anda dan menghubungkan webhook secara otomatis (webhook adalah alamat web yang memungkinkan BlueBubbles memberi tahu platform secara otomatis saat pesan baru tiba). Jika semuanya benar, status akan berubah menjadi Terhubung.

  1. Di BlueBubbles, buka Pengaturan → API & Webhook → Webhook dan konfirmasi (atau tempel) URL webhook yang ditampilkan di halaman pengaturan iMessage.
  2. Simpan.

Selesai — iMessage yang masuk sekarang akan tiba di kotak masuk Anda secara waktu nyata (real time).

Menguji Koneksi

Dari halaman pengaturan iMessage, Anda dapat mengirim iMessage uji ke nomor telepon mana pun untuk memastikan semuanya terhubung dengan benar. Masukkan nomor telepon penerima dalam format E.164 (misalnya +14155551234) beserta pesan singkat dan kirim uji coba tersebut.

Pengiriman percobaan pertama mungkin memerlukan waktu hingga satu menit, karena aplikasi Messages di Mac Anda mungkin perlu memulai utas percakapan baru. Pengiriman berikutnya akan berlangsung hampir instan.

Bagaimana Pesan Mengalir

Masuk

  1. Seseorang mengirim iMessage ke ID Apple Anda.
  2. Aplikasi Pesan di Mac Anda menerimanya (seperti biasa).
  3. BlueBubbles mendeteksi pesan baru dan mengirimkannya (POST) ke URL webhook.
  4. Platform membuat kontak (jika baru), memasukkan pesan ke Obrolan, dan — jika Agen AI Anda untuk saluran ini aktif — ia akan membalas.

Keluar

  1. Anda atau AI mengirim balasan dari platform.
  2. Kami mengirim pesan ke server BlueBubbles Anda.
  3. BlueBubbles memberi tahu aplikasi Pesan di Mac Anda untuk mengirim iMessage.
  4. Penerima melihat iMessage gelembung biru normal dari ID Apple Anda.

Jenis Pesan yang Didukung

  • Pesan teks — didukung sepenuhnya di kedua arah.
  • Lampiran dan media — lampiran yang masuk dapat dilihat di BlueBubbles tetapi belum dimasukkan ke dalam platform selama masa Beta. Pesan keluar harus berisi teks — mengirim gambar atau file melalui iMessage belum tersedia.

Batasan Pengiriman, Pemanasan & Kontrol Tindak Lanjut

iMessage memiliki jenis batas pengiriman protektif, pemanasan otomatis, dan tombol pemutus tindak lanjut yang sama seperti yang dimiliki WhatsApp Web dan Telegram, dengan satu perbedaan yang perlu diketahui: di iMessage, tindak lanjut otomatis diaktifkan secara default pada akun yang baru terhubung, jadi matikan sendiri jika Anda ingin akun tetap tenang selama masa pemanasan. Apple secara agresif menandai akun yang berperilaku seperti pengirim massal, jadi pagar pembatas ini ada untuk menjaga keamanan Apple ID Anda. Anda akan menemukan kartu Batas Pengiriman & Pemanasan dan tombol Tindak Lanjut Otomatis di halaman pengaturan iMessage setelah Anda terhubung.

Pemanasan otomatis (ramp)

Akun iMessage yang baru terhubung sengaja dibatasi dan akan membuka lebih banyak kapasitas seiring waktu. Akun tersebut mendapatkan “hari kualifikasi” hanya pada hari-hari di mana akun tersebut benar-benar mengirim setidaknya 75% dari batas saat ini — hari-hari tidak aktif tidak dihitung.

  • Batas pesan harian = 50 + 8 × (day − 1), dibatasi pada 500/hari (tercapai pada hari ke-58).
  • Batas kontak baru harian = floor((day − 1) × 5 / 6), dibatasi pada 50/hari (tercapai pada hari ke-61).

Halaman pengaturan menampilkan hari ramp saat ini, penggunaan hari ini terhadap batas, dan seberapa jauh lagi yang harus ditempuh. Jika Apple ID Anda sudah memiliki riwayat iMessage asli yang panjang, Anda dapat menggeser slider hari ramp ke depan — tetapi lakukan itu dengan jujur, hanya untuk akun yang benar-benar memiliki riwayat tersebut.

Penggantian manual di luar masa pemanasan

Setelah ramp penuh selama 58 hari, penggantian opsional memungkinkan Anda untuk menaikkan batas pesan harian di atas 500 (750 hingga 5.000, dalam langkah 250 pesan). Tetaplah konservatif — Apple tidak mempublikasikan angka yang aman, dan pengiriman berlebihan berisiko bagi Apple ID Anda. Penggantian hanya tersedia setelah akun ramp sepenuhnya.

Batas pengiriman aktif/nonaktif & tombol pemutus tindak lanjut

Tombol utama mengaktifkan atau menonaktifkan batas pengiriman, dan batas kontak baru harian memungkinkan Anda membatasi kontak pertama lebih rendah daripada yang diizinkan oleh peningkatan bertahap. Tombol Tindak Lanjut Otomatis menghentikan semua tindak lanjut otomatis untuk akun tersebut terlepas dari pengaturan Siaran/kampanye. Di iMessage, tombol ini dimulai dalam keadaan aktif, sehingga akun yang baru terhubung akan mengirim tindak lanjut otomatis sampai Anda mematikannya — dan mematikannya disarankan saat akun masih baru (di bawah ~30 hari masa peningkatan). Ketika batas harian tercapai, tindak lanjut yang dijadwalkan akan didorong ke hari berikutnya alih-alih gagal.

Keterbatasan iMessage Beta

Karena iMessage tidak memiliki API resmi, saluran ini memiliki batasan yang tidak akan Anda temui di WhatsApp, SMS, atau Instagram. Harap tinjau batasan ini dengan cermat sebelum mengandalkan iMessage untuk pengiriman pesan yang krusial bagi bisnis Anda.

  • Mac Anda harus tetap daring dan terjaga. Tidak ada Mac, tidak ada iMessage. Kami menyarankan untuk menonaktifkan mode tidur pada Mac yang menjalankan BlueBubbles, atau menggunakan Mac mini khusus untuk ini.
  • Hanya percakapan satu lawan satu, nomor telepon. Obrolan grup dan penanganan ID Apple (email) tidak didukung secara resmi selama Beta dan mungkin berperilaku tidak terduga jika mencapai platform — hanya gunakan percakapan iMessage satu lawan satu dengan nomor telepon.
  • Hanya teks. Pesan yang hanya berisi lampiran (foto, video, file) dilewati saat masuk, dan pengiriman keluar harus berisi teks pesan. Pengiriman media akan ditambahkan nanti dalam Beta.
  • Tidak ada templat atau pesan yang telah disetujui sebelumnya. Semua pesan adalah teks bentuk bebas.
  • Tidak ada tanda terima pengiriman atau baca di UI platform. Anda masih akan melihatnya di aplikasi Pesan di Mac Anda.
  • Status “Terkirim” berarti diserahkan, bukan diterima. Status “Terkirim” berarti platform menyerahkan pesan ke Mac Anda, bukan berarti penerima menerimanya. Karena iMessage tidak memiliki konfirmasi pengiriman yang andal, beberapa pengiriman ditandai “Terkirim” secara optimis bahkan ketika Mac Anda tidak dapat mengonfirmasi pengiriman (misalnya, jika penerima tidak menggunakan iMessage). Untuk memastikan pesan terkirim, periksa aplikasi Pesan di Mac Anda.
  • Indikator pengetikan memerlukan API Pribadi BlueBubbles. Saat AI sedang menyusun balasan, kontak Anda melihat gelembung “mengetik…” — tetapi hanya jika Anda telah mengaktifkan fitur API Pribadi di BlueBubbles (Pengaturan → API Pribadi). Tanpanya, balasan tetap terkirim seperti biasa; kontak hanya tidak akan melihat gelembung pengetikan terlebih dahulu.
  • Pesan keluar pertama ke kontak baru bisa lambat. Memulai percakapan baru bisa memakan waktu hingga 30–60 detik saat macOS membuka utas; pesan berikutnya akan cepat.
  • Tidak ada pengiriman massal / siaran. Selama Beta, iMessage paling baik digunakan untuk percakapan masuk dan balasan satu lawan satu, bukan siaran keluar bervolume tinggi. Apple secara agresif membatasi kecepatan dan menandai lalu lintas iMessage otomatis.
  • Risiko akun. Apple tidak secara resmi menyetujui otomatisasi iMessage pihak ketiga. Penggunaan otomatisasi iMessage yang berlebihan atau spam dapat menyebabkan ID Apple Anda ditandai atau dibatasi oleh Apple. Gunakan saluran ini dengan bertanggung jawab.

Pemecahan Masalah

“Tidak dapat menjangkau server BlueBubbles”

  • Pastikan BlueBubbles berjalan di Mac Anda dan indikator Server running berwarna hijau muncul.
  • Pastikan tunnel Anda (Cloudflare / ngrok / Tailscale) aktif dan URL yang Anda tempel dapat dijangkau dari internet publik — buka di browser, Anda seharusnya melihat halaman selamat datang BlueBubbles.
  • Periksa kembali apakah kata sandi server cocok dengan yang diatur di BlueBubbles → Settings → API.

Pesan Masuk Tidak Muncul di Kotak Masuk

  • Buka BlueBubbles → Pengaturan → API & Webhook → Webhook dan konfirmasi bahwa URL webhook yang kami tunjukkan disimpan persis seperti yang ditampilkan.
  • Dari halaman pengaturan iMessage, gunakan Segarkan status untuk memverifikasi bahwa koneksi masih sehat.
  • Pastikan nomor pengirim adalah nomor telepon, bukan alamat email (penanganan email tidak didukung dalam Beta).
  • Konfirmasikan bahwa Mac Anda memiliki konektivitas internet dan dalam keadaan terjaga.

Pesan Keluar Gagal Terkirim

  • Uji penerima yang sama secara langsung dari aplikasi Pesan di Mac Anda. Jika Messages.app juga tidak dapat mengirimnya (misalnya, penerima tidak menggunakan iMessage), maka platform juga tidak bisa.
  • Pastikan Mac Anda tidak dalam mode tidur, terkunci dengan FileVault, atau menampilkan dialog pembaruan sistem — hal ini akan memblokir otomatisasi AppleScript yang diandalkan oleh BlueBubbles.
  • Pastikan Anda memiliki kredit yang cukup di akun Anda.

Status Menunjukkan “Connected” tetapi Tidak Ada yang Berfungsi

  • Gunakan Refresh status pada halaman pengaturan iMessage untuk memverifikasi ulang koneksi.
  • Jika masih gagal, putuskan koneksi, lalu sambungkan kembali dengan URL server dan kata sandi yang baru.

Mac Saya Memulai Ulang / Kehilangan Internet

Saat Mac Anda kembali daring dan BlueBubbles mulai berjalan kembali, koneksi akan berlanjut secara otomatis. Pesan apa pun yang dikirimkan kepada Anda saat Mac sedang luring akan muncul di aplikasi Pesan setelah terhubung kembali, tetapi mungkin tidak semuanya diputar ulang ke dalam platform — iMessage tidak menyediakan API backfill yang andal.

Butuh Bantuan?

iMessage saat ini dalam tahap Beta. Jika Anda mengalami masalah yang belum kami bahas di atas, hubungi hi@youraiconnector.com dengan menyertakan:

  • URL server yang Anda hubungkan (tanpa kata sandi).
  • Deskripsi masalah dan pesan kesalahan apa pun dari halaman pengaturan iMessage.
  • Waktu terjadinya masalah.

Kami akan memeriksanya sesegera mungkin.