Antes de empezar
Intercom es más que una simple caja de chat. Es una plataforma de soporte al cliente que te permite:- Mostrar un widget de chat dentro de tu aplicación para que los usuarios puedan hacer preguntas al instante.
- Responder desde una consola centralizada donde trabaja todo tu equipo de soporte.
- Automatizar mensajes, enviar recorridos guiados e incluso integrar otros canales como email, WhatsApp o Slack.
Paso 1: Abre el CMS y ve a Intercom
Inicia sesión en tu CMS aquí: ve a CMS.En el menú de la izquierda, haz clic en Integrations y luego selecciona Intercom.
Aparecerá un panel solicitando un valor llamado app_id. Este es el identificador único de tu proyecto en Intercom y es lo que vincula tu aplicación con tu cuenta de Intercom.
Paso 2: Encuentra tu App ID en Intercom
Para obtener tu App ID: Inicia sesión en Intercom.Ve a Settings > Messenger > Install.
Ahí verás un fragmento de código como este: El valor que necesitas es el que aparece en app_id; sustituye YOUR_APP_ID por tu App ID real de Intercom.
Paso 3: Añade el App ID en el CMS
De vuelta en el CMS, en la sección de Intercom: Haz clic en Add API Key.Deja el nombre de la key como app_id.
Pega tu App ID de Intercom en Key Value.
Márcalo como Active y guarda los cambios.
Ahora tu app “sabe” con qué cuenta de Intercom debe conectarse.
Paso 4: Comparte el fragmento de código con tu desarrollador
Aquí es donde entra tu desarrollador. Añadir el App ID en el CMS no hará que el chat aparezca por sí solo. El fragmento de código que viste en Intercom debe insertarse en el frontend de tu app. ¿Dónde se añade? En una app React, normalmente tu desarrollador lo colocaría en el archivo principal de layout.En un sitio web estático, podría añadirse en el head o justo antes de la etiqueta body de cierre. ¿Por qué el desarrollador? Porque el snippet también puede personalizarse con datos de tus usuarios: nombre, email, fecha de registro. De ese modo, cuando alguien abre el chat, tu equipo de soporte ya sabe con quién está hablando, haciendo las conversaciones más rápidas y personales.
Paso 5: Prueba el chat
Una vez que tu desarrollador haya añadido el código: Inicia sesión en tu aplicación como un usuario normal.Deberías ver el icono de Intercom en la esquina inferior derecha.
Ábrelo y envía un mensaje de prueba.
Tu equipo de soporte debería ver ese mensaje inmediatamente dentro de la consola de Intercom.
Errores comunes que debes evitar
Olvidar activar el App ID en el CMS → aunque el código esté instalado, sin un App ID activo el chat no se conectará.Usar el App ID incorrecto → cada proyecto de Intercom tiene su propio ID; asegúrate de copiar el correcto.
No probar con un usuario real → prueba siempre como usuario estándar, no solo como admin.
No compartir el snippet con tu desarrollador → recuerda: se requieren ambos pasos, CMS + código en el frontend.

