# iMessage (Bêta) Intégrez iMessage à votre boîte de réception unifiée. Connectez un Mac exécutant [BlueBubbles](https://bluebubbles.app) et vos iMessages seront centralisés sur la plateforme aux côtés de WhatsApp, SMS, Instagram et Messenger — avec le même agent IA, les mêmes diffusions et le même historique de contacts que vous utilisez déjà partout ailleurs. > **Canal Bêta.** La prise en charge d'iMessage est actuellement disponible sur invitation uniquement, le temps que nous peaufinions l'expérience. Contactez le support pour l'activer sur votre compte. Les fonctionnalités, les limites et le comportement peuvent évoluer à mesure que le canal arrive à maturité. --- ## Aperçu Apple ne propose pas d'API iMessage officielle — un ensemble de règles permettant à d'autres applications de se connecter directement à iMessage. Au lieu de cela, cette intégration se connecte via une application passerelle open-source appelée **BlueBubbles**, que vous exécutez sur un Mac connecté à votre compte iMessage. Une fois connecté, la plateforme : - Reçoit les iMessages entrants sous forme de nouvelles conversations dans Chats. - Envoie les réponses sortantes via votre Mac, afin qu'elles apparaissent aux destinataires comme un iMessage à bulles bleues normal provenant de votre identifiant Apple. - Permet à votre agent IA, à vos tags et à vos fiches de contact de fonctionner exactement comme sur n'importe quel autre canal. La configuration prend environ 10 minutes une fois BlueBubbles installé. --- ## Ce dont vous avez besoin Pour connecter iMessage, vous aurez besoin de tout ce qui suit : - **Un Mac** (ordinateur portable ou de bureau) connecté à votre identifiant Apple avec iMessage activé dans l'application Messages. - **Le Mac doit rester en ligne et allumé.** Si votre Mac se met en veille, redémarre ou perd sa connexion internet, les iMessages cesseront d'arriver jusqu'à ce qu'il soit de nouveau en ligne. - **BlueBubbles Server** installé sur ce Mac — une application gratuite et open-source disponible sur [bluebubbles.app](https://bluebubbles.app). - **Un moyen d'exposer votre Mac à Internet** — généralement un tunnel comme Cloudflare Tunnel, ngrok ou Tailscale. L'assistant de configuration de BlueBubbles vous guidera à travers cette étape. - **Un forfait payant** — iMessage est inclus dans votre quota de canaux sur tous les forfaits actuels. --- ## Configuration de BlueBubbles BlueBubbles est une application tierce distincte que vous installez sur votre propre Mac. Nous ne l'hébergeons pas — elle s'exécute localement sur votre machine. 1. Téléchargez et installez **BlueBubbles Server** depuis [bluebubbles.app](https://bluebubbles.app). 2. Accordez les autorisations demandées par l'installateur (Accessibilité, Accès complet au disque, Automatisation). Celles-ci permettent à BlueBubbles de lire les messages entrants et de déclencher l'application Messages pour envoyer les messages sortants. 3. Ouvrez BlueBubbles → **Settings → API & Webhooks**. 4. Définissez un **server password**. 5. Copiez votre **server URL** (une adresse publique qui pointe vers votre Mac). 6. Vérifiez dans BlueBubbles que les messages de test entrants et sortants fonctionnent localement avant de continuer. > Les instructions de configuration complètes, le dépannage et les guides spécifiques à la plateforme se trouvent dans la [documentation officielle de BlueBubbles](https://docs.bluebubbles.app). Si vous rencontrez des difficultés avec BlueBubbles lui-même, leur documentation et leur communauté sont les ressources les plus rapides. --- ## Connexion de BlueBubbles à la plateforme Une fois que BlueBubbles est en cours d'exécution sur votre Mac : 1. Dans la barre latérale gauche, cliquez sur **Paramètres** près du bas. 2. Dans le menu de gauche des paramètres, sous **Canaux**, cliquez sur **Canaux**. 3. Trouvez la carte **iMessage** et cliquez sur **Connecter**. (Le bouton **Connecter** ne devient cliquable qu'une fois qu'iMessage a été activé pour votre compte ; jusque-là, il est grisé et la carte affiche la note « iMessage est en version bêta privée et n'est pas encore activé sur votre compte. ») 4. Collez l'**URL du serveur** BlueBubbles (par ex. `https://your-tunnel.example.com`). 5. Collez le **mot de passe du serveur** BlueBubbles. 6. Cliquez sur **Connecter**. Nous vérifions la connexion en contactant votre serveur BlueBubbles et en configurant automatiquement le webhook (un webhook est une adresse web qui permet à BlueBubbles d'informer automatiquement la plateforme dès qu'un nouveau message arrive). Si tout est correct, le statut passe à **Connected**. 7. Dans BlueBubbles, ouvrez **Settings → API & Webhooks → Webhooks** et confirmez (ou collez) l'URL du webhook affichée sur la page des paramètres iMessage. 8. Enregistrez. C'est tout — les iMessages entrants arrivent désormais dans votre boîte de réception en temps réel. ### Tester la connexion Depuis la page des paramètres iMessage, vous pouvez envoyer un iMessage de test à n'importe quel numéro de téléphone pour confirmer que tout est correctement configuré. Entrez le numéro de téléphone du destinataire au format E.164 (par ex. `+14155551234`) accompagné d'un court message et envoyez le test. Le premier envoi de test peut prendre jusqu'à une minute, car l'application Messages sur votre Mac peut avoir besoin de démarrer un nouveau fil de conversation. Les envois suivants sont quasi instantanés. --- ## Comment circulent les messages ### Entrants 1. Quelqu'un envoie un iMessage à votre identifiant Apple. 2. L'application Messages sur votre Mac le reçoit (comme d'habitude). 3. BlueBubbles détecte le nouveau message et l'envoie par POST à l'URL du webhook. 4. La plateforme crée un contact (si nouveau), place le message dans Chats et — si votre agent IA pour ce canal est actif — il répond. ### Sortants 1. Vous ou l'IA envoyez une réponse depuis la plateforme. 2. Nous envoyons le message à votre serveur BlueBubbles. 3. BlueBubbles demande à l'application Messages sur votre Mac d'envoyer l'iMessage. 4. Le destinataire voit un iMessage à bulles bleues normal provenant de votre identifiant Apple. ### Types de messages pris en charge - **Messages texte** — entièrement pris en charge dans les deux sens. - **Pièces jointes et médias** — les pièces jointes entrantes sont visibles dans BlueBubbles mais ne sont **pas encore** intégrées à la plateforme pendant la phase bêta. Les messages sortants doivent contenir du texte — l'envoi d'images ou de fichiers via iMessage n'est pas encore disponible. --- ## Limites d'envoi, montée en charge (warm-up) et contrôles des suivis iMessage dispose du même type de limites d'envoi protectrices, de montée en charge automatique et de coupe-circuit de suivi que WhatsApp Web et Telegram, avec une différence importante à connaître : **sur iMessage, les suivis automatisés sont activés par défaut** sur un compte nouvellement connecté. Désactivez-les donc vous-même si vous souhaitez que le compte reste inactif pendant sa phase de montée en charge. Apple signale de manière proactive les comptes qui se comportent comme des expéditeurs de masse ; ces garde-fous existent donc pour protéger votre identifiant Apple. Vous trouverez une carte **Limites d'envoi et montée en charge** et un commutateur **Suivis automatisés** sur la page des paramètres iMessage une fois connecté. ### Montée en charge automatique (ramp) Un compte iMessage nouvellement connecté est intentionnellement limité et débloque plus de capacité au fil du temps. Il ne valide un « jour de qualification » que les jours où il envoie réellement au moins 75 % de son plafond actuel — les jours d'inactivité ne comptent pas. - **Plafond quotidien de messages** = `50 + 8 × (day − 1)`, limité à **500/jour** (atteint au 58e jour). - **Plafond quotidien de nouveaux contacts** = `floor((day − 1) × 5 / 6)`, limité à **50/jour** (atteint au 61e jour). La page des paramètres affiche le jour actuel de la montée en charge, l'utilisation d'aujourd'hui par rapport au plafond et la progression restante. Si votre identifiant Apple possède déjà un long historique iMessage authentique, vous pouvez avancer le curseur du jour de montée en charge — mais ne le faites qu'honnêtement, pour un compte qui possède réellement cet historique. ### Dépassement manuel après la montée en charge Après la période complète de 58 jours, une option de dépassement vous permet de pousser le plafond quotidien de messages au-delà de 500 (de 750 jusqu'à 5 000, par paliers de 250 messages). Restez prudent — Apple ne publie pas de chiffre sûr, et un envoi excessif met votre identifiant Apple en danger. Le dépassement n'est disponible qu'une fois que le compte a atteint sa pleine capacité. ### Activation/désactivation des limites d'envoi et coupe-circuit de suivi Un commutateur principal active ou désactive les limites d'envoi, et un plafond quotidien de nouveaux contacts vous permet de limiter les premiers contacts à un niveau inférieur à ce que la montée en charge autoriserait. Le commutateur **Suivis automatisés** arrête tous les suivis automatisés pour le compte, indépendamment des paramètres de diffusion/campagne. **Sur iMessage, ce commutateur est activé par défaut** ; un compte fraîchement connecté enverra donc des suivis automatisés jusqu'à ce que vous le désactiviez. Il est recommandé de le désactiver tant que le compte est récent (moins de ~30 jours de montée en charge). Lorsque le plafond quotidien est atteint, les suivis programmés sont reportés au lendemain au lieu d'échouer. --- ## Limitations de la version bêta d'iMessage Comme iMessage ne dispose pas d'une API officielle, ce canal comporte des contraintes que vous ne rencontrerez pas avec WhatsApp, SMS ou Instagram. Veuillez les examiner attentivement avant de compter sur iMessage pour des communications critiques pour votre entreprise. - **Votre Mac doit rester en ligne et éveillé.** Pas de Mac, pas d'iMessages. Nous recommandons de désactiver la mise en veille sur le Mac exécutant BlueBubbles, ou d'utiliser un Mac mini dédié à cet effet. - **Conversations individuelles par numéro de téléphone uniquement.** Les discussions de groupe et les identifiants Apple (e-mails) ne sont pas officiellement pris en charge pendant la version bêta et peuvent se comporter de manière inattendue s'ils atteignent la plateforme — utilisez uniquement des conversations iMessage individuelles par numéro de téléphone. - **Texte uniquement.** Les messages contenant uniquement des pièces jointes (photo, vidéo, fichier) sont ignorés lors de la réception, et les envois sortants doivent contenir du texte. L'envoi de médias sera ajouté plus tard dans la version bêta. - **Pas de modèles ou de messages pré-approuvés.** Tous les messages sont du texte libre. - **Pas d'accusés de réception ou de lecture** dans l'interface utilisateur de la plateforme. Vous les verrez toujours dans l'application Messages sur votre Mac. - **Un statut "Envoyé" signifie transmis, pas délivré.** Un statut "Envoyé" signifie que la plateforme a transmis le message à votre Mac, et non que le destinataire l'a reçu. Comme iMessage ne dispose pas de confirmation de livraison fiable, certains envois sont marqués "Envoyés" de manière optimiste même lorsque votre Mac n'a pas pu confirmer la livraison (par exemple, si le destinataire n'est pas sur iMessage). Pour être sûr qu'un message a bien été transmis, vérifiez l'application Messages sur votre Mac. - **Les indicateurs de saisie nécessitent l'API privée BlueBubbles.** Lorsque l'IA rédige une réponse, votre contact voit une bulle "en train d'écrire…" — mais seulement si vous avez activé les fonctionnalités **Private API** dans BlueBubbles (Settings → Private API). Sans cela, les réponses sont envoyées normalement ; le contact ne verra simplement pas la bulle de saisie au préalable. - **Le premier message sortant vers un nouveau contact peut être lent.** Démarrer une toute nouvelle conversation peut prendre jusqu'à 30–60 secondes le temps que macOS ouvre le fil de discussion ; les messages suivants sont rapides. - **Pas d'envoi massif / de diffusion.** Pendant la version bêta, iMessage est mieux utilisé pour les conversations entrantes et les réponses individuelles, et non pour les diffusions sortantes à haut volume. Apple limite et signale agressivement le trafic iMessage automatisé. - **Risque pour le compte.** Apple ne sanctionne pas officiellement l'automatisation iMessage tierce. Une utilisation excessive ou abusive de l'automatisation iMessage peut entraîner le signalement ou la restriction de votre identifiant Apple par Apple. Utilisez ce canal de manière responsable. --- ## Dépannage ### "Impossible de joindre le serveur BlueBubbles" - Confirmez que BlueBubbles est en cours d'exécution sur votre Mac et que l'indicateur vert **Server running** est affiché. - Confirmez que votre tunnel (Cloudflare / ngrok / Tailscale) est actif et que l'URL que vous avez collée est accessible depuis l'internet public — ouvrez-la dans un navigateur, vous devriez voir une page de bienvenue BlueBubbles. - Vérifiez que le mot de passe du serveur correspond bien à celui défini dans **BlueBubbles → Settings → API**. ### Les messages entrants n'apparaissent pas dans la boîte de réception - Ouvrez **BlueBubbles → Settings → API & Webhooks → Webhooks** et confirmez que l'URL du webhook que nous vous avons indiquée est enregistrée exactement telle qu'elle est affichée. - Depuis la page des paramètres iMessage, utilisez **Refresh status** pour vérifier que la connexion est toujours active. - Assurez-vous que le numéro de l'expéditeur est un numéro de téléphone et non une adresse e-mail (les identifiants e-mail ne sont pas pris en charge en version bêta). - Confirmez que votre Mac dispose d'une connexion Internet et qu'il est éveillé. ### Échec de l'envoi des messages sortants - Testez le même destinataire directement depuis l'application Messages sur votre Mac. Si Messages.app ne peut pas non plus l'envoyer (par exemple, si le destinataire n'utilise pas iMessage), la plateforme ne le pourra pas non plus. - Assurez-vous que votre Mac n'est pas en veille, verrouillé par FileVault ou qu'il n'affiche pas une boîte de dialogue de mise à jour système — ces éléments bloquent l'automatisation AppleScript, sur laquelle repose BlueBubbles. - Confirmez que vous disposez de suffisamment de crédits sur votre compte. ### Le statut indique "Connecté" mais rien ne fonctionne - Utilisez **Actualiser le statut** sur la page des paramètres iMessage pour revérifier la connexion. - Si cela échoue toujours, déconnectez-vous, puis reconnectez-vous avec une nouvelle URL de serveur et un nouveau mot de passe. ### Mon Mac a redémarré / a perdu Internet Lorsque votre Mac se reconnecte et que BlueBubbles redémarre, la connexion reprend automatiquement. Tous les messages qui vous ont été envoyés pendant que le Mac était hors ligne apparaîtront dans l'application Messages une fois la reconnexion établie, mais ils ne seront peut-être **pas** tous retransmis sur la plateforme — iMessage n'expose pas d'API de récupération fiable. --- ## Besoin d'aide ? iMessage est actuellement en **version bêta**. Si vous rencontrez des problèmes que nous n'avons pas abordés ci-dessus, contactez hi@youraiconnector.com avec : - L'URL du serveur que vous avez connecté (sans le mot de passe). - Une description du problème et les éventuels messages d'erreur de la page des paramètres iMessage. - L'heure à laquelle le problème est survenu. Nous examinerons cela dès que possible.