Cómo conectar HappyCapy a iMessage: un agente de IA completo en Apple Messages
BlueBubbles + capy-bridge de HappyCapy: la misma infraestructura que usa Hermes Agent, ahora disponible como skill de un solo clic.
Apple nunca ha publicado una API de iMessage. Ni en 2015. Ni en 2020. Ni hoy. Durante años, crear un agente de IA que viviera en tus iMessages requería un jailbreak, un plan empresarial de 200 $/mes, o un conocimiento profundo de protocolos no documentados. En junio de 2026, por fin funciona de forma fiable una vía gratuita y de código abierto, y es la misma arquitectura que utiliza en producción el proyecto Hermes Agent, con 188.000 estrellas.
Por qué iMessage es la plataforma más difícil (y por qué eso importa)
La mayoría de las plataformas de mensajería tienen una API. Telegram publicó la suya en 2015. Slack ha tenido webhooks desde el primer día. WhatsApp abrió su API para empresas en 2018. iMessage no ha tenido ninguna de estas, y no es un descuido.
El protocolo de iMessage de Apple usa cifrado de extremo a extremo vinculado directamente a los Apple ID y a claves específicas de cada dispositivo. Esas claves se generan en el hardware de Apple y nunca salen de él. Cada mensaje se cifra y se descifra en un dispositivo físico de Apple. No existe una API del lado del servidor porque no hay ningún servidor que almacene el contenido descifrado. Se trata de una limitación criptográfica estricta, no de una decisión de política que Apple pudiera revertir con un comunicado de prensa.
La consecuencia práctica: ningún proceso en Linux, ningún contenedor Docker, ninguna VM en la nube puede enviar o recibir iMessages de forma nativa. Ni con acceso root. Ni con un Apple ID válido. El protocolo simplemente no funciona fuera del hardware de Apple.
Para los desarrolladores de agentes de IA, esto significa que la integración con iMessage siempre requiere un Mac en el bucle. Esa es la respuesta honesta, y condiciona todo lo demás en este artículo.
Lo contrario también es cierto: para los usuarios de Apple, esta arquitectura significa que el bot vive dentro de la propia app Mensajes. Sin ninguna app de terceros que instalar. Sin ninguna cuenta nueva que crear. La IA responde a través de la misma interfaz que tu familia y tus compañeros ya usan. Cuando tus contactos te escriben, no son conscientes de que algo ha cambiado: ven respuestas desde tu Apple ID, con el formato nativo de iMessage, con confirmaciones de lectura.
Esa combinación —fricción cero para el destinatario, privacidad criptográfica y la plataforma en la que los usuarios de Apple ya confían— es la razón por la que iMessage merece la pena a pesar de su complejidad añadida.
Cómo funciona en realidad
La solución gratuita y de código abierto es BlueBubbles. Es una aplicación de servidor para Mac con licencia MIT que se ejecuta en tu Mac, se registra con tu Apple ID y expone una API REST local. BlueBubbles actúa como puente entre el protocolo de iMessage (que requiere macOS) y cualquier servicio externo capaz de hacer solicitudes HTTP.
El capy-bridge de HappyCapy se conecta a esa API REST. Cuando llega un mensaje a tu Apple ID, esta es la secuencia exacta:
| Paso | Qué ocurre |
|---|---|
| 1. Se recibe el iMessage | Apple entrega el mensaje a tu Mac mediante el protocolo estándar de iMessage |
| 2. BlueBubbles lo intercepta | El servidor BlueBubbles de tu Mac lee el mensaje entrante |
| 3. POST del webhook | BlueBubbles envía el contenido del mensaje mediante POST al endpoint de capy-bridge de HappyCapy |
| 4. El bridge lo procesa | capy-bridge analiza el remitente, el texto del mensaje y el historial de la conversación |
5. claude --print | El bridge lanza el CLI de Claude Code con acceso completo a las herramientas |
| 6. Claude ejecuta | Claude ejecuta herramientas: bash, búsqueda web, operaciones de archivos, cualquier Skill instalada |
| 7. Se envía la respuesta | La respuesta se envía de vuelta mediante la API REST de BlueBubbles al hilo original de iMessage |
| 8. Se entrega el iMessage | El destinatario ve la respuesta en su Mensajes en cuestión de segundos |
Esta es la misma arquitectura que usa Hermes Agent. El proyecto Hermes Agent —188.000 estrellas en GitHub, creado por Nous Research— dirige su integración con iMessage a través de BlueBubbles en su configuración de producción. Esta arquitectura se ha puesto a prueba a gran escala.
El detalle clave del paso 5 es claude --print. HappyCapy no envía tu mensaje a un chatbot que responde con texto. Ejecuta el CLI de Claude Code, que tiene acceso completo a herramientas: ejecución de bash, lectura y escritura de archivos, búsqueda web, generación de imágenes y acceso a la biblioteca de más de 300.000 Skills de HappyCapy. El bot no se limita a responder: actúa.
Qué puedes hacer
Una vez que el bridge está en marcha, cada iMessage a tu Apple ID se convierte en una interfaz de comandos para tu sandbox de HappyCapy:
- Ejecutar tareas de forma remota: envía una tarea desde tu iPhone y recibe un resultado completamente ejecutado con su salida
- Solicitar archivos: pide un informe en PDF, una imagen generada o un script, y recíbelo
- Buscar y resumir: pide al agente que busque en la web y devuelva un resumen estructurado
- Activar más de 300.000 Skills: cada Skill de la biblioteca de HappyCapy es accesible desde Mensajes
- Ejecutar bash en tu sandbox:
run ls /var/logse ejecuta en tu entorno Linux de HappyCapy y devuelve la salida - Historial por contacto: cada Apple ID o número de teléfono tiene su propio hilo de conversación; el contexto se mantiene entre mensajes
- Funciona desde cualquier dispositivo Apple: iPhone, iPad, Mac, Apple Watch; cualquier cosa que envíe iMessages llega al bot
Ventajas
- Experiencia nativa de Apple: las respuestas aparecen en el hilo estándar de Mensajes; los destinatarios no necesitan instalar nada
- Sin app de terceros en el dispositivo del destinatario: el bot se comunica a través de la infraestructura de iMessage ya existente
- Funciona con cualquier Apple ID: cualquier contacto que pueda enviarte iMessages puede interactuar con el bot
- Cifrado de extremo a extremo: BlueBubbles no rompe el cifrado de Apple; lee los mensajes después de que se descifran en tu Mac
- Gratuito y de código abierto: BlueBubbles tiene licencia MIT; no hay cuotas de suscripción
- Arquitectura validada por Hermes: la misma pila que impulsa un proyecto de agente en producción con 188.000 estrellas
- Capacidad completa de agente:
claude --printproporciona al bot acceso a bash, búsqueda web, operaciones de archivos y más de 300.000 Skills
Casos de uso reales
Desarrollador con el iPhone. Estás lejos de tu portátil y necesitas comprobar si se ha ejecutado un cron job, revisar un archivo de log o reiniciar un servicio en tu sandbox de HappyCapy. Envías el comando desde Mensajes en tu iPhone. El bridge lo ejecuta y te devuelve la salida como respuesta. Sin cliente SSH, sin VPN, sin cambiar de contexto.
Hogar de solo Apple. Tu pareja, tus padres o tus compañeros de piso solo usan iMessages y nada más. En lugar de pedirles que instalen Telegram o aprendan una interfaz nueva, apuntas el bot a tu Apple ID existente. Todos interactúan a través de la app que ya tienen en su dispositivo.
Empresario con clientes en iMessage. Te comunicas con tus clientes por iMessage; es lo que usan, y cambiarlos a otra plataforma no es realista. Con el bridge en marcha, puedes pedirle al agente que resuma un hilo largo, redacte una respuesta con tu tono, consulte el historial de pedidos de un cliente o extraiga un informe. La IA se queda en el canal donde ya existe la relación.
Investigador con un Mac. Tienes un Mac encendido en tu mesa. Quieres un agente de IA siempre accesible: desde tu iPhone durante un trayecto, desde tu iPad en una reunión, desde el Mac de un compañero en una emergencia. iMessage ya está sincronizado en todos tus dispositivos Apple. El bot hereda ese alcance automáticamente.
El requisito de un Mac: valoración honesta
La configuración requiere un Mac con BlueBubbles instalado y en ejecución, conectado a HappyCapy mediante capy-bridge. El Mac debe estar despierto y conectado para que el bridge funcione. Si se duerme, el bot se desconecta.
Es una limitación real. Si no tienes un Mac, o si tu Mac es un portátil que llevas contigo y cierras con frecuencia, iMessage no es el canal adecuado para ti. Las integraciones de HappyCapy con Telegram y Slack funcionan sobre infraestructura totalmente nativa de Linux, sin dependencia de hardware.
Para quienes ya tienen un Mac que permanece encendido —un Mac Mini bajo la tele, un Mac Studio en el despacho de casa, un MacBook antiguo enchufado en una estantería—, la configuración se hace una sola vez y a partir de ahí es totalmente automática. BlueBubbles arranca al iniciar sesión. El demonio capy-bridge arranca al iniciar sesión. El Mac sigue funcionando, y el bot también.
Si estás valorando hardware dedicado para este fin, el Mac Mini M4 de 2026, en su modelo base (799 $), es la opción más práctica. Consume aproximadamente entre 6 y 10 vatios en reposo, admite funcionamiento 24/7 sin ruido de ventilador y ocupa un espacio menor que un libro de bolsillo. Para un análisis completo de configuraciones de Mac Mini como servidor de IA, consulta Mac Mini as an AI Server in 2026.
Cómo configurarlo
La configuración completa lleva aproximadamente 10 minutos:
- Descarga BlueBubbles en bluebubbles.app: gratuito, con licencia MIT, de código abierto
- Ejecuta el asistente de configuración: inicia sesión con tu Apple ID y concede los permisos de Accesibilidad y Acceso completo al disco
- Anota tu URL y contraseña de BlueBubbles desde la pantalla de ajustes de BlueBubbles
- Instala capy-bridge: ejecuta
bash /app/export-port.sh 8766en HappyCapy para obtener tu URL de webhook, y luego ejecuta la skill/happycapy-imessageen HappyCapy - Completa el asistente de HappyCapy: pega tu URL de BlueBubbles, la contraseña y la URL del webhook; el bridge se registra automáticamente
- Prueba: envía un iMessage desde otro dispositivo; deberías recibir una respuesta en cuestión de segundos
La documentación completa de la skill y el código fuente están en github.com/ndpvt-web/happycapy-imessage.
Preguntas frecuentes
¿Necesito tener el Mac encendido todo el tiempo? Sí, para disponibilidad 24/7. El Mac debe estar despierto y conectado para que BlueBubbles y capy-bridge puedan recibir los mensajes entrantes. Si quieres que el bot esté disponible en todo momento, usa hardware que pueda permanecer encendido: un Mac Mini o un Mac Studio son ideales. Activa "Evitar que la pantalla se duerma" en los ajustes de BlueBubbles y desactiva la suspensión en Ahorro de energía de macOS (modo Adaptador de corriente).
¿Esto funciona también con SMS, o solo con iMessage? BlueBubbles admite tanto iMessage (burbujas azules) como SMS (burbujas verdes) si tu Mac tiene un iPhone conectado y el Punto de acceso personal está configurado para habilitar el reenvío de SMS. Para la mayoría de configuraciones, usar solo iMessage es más sencillo y fiable.
¿Puede Apple ver mis mensajes a través de BlueBubbles? No. BlueBubbles no rompe el cifrado de extremo a extremo de Apple. Los mensajes se descifran mediante macOS en tu propio equipo, como siempre, y luego BlueBubbles los lee desde ese estado local ya descifrado. Los servidores de Apple nunca ven el contenido en texto plano, igual que al usar Mensajes normalmente.
¿Es gratuito BlueBubbles? Sí. BlueBubbles tiene licencia MIT y es de uso gratuito. No hay cuotas de suscripción. La app de servidor para Mac, el código fuente y la documentación están disponibles públicamente en bluebubbles.app.
¿Qué ocurre si mi Mac se duerme?
El bridge se desconecta. Los mensajes enviados mientras el Mac duerme no se procesan y no se responden retroactivamente cuando el Mac se despierta. Para evitarlo: activa "Evitar que la pantalla se duerma" en BlueBubbles, desactiva la suspensión del sistema en Ahorro de energía de macOS para el uso con adaptador de corriente, o ejecuta caffeinate -di & en una terminal. Para configuraciones siempre activas, los Mac de sobremesa (Mini, Studio, Pro) son preferibles a los portátiles.
¿Pueden varias personas escribir al bot desde distintos Apple ID? Sí. El bridge almacena un historial de conversación independiente por cada remitente. Cada Apple ID o número de teléfono tiene su propia ventana de contexto. Puedes configurar una lista de permitidos (solo determinados remitentes) o dejarlo abierto a todos los iMessages entrantes.
¿Esto infringe las condiciones de servicio de Apple? BlueBubbles se encuentra en una zona gris: Apple no ha aprobado explícitamente los puentes de terceros para iMessage, pero tampoco ha tomado medidas contra BlueBubbles en los más de cuatro años que lleva en funcionamiento. El proyecto lee los mensajes desde tu propio Mac, con tu propio Apple ID, del mismo modo en que podría hacerlo cualquier proceso con Acceso completo al disco. Usarlo para tu propia automatización —no para el envío masivo comercial de mensajes ni para spam— es coherente con el uso que le dan decenas de miles de desarrolladores. El proyecto Hermes Agent incluye la integración con BlueBubbles en su configuración por defecto a partir de 2026.
Reflexión final
De los cuatro canales de mensajería que admite HappyCapy —Telegram, Slack, WhatsApp e iMessage—, iMessage es el más exigente técnicamente de configurar. Requiere un Mac, un servidor BlueBubbles en ejecución y una conexión persistente entre tu hardware y tu sandbox de HappyCapy. Son más piezas móviles que en los demás casos.
Para los usuarios de Apple que ya viven en ese ecosistema, también es el resultado más fluido: un agente de IA completo que responde a través de la app Mensajes que sus contactos usan a diario, sin nuevas apps que instalar ni nuevas cuentas que crear. La arquitectura está probada —la misma pila detrás de las 188.000 estrellas de Hermes Agent— y HappyCapy la envuelve en una skill de un solo clic.
Si tienes un Mac que permanece encendido, la configuración merece los 10 minutos que lleva.
