Your AI Connector Docs

iMessage (Beta)

Integra iMessage en tu bandeja de entrada unificada. Conecta un Mac que ejecute BlueBubbles y tus iMessages fluirán hacia la plataforma junto con WhatsApp, SMS, Instagram y Messenger, con el mismo Agente de IA, Difusiones e historial de contactos que ya utilizas en cualquier otro lugar.

Canal Beta. El soporte para iMessage es actualmente solo por invitación mientras pulimos la experiencia. Contacta con soporte para habilitarlo en tu cuenta. La funcionalidad, los límites y el comportamiento pueden cambiar a medida que el canal madure.

Información general

Apple no ofrece una API oficial de iMessage, un conjunto de reglas que permitiría a otras aplicaciones conectarse directamente a iMessage. En su lugar, esta integración se conecta a través de una aplicación puente de código abierto llamada BlueBubbles, que ejecutas en un Mac que haya iniciado sesión en tu cuenta de iMessage. Una vez conectado, la plataforma:

  • Recibe los iMessages entrantes como nuevas conversaciones en Chats.
  • Envía respuestas salientes a través de tu Mac, por lo que aparecen a los destinatarios como un iMessage normal de burbuja azul desde tu Apple ID.
  • Permite que tu Agente de IA, etiquetas y registros de contactos funcionen exactamente igual que en cualquier otro canal.

La configuración toma alrededor de 10 minutos una vez que tienes BlueBubbles instalado.

Lo que necesitas

Para conectar iMessage, necesitarás todo lo siguiente:

  • Un Mac (portátil o de escritorio) con sesión iniciada en tu Apple ID y con iMessage habilitado en la aplicación Mensajes.
  • El Mac debe permanecer encendido y conectado. Si tu Mac entra en reposo, se reinicia o pierde la conexión a internet, los iMessages dejarán de llegar hasta que vuelva a estar en línea.
  • BlueBubbles Server instalado en ese Mac: una aplicación gratuita de código abierto disponible en bluebubbles.app.
  • Una forma de exponer tu Mac a internet: normalmente un túnel como Cloudflare Tunnel, ngrok o Tailscale. El asistente de configuración de BlueBubbles te guiará a través de esto.
  • Un plan de pago: iMessage está incluido como parte de tu asignación de canales en todos los planes actuales.

Configuración de BlueBubbles

BlueBubbles es una aplicación independiente de terceros que instalas en tu propio Mac. Nosotros no la alojamos; se ejecuta localmente en tu máquina.

  1. Descarga e instala BlueBubbles Server desde bluebubbles.app.
  2. Concede los permisos que solicita el instalador (Accesibilidad, Acceso total al disco, Automatización). Estos permiten a BlueBubbles leer los mensajes entrantes y activar la aplicación Mensajes para enviar los salientes.
  3. Abre BlueBubbles → Settings → API & Webhooks.
  4. Establece una server password.
  5. Copia tu server URL (una dirección pública que apunta a tu Mac).
  6. Verifica en BlueBubbles que los mensajes de prueba entrantes y salientes funcionan localmente antes de continuar.

Las instrucciones completas de configuración, solución de problemas y guías específicas de la plataforma se encuentran en la documentación oficial de BlueBubbles. Si te quedas atascado en BlueBubbles, su documentación y comunidad son el camino más rápido.

Conexión de BlueBubbles a la plataforma

Una vez que BlueBubbles esté ejecutándose en tu Mac:

  1. En la barra lateral izquierda, haz clic en Settings (Configuración) cerca de la parte inferior.
  2. En la barra lateral de Settings, bajo Channels (Canales), haz clic en Channels.
  3. Busca la tarjeta iMessage y haz clic en Connect (Conectar). (El botón Connect solo se vuelve clicable una vez que iMessage se ha habilitado para tu cuenta; hasta entonces, aparece en gris y la tarjeta muestra la nota “iMessage is in private beta and isn’t enabled on your account yet.”)
  1. Pega la Server URL (URL del servidor) de BlueBubbles (p. ej., https://your-tunnel.example.com).
  2. Pega la server password (contraseña del servidor) de BlueBubbles.
  3. Haz clic en Connect.

Verificamos la conexión contactando con tu servidor BlueBubbles y configuramos el webhook automáticamente (un webhook es una dirección web que permite a BlueBubbles informar automáticamente a la plataforma en el momento en que llega un nuevo mensaje). Si todo es correcto, el estado cambia a Connected.

  1. En BlueBubbles, abre Settings → API & Webhooks → Webhooks y confirma (o pega) la URL del webhook que se muestra en la página de configuración de iMessage.
  2. Guarda.

Eso es todo: los iMessages entrantes llegarán ahora a tu bandeja de entrada en tiempo real.

Probar la conexión

Desde la página de configuración de iMessage, puedes enviar un iMessage de prueba a cualquier número de teléfono para confirmar que todo está configurado correctamente. Introduce el número de teléfono del destinatario en formato E.164 (ej. +14155551234) junto con un mensaje corto y envía la prueba.

El primer envío de prueba puede tardar hasta un minuto, ya que es posible que la aplicación Messages en tu Mac necesite iniciar un nuevo hilo de conversación. Los envíos posteriores son casi instantáneos.

Cómo fluyen los mensajes

Entrantes

  1. Alguien envía un iMessage a tu Apple ID.
  2. La aplicación Mensajes en tu Mac lo recibe (como de costumbre).
  3. BlueBubbles detecta el nuevo mensaje y lo envía mediante POST a la URL del webhook.
  4. La plataforma crea un contacto (si es nuevo), coloca el mensaje en Chats y, si tu Agente de IA para este canal está activo, responde.

Salientes

  1. Tú o la IA envían una respuesta desde la plataforma.
  2. Enviamos el mensaje a tu servidor BlueBubbles.
  3. BlueBubbles le dice a la aplicación Mensajes en tu Mac que envíe el iMessage.
  4. El destinatario ve un iMessage normal de burbuja azul desde tu Apple ID.

Tipos de mensajes admitidos

  • Mensajes de texto: totalmente compatibles en ambas direcciones.
  • Archivos adjuntos y multimedia: los archivos adjuntos entrantes son visibles en BlueBubbles, pero aún no se integran en la plataforma durante la fase Beta. Los mensajes salientes deben contener texto; el envío de imágenes o archivos a través de iMessage aún no está disponible.

Límites de envío, calentamiento y controles de seguimiento

iMessage tiene el mismo tipo de límites de envío protectores, calentamiento automático e interruptor de apagado para seguimientos que WhatsApp Web y Telegram, con una diferencia que vale la pena conocer: en iMessage, los seguimientos automatizados están activados de forma predeterminada en una cuenta recién conectada, así que desactívelos usted mismo si desea que la cuenta permanezca inactiva mientras se calienta. Apple marca agresivamente las cuentas que se comportan como remitentes masivos, por lo que estas medidas de seguridad existen para mantener su Apple ID a salvo. Encontrará una tarjeta de Límites de envío y calentamiento y un interruptor de Seguimientos automatizados en la página de configuración de iMessage una vez que esté conectado.

Calentamiento automático (rampa)

Una cuenta de iMessage recién conectada se limita intencionalmente y desbloquea más capacidad con el tiempo. Obtiene un “día de calificación” solo en los días en que realmente envía al menos el 75% de su límite actual; los días de inactividad no cuentan.

  • Límite diario de mensajes = 50 + 8 × (day − 1), limitado a 500/día (alcanzado en el día 58).
  • Límite diario de nuevos contactos = floor((day − 1) × 5 / 6), limitado a 50/día (alcanzado en el día 61).

La página de configuración muestra el día actual de la rampa, el uso de hoy frente al límite y cuánto falta para completarlo. Si tu Apple ID ya tiene un largo historial genuino de iMessage, puedes mover el control deslizante del día de rampa hacia adelante, pero hazlo solo de manera honesta, para una cuenta que realmente tenga ese historial.

Anulación manual más allá de la rampa

Después de la rampa completa de 58 días, una anulación opcional te permite aumentar el límite diario de mensajes por encima de 500 (de 750 hasta 5,000, en incrementos de 250 mensajes). Sé conservador: Apple no publica un número seguro y enviar demasiados mensajes pone en riesgo tu Apple ID. La anulación solo está disponible una vez que la cuenta ha completado la rampa.

Activación/desactivación de límites de envío y botón de interrupción de seguimiento

Un interruptor maestro activa o desactiva los límites de envío, y un límite diario de contactos nuevos le permite establecer un tope para los primeros contactos más bajo de lo que permitiría el aumento gradual. El interruptor de Seguimientos automatizados detiene todos los seguimientos automatizados para la cuenta, independientemente de la configuración de difusión/campaña. En iMessage, este interruptor comienza activado, por lo que una cuenta recién conectada enviará seguimientos automatizados hasta que usted lo desactive; se recomienda desactivarlo mientras la cuenta sea nueva (menos de ~30 días de aumento gradual). Cuando se alcanza el límite diario, los seguimientos programados se trasladan al día siguiente en lugar de fallar.

Limitaciones de la Beta de iMessage

Debido a que iMessage no cuenta con una API oficial, este canal conlleva limitaciones que no encontrará en WhatsApp, SMS o Instagram. Por favor, revíselas detenidamente antes de depender de iMessage para comunicaciones críticas para su negocio.

  • Tu Mac debe permanecer encendido y conectado. Sin Mac, no hay iMessages. Recomendamos desactivar el reposo en el Mac que ejecuta BlueBubbles, o utilizar un Mac mini dedicado para esto.
  • Solo conversaciones uno a uno con número de teléfono. Los chats grupales y los identificadores de Apple ID (correo electrónico) no son compatibles oficialmente durante la Beta y pueden comportarse de forma inesperada si llegan a la plataforma; utiliza solo conversaciones de iMessage uno a uno con número de teléfono.
  • Solo texto. Los mensajes que solo contienen archivos adjuntos (foto, video, archivo) se omiten en la entrada, y los envíos salientes deben contener texto. El envío de archivos multimedia se añadirá más adelante en la Beta.
  • Sin plantillas ni mensajes preaprobados. Todos los mensajes son texto de formato libre.
  • Sin confirmaciones de entrega o lectura en la interfaz de usuario de la plataforma. Seguirás viéndolas en la aplicación Mensajes de tu Mac.
  • Un estado “Enviado” significa entregado a la cola, no recibido. Un estado “Enviado” significa que la plataforma entregó el mensaje a tu Mac, no que el destinatario lo recibió. Debido a que iMessage no tiene una confirmación de entrega fiable, algunos envíos se marcan como “Enviado” de forma optimista incluso cuando tu Mac no pudo confirmar la entrega (por ejemplo, si el destinatario no usa iMessage). Para estar seguro de que un mensaje llegó, revisa la aplicación Mensajes en tu Mac.
  • Los indicadores de escritura requieren la API privada de BlueBubbles. Cuando la IA está redactando una respuesta, tu contacto ve una burbuja de “escribiendo…”, pero solo si has habilitado las funciones de Private API en BlueBubbles (Settings → Private API). Sin ella, las respuestas se envían normalmente; el contacto simplemente no verá la burbuja de escritura primero.
  • El primer mensaje saliente a un nuevo contacto puede ser lento. Iniciar una conversación totalmente nueva puede tardar entre 30 y 60 segundos mientras macOS abre el hilo; los mensajes posteriores son rápidos.
  • Sin envíos masivos / de difusión. Durante la Beta, iMessage se utiliza mejor para conversaciones entrantes y respuestas uno a uno, no para difusiones salientes de alto volumen. Apple limita y marca agresivamente el tráfico automatizado de iMessage.
  • Riesgo de cuenta. Apple no sanciona oficialmente la automatización de iMessage de terceros. El uso excesivo o de spam de la automatización de iMessage puede provocar que tu Apple ID sea marcado o restringido por Apple. Utiliza el canal de forma responsable.

Solución de problemas

“No se pudo contactar con el servidor de BlueBubbles”

  • Confirme que BlueBubbles se está ejecutando en su Mac y que aparece el indicador verde de Servidor en ejecución.
  • Confirme que su túnel (Cloudflare / ngrok / Tailscale) está activo y que la URL que pegó es accesible desde la internet pública; ábrala en un navegador y debería ver una página de bienvenida de BlueBubbles.
  • Verifique dos veces que la contraseña del servidor coincida con la establecida en BlueBubbles → Settings → API.

Los mensajes entrantes no aparecen en la bandeja de entrada

  • Abre BlueBubbles → Settings → API & Webhooks → Webhooks y confirma que la URL del webhook que te mostramos esté guardada exactamente como se muestra.
  • Desde la página de configuración de iMessage, usa Refresh status para verificar que la conexión sigue siendo saludable.
  • Asegúrate de que el número del remitente sea un número de teléfono, no una dirección de correo electrónico (los identificadores de correo electrónico no son compatibles en la Beta).
  • Confirma que tu Mac tiene conexión a internet y está encendido.

Error al enviar mensajes salientes

  • Pruebe con el mismo destinatario directamente desde la aplicación Mensajes en su Mac. Si la aplicación Mensajes tampoco puede enviarlo (por ejemplo, el destinatario no usa iMessage), la plataforma tampoco podrá.
  • Asegúrese de que su Mac no esté en reposo, bloqueada con FileVault o mostrando un cuadro de diálogo de actualización del sistema; estos bloquean la automatización de AppleScript, de la cual depende BlueBubbles.
  • Confirme que tiene suficientes créditos en su cuenta.

El estado muestra “Conectado” pero nada funciona

  • Utilice Actualizar estado en la página de configuración de iMessage para volver a verificar la conexión.
  • Si sigue fallando, desconéctese y vuelva a conectarse con una URL de servidor y una contraseña nuevas.

Mi Mac se reinició / perdió la conexión a internet

Cuando su Mac vuelve a estar en línea y BlueBubbles se reinicia, la conexión se reanuda automáticamente. Cualquier mensaje enviado mientras la Mac estaba desconectada aparecerá en la aplicación Mensajes una vez que se vuelva a conectar, pero es posible que no todos se reproduzcan en la plataforma; iMessage no expone una API de relleno fiable.

¿Necesita ayuda?

iMessage se encuentra actualmente en Beta. Si encuentra problemas que no hemos cubierto anteriormente, comuníquese con hi@youraiconnector.com con:

  • La URL del servidor al que se conectó (sin la contraseña).
  • Una descripción del problema y cualquier mensaje de error de la página de configuración de iMessage.
  • La hora en que ocurrió el problema.

Le echaremos un vistazo tan pronto como podamos.