Intercom
En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.
Descripción General
Conecta tu cuenta de Intercom a Nirvai para automatizar conversaciones con clientes, gestionar contactos e integrar flujos de trabajo de soporte.
Métodos de Autenticación Soportados
- Access Token - Desde una App de Desarrollador de Intercom
Requisitos Previos
- Una cuenta de Intercom con acceso de Admin
- Acceso al Intercom Developer Hub
Instrucciones de Configuración
Access Token (Developer App)
- Ve al Intercom Developer Hub
- Haz clic en Your apps en la navegación superior
- Haz clic en New app (o selecciona una app existente)
- Ingresa un nombre de app (ej., "Integración Nirvai")
- Selecciona Internal integration (para tu propio workspace)
- Haz clic en Create app
- En la configuración de la app, ve a Authentication
- Tu Access Token se genera automáticamente
- Copia el access token
- Pega el token en Nirvai
Permisos del Access Token
Al crear tu app, puedes configurar a qué datos puede acceder:
- Ve a tu app en Developer Hub
- Navega a Authentication
- Desplázate hasta Permissions
- Habilita los permisos requeridos para tu caso de uso
Permisos Requeridos
| Permiso | Descripción | Requerido Para |
|---|---|---|
| Read one admin | Acceder a info de admin | Operaciones de admin |
| Read all users/leads | Leer datos de contactos | Gestión de contactos |
| Write all users/leads | Crear/actualizar contactos | Sincronización de contactos |
| Read conversations | Acceder a conversaciones | Datos de conversaciones |
| Write conversations | Enviar mensajes | Automatización de mensajería |
| Read tags | Acceder a etiquetas | Gestión de etiquetas |
| Write tags | Crear etiquetas | Automatización de etiquetado |
Operaciones Disponibles
Con credenciales de Intercom, puedes:
- Gestionar contactos (usuarios y leads)
- Acceder y responder a conversaciones
- Crear y gestionar etiquetas
- Enviar mensajes y notificaciones
- Acceder a datos de visitantes
- Gestionar atributos personalizados
- Trabajar con empresas/organizaciones
Solución de Problemas
Problemas Comunes
- 401 Unauthorized: El token es inválido o fue revocado. Genera un nuevo token de app.
- 403 Forbidden: La app carece de permisos requeridos. Actualiza los permisos de la app.
- Rate Limiting: Intercom tiene límites de tasa estrictos. Implementa estrategias de backoff.
- Acceso al Workspace: Asegúrate de que la app esté instalada en el workspace correcto.
Tipos de Token
Intercom tiene diferentes tipos de token:
- Access Token: Para acceso API del lado del servidor (usa este en Nirvai)
- Client ID/Secret: Para flujos OAuth (no necesario para Nirvai)
Encontrar IDs de Contactos
Intercom usa diferentes tipos de ID:
id: ID interno de Intercomuser_id: Tu identificador de usuario personalizadoemail: Dirección de email del usuario
Puedes buscar por cualquiera de estos.
Versionado de API
Intercom usa versionado de API. La integración usa la última versión estable. Si encuentras problemas, verifica el changelog de API.
Recursos Relacionados
Adaptado de la documentación de n8n para la plataforma Nirvai
Siguientes Pasos
Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.