Your AI Connector Docs

iMessage (ベータ版)

iMessageを統合インボックスに取り込みましょう。BlueBubblesを実行しているMacを接続すると、WhatsApp、SMS、Instagram、Messengerと並んでiMessageがプラットフォームに流れ込みます。他のすべてのチャネルですでに使用しているAIエージェント、ブロードキャスト、連絡先履歴をそのまま利用できます。

ベータチャネル。 iMessageサポートは現在、エクスペリエンスを洗練させている段階のため、招待制となっています。アカウントで有効にするにはサポートまでご連絡ください。機能、制限、動作はチャネルの成熟に伴い変更される可能性があります。


概要

Appleは公式のiMessage API(他のアプリがiMessageに直接接続できるようにする一連のルール)を提供していません。代わりに、この統合はBlueBubblesというオープンソースのブリッジアプリを介して接続します。これは、iMessageアカウントにサインインしているMac上で実行します。接続が完了すると、プラットフォームは以下の処理を行います。

  • 受信したiMessageを「チャット」内の新しい会話として受け取ります。
  • 送信メッセージはMac経由で送信されるため、受信者にはあなたのApple IDからの通常の青い吹き出しのiMessageとして表示されます。
  • AIエージェント、タグ、連絡先レコードが他のすべてのチャネルとまったく同じように機能します。

BlueBubblesのインストール後、セットアップには約10分かかります。


必要なもの

iMessageを接続するには、以下のすべてが必要です。

  • Mac (ノート型またはデスクトップ型): Apple IDでサインインし、メッセージアプリでiMessageが有効になっていること。
  • Macはオンラインかつスリープ解除の状態を維持する必要があります。 Macがスリープ、再起動、またはインターネット接続が切断されると、オンラインに戻るまでiMessageは届かなくなります。
  • BlueBubbles Server: そのMacにインストールされていること(bluebubbles.appで入手可能な無料のオープンソースアプリ)。
  • Macをインターネットに公開する方法: 通常はCloudflare Tunnel、ngrok、Tailscaleなどのトンネルを使用します。BlueBubblesのセットアップウィザードが手順を案内します。
  • 有料プラン: iMessageは、現在のすべてのプランのチャネル許容量に含まれています。

BlueBubblesのセットアップ

BlueBubblesは、お客様自身のMacにインストールする独立したサードパーティ製アプリケーションです。当社はホストしておらず、お客様のコンピュータ上でローカルに実行されます。

  1. bluebubbles.appからBlueBubbles Serverをダウンロードしてインストールします。
  2. インストーラーが要求する権限(アクセシビリティ、フルディスクアクセス、自動化)を許可します。これにより、BlueBubblesは受信メッセージを読み取り、メッセージアプリをトリガーして送信メッセージを送信できるようになります。
  3. BlueBubblesを開き、Settings → API & Webhooksに移動します。
  4. サーバーパスワードを設定します。
  5. サーバーURL(Macを指すパブリックアドレス)をコピーします。
  6. 次に進む前に、BlueBubblesで受信および送信のテストメッセージがローカルで機能することを確認します。

完全なセットアップ手順、トラブルシューティング、およびプラットフォーム固有のガイドは、公式BlueBubblesドキュメントに記載されています。BlueBubbles自体で問題が発生した場合は、彼らのドキュメントやコミュニティが最も迅速な解決策となります。


BlueBubblesをプラットフォームに接続する

MacでBlueBubblesが実行されたら、以下の手順を行います。

  1. 左側のサイドバーの下部付近にある Settings をクリックします。
  2. 設定の左側レールにある Channels の下で、Channels をクリックします。
  3. iMessage カードを見つけて Connect をクリックします。(Connect ボタンは、アカウントで iMessage が有効になるとクリックできるようになります。それまではグレーアウトしており、カードには「iMessage is in private beta and isn’t enabled on your account yet.(iMessage はプライベートベータ版であり、現在のアカウントでは有効になっていません。)」という注記が表示されます。)
  1. BlueBubbles の Server URL を貼り付けます(例: https://your-tunnel.example.com)。
  2. BlueBubbles の server password を貼り付けます。
  3. Connect をクリックします。

接続を確認するためにBlueBubblesサーバーにアクセスし、Webhookを自動的に配線します(Webhookとは、新しいメッセージが届いた瞬間にBlueBubblesがプラットフォームに通知できるようにするWebアドレスです)。すべてが正常であれば、ステータスがConnectedに切り替わります。

  1. BlueBubblesでSettings → API & Webhooks → Webhooksを開き、iMessage設定ページに表示されているWebhook URLを確認(または貼り付け)します。
  2. 保存します。

これで完了です。受信した iMessage がリアルタイムで受信トレイに届くようになります。

接続のテスト

iMessage設定ページから、任意の電話番号にテストiMessageを送信して、すべてが正しく配線されていることを確認できます。受信者の電話番号をE.164形式(例: +14155551234)で入力し、短いメッセージを添えてテストを送信してください。

最初のテスト送信には最大 1 分かかる場合があります。これは、Mac のメッセージアプリが新しい会話スレッドを開始する必要があるためです。2 回目以降の送信はほぼ瞬時に行われます。


メッセージの流れ

受信

  1. 誰かがあなたのApple IDにiMessageを送信します。
  2. Mac上のメッセージアプリがそれを受信します(通常通り)。
  3. BlueBubblesが新しいメッセージを検出し、Webhook URLにPOSTします。
  4. プラットフォームが(新規の場合)連絡先を作成し、メッセージを「チャット」にドロップします。このチャネルのAIエージェントがアクティブな場合は、返信を行います。

送信

  1. あなたまたはAIがプラットフォームから返信を送信します。
  2. メッセージがBlueBubblesサーバーに送信されます。
  3. BlueBubblesがMac上のメッセージアプリにiMessageを送信するように指示します。
  4. 受信者には、あなたのApple IDからの通常の青い吹き出しのiMessageとして表示されます。

サポートされているメッセージタイプ

  • テキストメッセージ — 双方向で完全にサポートされています。
  • 添付ファイルとメディア — 受信した添付ファイルは BlueBubbles で確認できますが、ベータ版の期間中はプラットフォームに取り込まれません。送信メッセージにはテキストを含める必要があります。iMessage を介した画像やファイルの送信はまだ利用できません。

送信制限、ウォームアップ、およびフォローアップの制御

iMessageには、WhatsApp WebやTelegramと同様の保護的な送信制限、自動ウォームアップ、フォローアップのキルスイッチ機能がありますが、知っておくべき違いが1つあります。iMessageでは、新しく接続されたアカウントで自動フォローアップがデフォルトでオンになっています。アカウントのウォームアップ期間中に静かな状態を保ちたい場合は、ご自身でオフにしてください。Appleは大量送信者のような挙動をするアカウントを厳しくフラグ付けするため、これらのガードレールはApple IDを安全に保つために存在します。接続後、iMessage設定ページに**送信制限とウォームアップ(Send Limits & Warm-up)カードと自動フォローアップ(Automated Follow-ups)**のトグルが表示されます。

自動ウォームアップ(ランプアップ)

新しく接続されたiMessageアカウントは意図的に制限がかけられており、時間の経過とともに容量が解放されます。「認定日」は、現在の制限の少なくとも75%を実際に送信した日にのみカウントされ、何も送信しなかった日はカウントされません。

  • 1日のメッセージ上限 = 50 + 8 × (day − 1)(最大500通/日、58日目に到達)。
  • 1日の新規連絡先上限 = floor((day − 1) × 5 / 6)(最大50件/日、61日目に到達)。

設定ページには、現在のランプアップ日数、本日の使用量と上限、および目標までの進捗状況が表示されます。Apple IDにすでに長期間の正当なiMessage利用履歴がある場合は、ランプアップ日数のスライダーを進めることができますが、実際にその履歴があるアカウントに対してのみ、正直に行ってください。

ランプアップ後の手動オーバーライド

58日間の完全なランプアップ期間終了後、オプションのオーバーライド機能を使用して、1日のメッセージ上限を500通以上に引き上げることができます(750通から最大5,000通まで、250通単位で設定可能)。Appleは安全な数値を公開しておらず、送信しすぎるとApple IDが危険にさらされるため、控えめに設定してください。このオーバーライドは、アカウントが完全にランプアップされた後にのみ利用可能です。

送信制限のオン/オフとフォローアップの強制停止スイッチ

マスタートグルで送信制限の有効/無効を切り替えることができ、1日の新規連絡先上限を設定することで、ランプアップで許可されるよりも低い値で初回接触数を制限できます。**自動フォローアップ(Automated Follow-ups)**トグルは、ブロードキャストやキャンペーンの設定に関係なく、アカウントのすべての自動フォローアップを停止します。iMessageでは、このトグルは最初からオンになっているため、新しく接続されたアカウントはオフにするまで自動フォローアップを送信し続けます。アカウントが新しい(ランプアップ期間が約30日未満の)間は、オフにしておくことを推奨します。1日の上限に達した場合、スケジュールされたフォローアップは失敗するのではなく、翌日に繰り越されます。


iMessage ベータ版の制限事項

iMessageには公式APIが存在しないため、このチャネルにはWhatsApp、SMS、Instagramにはない制約があります。ビジネス上重要なメッセージングにiMessageを利用する前に、以下の内容をよくご確認ください。

  • Macはオンラインかつスリープ解除状態である必要があります。 MacがオフだとiMessageも機能しません。BlueBubblesを実行しているMacのスリープを無効にするか、専用のMac miniを使用することをお勧めします。
  • 1対1の電話番号による会話のみ。 グループチャットやApple ID(メールアドレス)ハンドルはベータ期間中は公式にサポートされておらず、プラットフォームに到達した場合に予期しない動作をする可能性があります。電話番号による1対1のiMessage会話のみを使用してください。
  • テキストのみ。 添付ファイルのみのメッセージ(写真、動画、ファイル)は受信時にスキップされ、送信メッセージにはテキストを含める必要があります。メディアの送信はベータ期間中の後半に追加される予定です。
  • テンプレートや事前承認済みメッセージはありません。 すべてのメッセージは自由形式のテキストです。
  • プラットフォームUIには配信確認や既読確認はありません。 Mac上のメッセージアプリでは引き続き確認できます。
  • 「送信済み」ステータスは、配信完了ではなく引き渡しを意味します。 「送信済み」ステータスは、プラットフォームがメッセージをMacに引き渡したことを意味し、受信者が受け取ったことを意味するものではありません。iMessageには信頼できる配信確認がないため、Macが配信を確認できなかった場合(受信者がiMessageを使用していない場合など)でも、一部の送信は楽観的に「送信済み」とマークされます。メッセージが確実に届いたかを確認するには、Macのメッセージアプリを確認してください。
  • 入力インジケーターにはBlueBubbles Private APIが必要です。 AIが返信を作成しているとき、連絡先には「入力中…」の吹き出しが表示されますが、これはBlueBubblesでPrivate API機能を有効にしている場合に限られます(Settings → Private API)。有効でない場合、返信は通常通り送信されますが、連絡先に「入力中」の吹き出しは表示されません。
  • 新しい連絡先への最初の送信は遅くなる場合があります。 まったく新しい会話を開始する場合、macOSがスレッドを開くために30〜60秒かかることがあります。2回目以降のメッセージは高速です。
  • 一括送信/ブロードキャスト送信はできません。 ベータ期間中、iMessageはインバウンドの会話や1対1の返信に使用するのが最適であり、大量の送信を行うブロードキャストには適していません。Appleは自動化されたiMessageトラフィックを積極的にレート制限し、フラグ付けします。
  • アカウントのリスク。 AppleはサードパーティによるiMessageの自動化を公式に認めていません。iMessageの自動化を過度に使用したりスパムとして利用したりすると、AppleによってApple IDがフラグ付けされたり制限されたりする可能性があります。チャネルは責任を持って使用してください。

トラブルシューティング

「BlueBubblesサーバーに接続できませんでした」

  • MacでBlueBubblesが実行されており、緑色の Server running インジケーターが表示されていることを確認してください。
  • トンネル(Cloudflare / ngrok / Tailscale)が起動しており、貼り付けたURLがパブリックインターネットからアクセス可能であることを確認してください。ブラウザで開くと、BlueBubblesのウェルカムページが表示されるはずです。
  • サーバーパスワードが BlueBubbles → Settings → API で設定したものと一致しているか再確認してください。

受信メッセージが受信トレイに表示されない

  • BlueBubbles → Settings → API & Webhooks → Webhooksを開き、表示されたWebhook URLが正確に保存されていることを確認します。
  • iMessage設定ページからRefresh statusを使用して、接続が正常であることを確認します。
  • 送信者の番号が電話番号であることを確認してください(メールアドレスはベータ版ではサポートされていません)。
  • Macがインターネットに接続されており、スリープ状態でないことを確認してください。

送信メッセージが失敗する

  • Macの「メッセージ」アプリから、同じ受信者に対して直接テストを行ってください。「メッセージ」アプリでも送信できない場合(例:受信者がiMessageを利用していない)、プラットフォームでも送信できません。
  • Macがスリープ状態、FileVaultでロックされている、またはシステムアップデートのダイアログが表示されていないことを確認してください。これらはBlueBubblesが依存しているAppleScriptの自動化をブロックします。
  • アカウントに十分なクレジットがあることを確認してください。

ステータスは「接続済み」だが動作しない

  • iMessage設定ページの Refresh status を使用して、接続を再確認してください。
  • それでも失敗する場合は、接続を解除してから、新しいサーバーURLとパスワードで再接続してください。

Macが再起動した、またはインターネット接続が切れた

Macがオンラインに戻り、BlueBubblesが再起動すると、接続は自動的に再開されます。Macがオフラインの間に送信されたメッセージは、再接続後に「メッセージ」アプリには表示されますが、すべてがプラットフォームに同期(リプレイ)されるとは限りません。iMessageには信頼できるバックフィルAPIが公開されていないためです。


ヘルプが必要ですか?

iMessageは現在 ベータ版 です。上記で解決しない問題が発生した場合は、以下を添えて hi@youraiconnector.com までご連絡ください。

  • 接続したサーバーURL(パスワードは含めないでください)。
  • 問題の説明と、iMessage設定ページに表示されるエラーメッセージ。
  • 問題が発生した日時。

確認でき次第、対応いたします。