Instala Intercom en tu app iOS o Android para ver quiénes son tus users y conectarte con ellos en cada punto de contacto:
Involúcralos con mensajes push automatizados.
Bríndales soporte con un Agente AI integrado, Help Center y el Intercom Messenger.
Involucra proactivamente y realiza upselling con Workflows salientes.
Incorpora y nutre a tus users con Carruseles Móviles.
Todo sin que ellos salgan de tu app.
Instalando y configurando Intercom en tu aplicación móvil
Instalar Intercom en tu app móvil toma solo unos minutos con nuestros SDKs nativos para iOS, Android, React Native y Cordova.
Al instalar Intercom en tu app móvil, debes configurar los datos personalizados que quieres rastrear sobre tus users. Esto te permite enviar mensajes y carruseles más dirigidos y personalizados.
Tú o tu desarrollador pueden encontrar instrucciones sobre cómo hacerlo en nuestra documentación para desarrolladores:
Los SDKs son pequeños también, así que no ralentizarán tu app. 👌
Selector de plataforma
Desde la página Channels > Messenger > Install, se te pedirá elegir si quieres instalar el Messenger en un entorno web o móvil.
Elegir Instalar para web mostrará el flujo de instalación para sitios web, elegir Instalar para móvil mostrará el nuevo flujo de instalación para apps móviles. 👇
El estado para móvil mostrará “No instalado” si ni Android ni iOS han sido instalados, o “Instalado de forma segura” si ambos han sido instalados.
Hay tres pasos que debes completar para instalar el Messenger en tus apps móviles.
Instalación inicial del Messenger
Elige la plataforma de instalación de tu preferencia; iOS, Android o React Native. Todas las plataformas elegidas tienen pasos específicos para esa plataforma.
Se te proporcionarán opciones para cómo instalar Intercom en tus apps móviles y algunos fragmentos de código para ayudar con la instalación. Las opciones de fragmentos de código para iOS son:
Swift Package Manager
Cocoapods
Instalación manual
Las opciones de fragmentos de código para Android son:
Groovy
Kotlin
Nota: El interruptor “Habilitar tráfico de usuarios para messenger” es requerido para la instalación móvil del Messenger.
Las opciones de fragmentos de código para React Native son:
Yarn
NPM
Expo
El siguiente paso será "Inicializar Intercom" dentro del código base de tu app móvil. También puedes gestionar tus claves API en este paso. Las opciones de fragmentos de código para iOS son:
Swift
Swift UI
ObjectiveC
Las opciones de fragmentos de código para Android son:
Kotlin
Java
Las opciones para React Native son:
iOS
Android
El botón Verificar instalación al final ofrece una notificación de éxito si el Messenger se ha encontrado correctamente para la instalación elegida, o indica si algo ha salido mal.
Nota: Al conectar tu app móvil con la API del Messenger, asegúrate de que el endpoint coincida con la región de alojamiento de datos de tu espacio de trabajo. Los espacios alojados en EE. UU. deben usar el endpoint estándar de API (sin 'eu' en la URL), mientras que los alojados en la UE deben usar el endpoint de la UE. Usar el endpoint incorrecto resultará en errores 404.
Asegurando tu Messenger con JWTs
Recientemente hemos mejorado la seguridad de nuestro Messenger para usar JSON web tokens en lugar de HMACs. Esta actualización reemplaza el método anterior de Verificación de identidad (IdV) con funciones diseñadas para proteger los datos de los users.
Con JWTs, te beneficias de:
✅ Protección de datos — Firma y protege tanto el ID de user como el correo electrónico, junto con cualquier otro atributo de user.
✅ Tokens de corta duración — Los JWTs pueden configurarse para expirar, reduciendo el riesgo de uso indebido de tokens comprometidos.
Para asegurar tu Messenger con JWTs, elige iOS o Android aquí y sigue las instrucciones.
Nota: para React Native, aún debes usar Verificación de identidad ya que el soporte para JWT no ha sido lanzado aquí.
Asegurando tu Messenger con Verificación de identidad [Obsoleto]
Verificación de identidad en móvil, ve a Configuración > Instalación > Instalar para móvil y elige la plataforma de instalación; iOS, Android o React Native.
Similar al paso de instalación inicial, se te pedirá elegir con qué plataforma deseas instalar el SDK de React Native (iOS o Android).
Se proporcionan fragmentos de código e instrucciones sobre cómo generar un código HMAC (Código de Autenticación de Mensajes basado en Hash) dentro de tu código backend y proporcionarlo al Intercom Messenger. Este código HMAC es usado por Intercom para verificar la autenticidad de las interacciones de los users en el Messenger.
Se proporciona un fragmento de código adicional para que puedas incluir el HMAC al inicializar Intercom dentro de tu app móvil. Las opciones de fragmentos de código para iOS son:
Swift
Swift UI
ObjectiveC
Las opciones de fragmentos de código para Android son:
Kotlin
Java
Para React Native, proporcionamos un ejemplo de fragmento de código sobre cómo usar el código HMAC para inicializar Intercom con verificación de identidad.
El paso final en el proceso de verificación de identidad es hacer cumplir la verificación de identidad. Una vez hecho esto, todas las solicitudes del Messenger que no incluyan el código HMAC válido serán rechazadas.
Nota: Cuando haces cumplir la verificación de identidad para una app iOS o Android, el segundo paso se marca como completado.
⚠️ Cierra las sesiones de tus users al cerrar sesión
Asegúrate de cerrar Intercom para borrar las conversaciones de tus clientes cuando cierren sesión en tu app.
Aquí te mostramos cómo hacerlo en Objective C
- (void)logout { [Intercom logout]; }Aquí te mostramos cómo hacerlo en Java
private void logout() {
Intercom.client().logout();
}Nota: Solo debes cerrar sesión de un user identificado. Cerrar sesión de un user no identificado resultará en registros huérfanos que no podrán fusionarse en el futuro.
Intercom sabe cuándo tu app está en segundo plano y vuelve a activarse, por lo que no necesitarás iniciar sesión de nuevo a tus users.
Opcional: Configurar notificaciones push
En este paso nuevamente tendrás la opción de la plataforma de instalación; iOS o Android. Puedes configurar notificaciones push desde esta sección, pero no te guiará en el proceso. En su lugar, debes usar nuestra documentación para desarrolladores para la configuración de notificaciones push:
Nota: React Native no se ofrece como opción para notificaciones push móviles.
Nota: Este paso opcional se marca como completado cuando se detecta que las notificaciones push están configuradas para una app iOS o Android.
Importante: Xcode 14 ahora es requerido para compilar Intercom iOS SDK v13.0.0+
En Xcode 14, se registran varias advertencias en la consola cuando se instala el SDK. Las advertencias provienen del uso de WKWebView por parte de Intercom. Hay un bug en Xcode 14 que genera estas advertencias, y no es un problema que Intercom pueda solucionar.
Son solo advertencias y Intercom continúa funcionando con normalidad cuando están presentes.
Aquí están los mensajes de advertencia:
WKWebView Error - Ver artículo y ves esto en la consola: Error al adquirir la afirmación: <Error Domain=RBSServiceErrorDomain Code=1 "el objetivo no está en ejecución o no tiene el derecho com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=el objetivo no está en ejecución o no tiene el derecho com.apple.runningboard.assertions.webkit}>Este método no debe llamarse en el hilo principal ya que puede causar falta de respuesta en la interfaz de usuario.[Sandbox] No se pudo habilitar Mach bootstrap, errno = 22.
Integra profundamente tu Help Center en tu app móvil
Incluir tus artículos del Help Center directamente en tu app móvil te ofrece muchas formas flexibles de presentar contenido de ayuda a tus users. Ya sea que uses la UI preconstruida de Intercom o desarrolles tu propia presentación personalizada, puedes brindar a tus clientes exactamente el soporte que necesitan.
Manteniendo seguras las conversaciones de tus users
Para reiterar, recomendamos encarecidamente habilitar la seguridad del Messenger en tu app iOS y/o Android. Esto ayuda a garantizar que las conversaciones entre tú y tus users se mantengan privadas y que un user no pueda hacerse pasar por otro.
Para instrucciones detalladas sobre cómo configurar esto, consulta nuestro documento del Help Center o tus configuraciones de seguridad. Para instrucciones móviles, consulta nuestra documentación para desarrolladores de iOS y Android.