Comment connecter HappyCapy à iMessage : un agent IA complet dans Apple Messages
BlueBubbles + le capy-bridge de HappyCapy : la même stack qu'utilise Hermes Agent — désormais disponible en tant que skill à un clic.
Apple n'a jamais publié d'API iMessage. Ni en 2015. Ni en 2020. Ni aujourd'hui. Pendant des années, créer un agent IA vivant dans vos iMessages nécessitait soit un jailbreak, soit un forfait entreprise à 200 $/mois, soit une compréhension approfondie de protocoles non documentés. En juin 2026, une voie gratuite et open-source fonctionne enfin de manière fiable — et il s'agit de la même architecture que celle utilisée en production par le projet Hermes Agent, fort de 188 000 étoiles.
Pourquoi iMessage est la plateforme la plus difficile (et pourquoi c'est important)
La plupart des plateformes de messagerie disposent d'une API. Telegram a publié la sienne en 2015. Slack propose des webhooks depuis ses débuts. WhatsApp a ouvert son API Business en 2018. iMessage n'a jamais rien proposé de tout cela, et ce n'est pas un oubli.
Le protocole iMessage d'Apple utilise un chiffrement de bout en bout directement lié aux identifiants Apple et à des clés spécifiques à chaque appareil. Ces clés sont générées sur du matériel Apple et n'en sortent jamais. Chaque message est chiffré et déchiffré sur un appareil Apple physique. Il n'existe pas d'API côté serveur car aucun serveur ne détient le contenu déchiffré. C'est une contrainte cryptographique stricte — pas un choix de politique qu'Apple pourrait annuler par un simple communiqué de presse.
La conséquence pratique : aucun processus Linux, aucun conteneur Docker, aucune VM cloud ne peut envoyer ou recevoir nativement des iMessages. Pas même avec un accès root. Pas même avec un identifiant Apple valide. Le protocole ne fonctionne tout simplement pas hors du matériel Apple.
Pour les développeurs d'agents IA, cela signifie que l'intégration iMessage nécessite toujours un Mac dans la boucle. C'est la réponse honnête, et elle façonne tout le reste de cet article.
L'inverse est également vrai : pour les utilisateurs Apple, cette architecture signifie que le bot vit à l'intérieur même de Messages.app. Aucune application tierce à installer. Aucun nouveau compte à créer. L'IA répond via la même interface que votre famille et vos collègues utilisent déjà. Lorsque vos contacts vous écrivent, ils ne remarquent aucun changement — ils voient des réponses provenant de votre identifiant Apple, formatées comme des iMessages natifs, avec accusés de lecture.
Cette combinaison — friction nulle pour le destinataire, confidentialité cryptographique, sur la plateforme à laquelle les utilisateurs Apple font déjà confiance — explique pourquoi iMessage vaut la complexité supplémentaire.
Comment ça fonctionne réellement
La solution gratuite et open-source s'appelle BlueBubbles. Il s'agit d'une application serveur pour Mac sous licence MIT, qui s'exécute sur votre Mac, s'enregistre avec votre identifiant Apple et expose une API REST locale. BlueBubbles agit comme un pont entre le protocole iMessage (qui nécessite macOS) et tout service externe capable d'effectuer des requêtes HTTP.
Le capy-bridge de HappyCapy se connecte à cette API REST. Lorsqu'un message arrive sur votre identifiant Apple, voici la séquence exacte :
| Étape | Ce qui se passe |
|---|---|
| 1. Réception de l'iMessage | Apple livre le message à votre Mac via le protocole iMessage standard |
| 2. Interception par BlueBubbles | Le serveur BlueBubbles sur votre Mac lit le message entrant |
| 3. POST Webhook | BlueBubbles envoie le contenu du message via POST vers le point de terminaison capy-bridge de HappyCapy |
| 4. Traitement par le bridge | capy-bridge analyse l'expéditeur, le texte du message et l'historique de la conversation |
5. claude --print | Le bridge lance le CLI Claude Code avec un accès complet aux outils |
| 6. Exécution par Claude | Claude exécute des outils — bash, recherche web, opérations sur fichiers, tout Skill installé |
| 7. Envoi de la réponse | La réponse est renvoyée via l'API REST de BlueBubbles vers le fil iMessage d'origine |
| 8. Livraison de l'iMessage | Le destinataire voit une réponse dans son application Messages.app en quelques secondes |
Il s'agit de la même architecture qu'utilise Hermes Agent. Le projet Hermes Agent — 188 000 étoiles GitHub, développé par Nous Research — fait passer son intégration iMessage par BlueBubbles dans sa configuration de production. L'architecture a été testée à grande échelle.
Le détail clé à l'étape 5 est claude --print. HappyCapy n'envoie pas votre message à un chatbot qui répond simplement par du texte. Il exécute le CLI Claude Code, qui dispose d'un accès complet aux outils : exécution bash, lecture/écriture de fichiers, recherche web, génération d'images, et accès à la bibliothèque de plus de 300 000 Skills de HappyCapy. Le bot ne se contente pas de répondre — il agit.
Ce que vous pouvez faire
Une fois le bridge en fonctionnement, chaque iMessage envoyé à votre identifiant Apple devient une interface de commande pour votre sandbox HappyCapy :
- Exécuter des tâches à distance — envoyez une tâche depuis votre iPhone, recevez un résultat entièrement exécuté avec sa sortie
- Demander des fichiers — demandez un rapport PDF, une image générée ou un script, et recevez-le
- Rechercher et résumer — demandez à l'agent de rechercher sur le web et de renvoyer un résumé structuré
- Déclencher plus de 300 000 Skills — chaque Skill de la bibliothèque HappyCapy est accessible depuis Messages.app
- Exécuter du bash sur votre sandbox —
run ls /var/logs'exécute sur votre environnement Linux HappyCapy et renvoie la sortie - Historique par contact — chaque identifiant Apple ou numéro de téléphone dispose de son propre fil de conversation ; le contexte est conservé entre les messages
- Fonctionne depuis n'importe quel appareil Apple — iPhone, iPad, Mac, Apple Watch — tout ce qui envoie des iMessages atteint le bot
Avantages
- Expérience Apple native — les réponses apparaissent dans le fil standard de Messages.app ; les destinataires n'ont rien à installer
- Aucune application tierce sur l'appareil du destinataire — le bot communique via l'infrastructure iMessage existante
- Fonctionne avec n'importe quel identifiant Apple — tout contact pouvant vous envoyer un iMessage peut interagir avec le bot
- Chiffrement de bout en bout — BlueBubbles ne casse pas le chiffrement d'Apple ; il lit les messages après leur déchiffrement sur votre Mac
- Gratuit et open-source — BlueBubbles est sous licence MIT ; aucun frais d'abonnement
- Architecture validée par Hermes — la même pile technique qui alimente un projet d'agent en production fort de 188 000 étoiles
- Capacité d'agent complète —
claude --printdonne au bot un accès bash, la recherche web, les opérations sur fichiers et plus de 300 000 Skills
Cas d'usage réels
Développeur sur iPhone. Vous êtes loin de votre ordinateur portable et devez vérifier si une tâche cron s'est exécutée, suivre un fichier de log ou redémarrer un service sur votre sandbox HappyCapy. Vous envoyez la commande depuis Messages.app sur votre iPhone. Le bridge l'exécute et renvoie la sortie en réponse. Pas de client SSH, pas de VPN, pas de changement de contexte.
Foyer 100 % Apple. Votre partenaire, vos parents ou vos colocataires utilisent tous iMessage et rien d'autre. Plutôt que de leur demander d'installer Telegram ou d'apprendre une nouvelle interface, vous configurez le bot sur votre identifiant Apple existant. Tout le monde interagit via l'application déjà présente sur son appareil.
Propriétaire d'entreprise avec des clients sur iMessage. Vous communiquez avec vos clients via iMessage — c'est ce qu'ils utilisent, et les faire basculer vers une autre plateforme n'est pas réaliste. Avec le bridge en fonctionnement, vous pouvez demander à l'agent de résumer un long fil de discussion, de rédiger une réponse dans votre style, de consulter l'historique de commandes d'un client ou d'extraire un rapport. L'IA reste dans le canal où la relation existe déjà.
Chercheur avec un Mac. Vous gardez un Mac allumé sur votre bureau. Vous souhaitez un agent IA toujours accessible — depuis votre iPhone pendant un trajet, depuis votre iPad en réunion, depuis le Mac d'un collègue en cas d'urgence. iMessage est déjà synchronisé sur tous les appareils Apple que vous possédez. Le bot hérite automatiquement de cette portée.
L'exigence du Mac — évaluation honnête
L'installation nécessite un Mac avec BlueBubbles installé et en fonctionnement, connecté à HappyCapy via capy-bridge. Le Mac doit rester éveillé et connecté pour que le bridge fonctionne. S'il se met en veille, le bot passe hors ligne.
C'est une contrainte réelle. Si vous ne possédez pas de Mac, ou si votre Mac est un ordinateur portable que vous transportez et fermez régulièrement, iMessage n'est pas le bon canal pour vous. Les intégrations Telegram et Slack de HappyCapy fonctionnent sur une infrastructure entièrement native Linux, sans dépendance matérielle.
Pour les personnes disposant déjà d'un Mac qui reste allumé — un Mac Mini sous la télévision, un Mac Studio dans un bureau à domicile, un ancien MacBook branché sur une étagère — l'installation est ponctuelle, puis entièrement automatique. BlueBubbles démarre à la connexion. Le démon capy-bridge démarre à la connexion. Le Mac continue de fonctionner, et le bot aussi.
Si vous envisagez du matériel dédié à cet usage, le Mac Mini M4 de base 2026 (799 $) est l'option la plus pratique. Il consomme environ 6 à 10 watts au repos, prend en charge un fonctionnement 24h/24 et 7j/7 sans bruit de ventilateur, et occupe un espace plus petit qu'un livre de poche. Pour une analyse complète des configurations de Mac Mini en tant que serveur IA, consultez Mac Mini as an AI Server in 2026.
Comment le configurer
La configuration complète prend environ 10 minutes :
- Téléchargez BlueBubbles sur bluebubbles.app — gratuit, sous licence MIT, open-source
- Lancez l'assistant de configuration — connectez-vous avec votre identifiant Apple et accordez les autorisations Accessibilité + Accès complet au disque
- Notez l'URL et le mot de passe de BlueBubbles depuis l'écran des paramètres de BlueBubbles
- Installez capy-bridge — exécutez
bash /app/export-port.sh 8766dans HappyCapy pour obtenir votre URL de webhook, puis lancez le skill/happycapy-imessagedans HappyCapy - Terminez l'assistant HappyCapy — collez votre URL BlueBubbles, votre mot de passe et l'URL de webhook ; le bridge s'enregistre automatiquement
- Testez — envoyez un iMessage depuis un autre appareil ; vous devriez recevoir une réponse en quelques secondes
La documentation complète du skill et le code source sont disponibles sur github.com/ndpvt-web/happycapy-imessage.
Questions fréquentes
Dois-je laisser mon Mac allumé en permanence ? Oui, pour une disponibilité 24h/24 et 7j/7. Le Mac doit rester éveillé et connecté pour que BlueBubbles et capy-bridge puissent recevoir les messages entrants. Si vous souhaitez que le bot soit disponible en permanence, utilisez du matériel capable de rester allumé — un Mac Mini ou un Mac Studio est idéal. Activez « Empêcher la mise en veille de l'écran » dans les paramètres de BlueBubbles et désactivez la mise en veille dans l'Économiseur d'énergie de macOS (mode Adaptateur secteur).
Cela fonctionne-t-il aussi avec les SMS, ou uniquement avec iMessage ? BlueBubbles prend en charge à la fois iMessage (bulles bleues) et SMS (bulles vertes) si votre Mac a un iPhone connecté et que le partage de connexion personnel est configuré pour activer le transfert des SMS. Pour la plupart des configurations, se limiter à iMessage est plus simple et plus fiable.
Apple peut-il voir mes messages via BlueBubbles ? Non. BlueBubbles ne casse pas le chiffrement de bout en bout d'Apple. Les messages sont déchiffrés par macOS sur votre machine locale, comme toujours, puis BlueBubbles les lit depuis cet état déchiffré local. Les serveurs d'Apple ne voient jamais le contenu en clair — exactement comme lors d'une utilisation normale de Messages.app.
BlueBubbles est-il gratuit ? Oui. BlueBubbles est sous licence MIT et gratuit à utiliser. Aucun frais d'abonnement. L'application serveur pour Mac, le code source et la documentation sont tous disponibles publiquement sur bluebubbles.app.
Que se passe-t-il si mon Mac se met en veille ?
Le bridge passe hors ligne. Les messages envoyés pendant que le Mac est en veille ne sont pas traités et ne sont pas traités rétroactivement au réveil du Mac. Pour éviter cela : activez « Empêcher la mise en veille de l'écran » dans BlueBubbles, désactivez la mise en veille système dans l'Économiseur d'énergie de macOS pour l'utilisation sur secteur, ou exécutez caffeinate -di & dans un terminal. Pour des installations toujours actives, les Mac de bureau (Mini, Studio, Pro) sont préférables aux ordinateurs portables.
Plusieurs personnes peuvent-elles envoyer des messages au bot depuis différents identifiants Apple ? Oui. Le bridge stocke un historique de conversation distinct par identifiant d'expéditeur. Chaque identifiant Apple ou numéro de téléphone dispose de sa propre fenêtre de contexte. Vous pouvez configurer une liste blanche (identifiants spécifiques uniquement) ou la laisser ouverte à tous les iMessages entrants.
Cela viole-t-il les conditions d'utilisation d'Apple ? BlueBubbles se situe dans une zone grise : Apple n'a pas explicitement approuvé les ponts iMessage tiers, mais n'a également entrepris aucune action contre BlueBubbles au cours des plus de quatre années de son fonctionnement. Le projet lit les messages depuis votre propre Mac, sous votre propre identifiant Apple, de la même manière que n'importe quel processus disposant d'un accès complet au disque le pourrait. L'utiliser pour votre propre automatisation — et non pour l'envoi commercial en masse ou le spam — correspond à l'usage qu'en font des dizaines de milliers de développeurs. Le projet Hermes Agent intègre BlueBubbles dans sa configuration par défaut depuis 2026.
Réflexions finales
Parmi les quatre canaux de messagerie pris en charge par HappyCapy — Telegram, Slack, WhatsApp et iMessage — iMessage est le plus exigeant techniquement à configurer. Il nécessite un Mac, un serveur BlueBubbles en fonctionnement et une connexion persistante entre votre matériel et votre sandbox HappyCapy. Cela représente davantage de composants que les autres.
Pour les utilisateurs Apple déjà installés dans cet écosystème, c'est aussi le résultat le plus fluide : un agent IA complet qui répond via l'application Messages que vos contacts utilisent quotidiennement, sans nouvelle application à installer ni nouveau compte à créer. L'architecture est éprouvée — la même pile technique derrière les 188 000 étoiles de Hermes Agent — et HappyCapy l'enveloppe dans un skill en un clic.
Si vous avez un Mac qui reste allumé, la configuration vaut bien les 10 minutes qu'elle demande.
