Cómo conectar HappyCapy a iMessage: un agente de IA completo en Apple Messages
BlueBubbles + capy-bridge de HappyCapy: el mismo stack que usa Hermes Agent, ahora disponible como skill de un solo clic.
Apple nunca ha lanzado una API de iMessage. Ni en 2015. Ni en 2020. Ni hoy. Durante años, construir un agente de IA que viva en tus iMessages requería un jailbreak, un plan empresarial de $200 al mes, o un profundo conocimiento de protocolos no documentados. En junio de 2026, finalmente funciona de manera confiable 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 de Business en 2018. iMessage no ha tenido nada de esto, y eso no es un descuido.
El protocolo de iMessage de Apple utiliza cifrado de extremo a extremo vinculado directamente a los Apple ID y a claves específicas de cada dispositivo. Esas claves se generan en hardware de Apple y nunca salen de él. Cada mensaje se cifra y descifra en un dispositivo físico de Apple. No existe una API del lado del servidor porque no hay ningún servidor que tenga el contenido descifrado. Esta es una restricción criptográfica rigurosa, no una decisión de política que Apple pudiera revertir con un comunicado de prensa.
La consecuencia práctica: ningún proceso de Linux, ningún contenedor de 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 una Mac en el proceso. Esa es la respuesta honesta, y define 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 Messages. No hay que instalar ninguna app de terceros. No hay que crear ninguna cuenta nueva. La IA responde a través de la misma interfaz que tu familia y colegas ya usan. Cuando tus contactos te escriben, no se dan cuenta de que algo cambió: ven respuestas desde tu Apple ID, con el formato de iMessages nativos, con confirmaciones de lectura.
Esa combinación —fricción cero para el destinatario, privacidad criptográfica, y en la plataforma en la que los usuarios de Apple ya confían— es la razón por la que iMessage vale la complejidad adicional.
Cómo funciona realmente
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 un puente entre el protocolo de iMessage (que requiere macOS) y cualquier servicio externo que pueda 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é sucede |
|---|---|
| 1. Se recibe el iMessage | Apple entrega el mensaje a tu Mac a través del protocolo estándar de iMessage |
| 2. BlueBubbles lo intercepta | El servidor de BlueBubbles en tu Mac lee el mensaje entrante |
| 3. Webhook POST | BlueBubbles envía un POST con el payload del mensaje al endpoint del capy-bridge de HappyCapy |
| 4. El bridge procesa | capy-bridge analiza el remitente, el texto del mensaje y el historial de la conversación |
5. claude --print | El bridge inicia el CLI de Claude Code con acceso completo a herramientas |
| 6. Claude ejecuta | Claude ejecuta herramientas: bash, búsqueda web, operaciones de archivos, cualquier Skill instalado |
| 7. Se envía la respuesta | La respuesta se envía de vuelta a través de la API REST de BlueBubbles al hilo original de iMessage |
| 8. Se entrega el iMessage | El destinatario ve una respuesta en su Messages.app 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. La arquitectura ha sido puesta a prueba a gran escala.
El detalle clave en el 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/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 solo responde: actúa.
Qué puedes hacer
Una vez que el bridge está en funcionamiento, cada iMessage enviado 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 — pídele 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 Messages.app
- 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: todo lo que envíe iMessages llega al bot
Ventajas
- Experiencia nativa de Apple — las respuestas aparecen en el hilo estándar de Messages.app; los destinatarios no necesitan instalar nada
- Sin apps de terceros en el dispositivo del destinatario — el bot se comunica a través de la infraestructura de iMessage existente
- Funciona con cualquier Apple ID — cualquier contacto que pueda enviarte un iMessage 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 tarifas 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 --printle da al bot acceso a bash, búsqueda web, operaciones de archivos y más de 300,000 Skills
Casos de uso reales
Desarrollador en el iPhone. Estás lejos de tu laptop y necesitas verificar si un cron job se ejecutó, revisar un archivo de registro (log) o reiniciar un servicio en tu sandbox de HappyCapy. Envías el comando desde Messages.app en tu iPhone. El bridge lo ejecuta y devuelve la salida como respuesta. Sin cliente SSH, sin VPN, sin cambiar de contexto.
Hogar exclusivamente Apple. Tu pareja, tus padres o tus compañeros de casa usan solo iMessages y nada más. En lugar de pedirles que instalen Telegram o aprendan una nueva interfaz, apuntas el bot a tu Apple ID existente. Todos interactúan a través de la app que ya tienen en su dispositivo.
Dueño de negocio con clientes en iMessage. Te comunicas con tus clientes por iMessage: es lo que ellos usan, y cambiarlos a otra plataforma no es realista. Con el bridge en funcionamiento, puedes pedirle al agente que resuma un hilo largo, redacte una respuesta con tu tono, busque el historial de pedidos de un cliente, o genere un informe. La IA permanece en el canal donde ya existe la relación.
Investigador con una Mac. Mantienes una Mac encendida en tu escritorio. Quieres un agente de IA siempre accesible: desde tu iPhone durante el traslado, desde tu iPad en una reunión, desde la Mac de un colega en una emergencia. iMessage ya está sincronizado en todos los dispositivos Apple que posees. El bot hereda ese alcance automáticamente.
El requisito de la Mac: una evaluación honesta
La configuración requiere una Mac con BlueBubbles instalado y en ejecución, conectada a HappyCapy a través de capy-bridge. La Mac debe estar despierta y en línea para que el bridge funcione. Si entra en reposo, el bot queda desconectado.
Esta es una restricción real. Si no tienes una Mac, o si tu Mac es una laptop que llevas contigo y cierras con frecuencia, iMessage es el canal equivocado para ti. Las integraciones de HappyCapy con Telegram y Slack funcionan sobre infraestructura completamente nativa de Linux, sin dependencia de hardware.
Para quienes ya tienen una Mac que permanece encendida —una Mac Mini debajo del televisor, una Mac Studio en una oficina en casa, una MacBook antigua conectada en un estante—, la configuración es única y luego totalmente automática. BlueBubbles se inicia al ingresar a la sesión. El demonio de capy-bridge se inicia al ingresar a la sesión. La Mac sigue funcionando, y también el bot.
Si estás considerando hardware dedicado para este propósito, el modelo base de la Mac Mini M4 de 2026 ($799) es la opción más práctica. Usa aproximadamente 6–10 vatios en reposo, admite operación 24/7 sin ruido de ventilador, y cabe en un espacio más pequeño 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 toma 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 otorga los permisos de Accesibilidad y Acceso total al disco
- Anota tu URL y contraseña de BlueBubbles desde la pantalla de configuración de BlueBubbles
- Instala capy-bridge — ejecuta
bash /app/export-port.sh 8766en HappyCapy para obtener tu URL de webhook, y luego ejecuta el skill/happycapy-imessageen HappyCapy - Completa el asistente de HappyCapy — pega tu URL de BlueBubbles, contraseña y URL de webhook; el bridge se registra automáticamente
- Prueba — envía un iMessage desde otro dispositivo; deberías recibir una respuesta en segundos
La documentación completa del skill y el código fuente están en github.com/ndpvt-web/happycapy-imessage.
Preguntas frecuentes
¿Necesito mantener mi Mac encendida todo el tiempo? Sí, para disponibilidad 24/7. La Mac debe estar despierta y en línea para que BlueBubbles y el capy-bridge reciban los mensajes entrantes. Si quieres que el bot esté disponible en todo momento, usa hardware que pueda permanecer encendido: una Mac Mini o una Mac Studio son ideales. Activa "Prevent display sleep" en la configuración de BlueBubbles y desactiva el reposo en macOS Energy Saver (modo Power Adapter).
¿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 Personal Hotspot configurado para habilitar el reenvío de SMS. Para la mayoría de las configuraciones, usar solo iMessage es más simple y confiable.
¿Puede Apple ver mis mensajes a través de BlueBubbles? No. BlueBubbles no rompe el cifrado de extremo a extremo de Apple. Los mensajes son descifrados por macOS en tu máquina local, como siempre ha sido, 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 Messages.app normalmente.
¿BlueBubbles es gratuito? Sí. BlueBubbles tiene licencia MIT y es gratuito de usar. No hay tarifas 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é pasa si mi Mac entra en reposo?
El bridge queda desconectado. Los mensajes enviados mientras la Mac está en reposo no se procesan y no se responden de forma retroactiva cuando la Mac despierta. Para evitar esto: activa "Prevent display sleep" en BlueBubbles, desactiva el reposo del sistema en macOS Energy Saver para el uso con adaptador de corriente, o ejecuta caffeinate -di & en una terminal. Para configuraciones siempre activas, las Mac de escritorio (Mini, Studio, Pro) son preferibles a las laptops.
¿Pueden varias personas escribirle al bot desde distintos Apple ID? Sí. El bridge almacena un historial de conversación separado 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 remitentes específicos) o dejarlo abierto a todos los iMessages entrantes.
¿Esto viola los términos de servicio de Apple? BlueBubbles se encuentra en una zona gris: Apple no ha aprobado explícitamente los puentes de iMessage de terceros, 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 propia Mac, bajo tu propio Apple ID, de la misma manera en que cualquier proceso con Acceso total al disco podría hacerlo. Usarlo para tu propia automatización —no para mensajería masiva comercial o spam— es consistente con la forma en que decenas de miles de desarrolladores lo utilizan. El proyecto Hermes Agent incluye la integración con BlueBubbles en su configuración predeterminada a partir de 2026.
Reflexiones finales
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 una Mac, un servidor de 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.
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 Messages que sus contactos usan todos los días, 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 un skill de un solo clic.
Si tienes una Mac que permanece encendida, la configuración vale los 10 minutos.
