Usa este artículo para instalar Intercom Messenger en tu aplicación móvil, autenticar a tus users de forma segura y confirmar que todo funciona antes de lanzar.
Los pasos para una instalación completa y segura de Messenger son:
Elige tu tipo de instalación.
Instala e inicializa el SDK.
Autentica a los users que hayan iniciado sesión.
Prueba tu instalación.
Nota:
Esta es la nueva experiencia de instalación de Messenger, que se implementa gradualmente. Si tu espacio de trabajo aún no ha sido cambiado, usa Instalar y usar Intercom en tu aplicación móvil en su lugar.
Necesitarás un plan contratado o mensual para instalar Messenger y acceso al código de tu app (o un desarrollador que lo tenga). Messenger soporta iOS, Android y React Native.
Elige tu tipo de instalación
Ve a Configuración > Canales > Messenger Live Chat > Resumen , encuentra la tarjeta Mobile app y selecciona Instalar en la aplicación móvil.
Selecciona tu tipo de instalación
Se te preguntará "¿Qué información necesita tu equipo en tu inbox?" y se mostrarán dos opciones:
Users no autenticados (la instalación más rápida) — Las conversaciones no están vinculadas a detalles de users. Puedes completar la configuración adicional más tarde para identificar users autenticados.
Users autenticados y users no autenticados — Las conversaciones de users autenticados incluyen detalles relevantes, dando a tu equipo el contexto necesario para brindar soporte personalizado. Requiere cambios en la app y backend.
Selecciona la opción que se ajuste a tu negocio, luego haz clic en Continuar para avanzar a los pasos de instalación a continuación.
Instala e inicializa el SDK
Esta sección cubre los pasos 1 a 3 de la instalación. Solo toma unos minutos y aplica tanto si identificas users autenticados como si no.
1. Elige tu plataforma
Usa el menú desplegable Mobile app platform para elegir en qué plataforma estás instalando: iOS, Android o React Native. Los pasos a continuación usan iOS como ejemplo; el flujo es similar para otras plataformas, con código específico para cada una.
2. Agrega la dependencia del SDK
Elige tu método de instalación en el menú desplegable (para iOS, incluye Swift Package Manager y CocoaPods). Para Swift Package Manager:
En Xcode, navega a Archivo > Agregar paquetes.
Cuando se te pida, ingresa la URL del repositorio del Intercom iOS SDK (kit de desarrollo de software):
.package(url: "https://github.com/intercom/intercom-ios", from: "18.0.0")
Selecciona la versión de Intercom que deseas usar. Recomendamos usar la versión más reciente.
Haz clic en Agregar paquete y Intercom se descargará automáticamente como dependencia para tu proyecto.
3. Inicializa Intercom
Verás tu clave API específica para la plataforma en este paso — por ejemplo, tu Clave API de iOS. Haz clic en Copiar código para obtenerla, o en Regenerar clave API si necesitas una nueva.
Llama lo siguiente en el método delegado de tu aplicación:
import UIKit
import Intercom
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions
launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Intercom.setApiKey("YOUR_IOS_API_KEY", forAppId: "YOUR_APP_ID")
Intercom.setLauncherVisible(true)
// If you have identifying information for your user you can use
// `Intercom.loginUser(with:completion:)`
Intercom.loginUnidentifiedUser()
return true
}
}Autentica a los users que hayan iniciado sesión
Esta sección cubre los pasos 4 a 7 y requiere cambios tanto en tu app móvil como en tu backend.
4. Elige el lenguaje de tu backend
Usa el menú desplegable para elegir el lenguaje en que está escrito tu backend (por ejemplo, Node).
Consejo: Este paso necesita que alguien genere tokens del lado del servidor. Si no eres tú, haz clic en Invitar a un desarrollador para que un compañero te ayude a terminarlo.
5. Genera un token para cada cliente
En tu servidor, genera un JSON Web Token (JWT) firmado para cada user conectado:
const jwt = require('jsonwebtoken');
const token = jwt.sign(
{ user_id: user.id, email: user.email },
process.env.INTERCOM_SECRET_KEY,
{ algorithm: 'HS256', expiresIn: '1h' },
);
Necesitarás la clave secreta de tu espacio de trabajo para esto — se muestra (enmascarada) en este paso. Mantén esta clave en tu servidor. Nunca la incluyas en el código del navegador o de la app.
Nota: Las claves están limitadas a plataformas, y tu espacio de trabajo puede tener más de una. Puedes crear, rotar o decodificar una clave desde la configuración de seguridad de Messenger.
6. Configura el JWT en tu app móvil
Pasa el token que generó tu servidor en la llamada de inicialización de Intercom existente, junto con tu app_id:
Intercom({
app_id: 'your_app_id',
intercom_user_jwt: user.jwt,
});
7. Identifica a los users
Una vez que el JWT esté conectado, identifica al user conectado con:
Intercom.loginUser(
ICPRegistrationOptions.create(userJwt: user.jwt)
) { result in }Importante: Las versiones antiguas de la app no enviarán tokens firmados. Si tu app ya está en vivo, los datos de los clientes no se conectarán hasta que tus users actualicen la app. Recomendamos una actualización forzada para que todos usen una versión que envíe el JWT.
Prueba tu instalación
Una vez que completes los pasos anteriores, haz clic en Prueba tu instalación. Esto confirma que Messenger y (si aplica) tu configuración JWT funcionan correctamente antes de lanzar a tus users.
Si algo no funciona, verifica:
Que el app_id en tu llamada de inicialización coincida con tu espacio de trabajo.
Que tu clave secreta no haya sido rotada o revocada desde que generaste tu último token.
Que el user_id que pasas al SDK coincida con el que está codificado en la carga útil del JWT.
Una vez que todo esté correcto, estás en vivo. Puedes verificar el estado de la instalación en cualquier momento desde Configuración > Canales > Messenger Live Chat > Resumen, bajo Lugares de instalación.
Nota: La duración de la sesión es configurable desde Configuración > Canales > Messenger Live Chat > Seguridad, bajo Duración de la sesión. Se pide a los clientes que se reautentiquen una vez que ese período expire.
💡 Consejo: ¿Necesitas más ayuda? Obtén soporte en nuestro Foro de la Comunidad. Encuentra respuestas y ayuda de Soporte Intercom y Expertos de la Comunidad.