API de Intercom: conversaciones, contactos y artículos con agentes de IA
Intercom tiene una API REST con versiones que cubre conversaciones, contactos, empresas, tickets y el centro de ayuda. La usan empresas de software y servicios para integrar soporte, producto y CRM. El acceso se hace con el token de una app en el Developer Hub o con OAuth.
Qué ofrece la API de Intercom
Conversaciones
Listar, responder, asignar, cerrar y etiquetar conversaciones.
Contactos y empresas
Crear y actualizar usuarios, leads y empresas con atributos personalizados.
Tickets
Crear y seguir tickets de soporte y sus estados.
Artículos
Leer y publicar artículos del centro de ayuda.
Eventos y etiquetas
Registrar eventos de uso del producto y segmentar contactos.
Webhooks
Recibir eventos de conversaciones y contactos.
Cómo acceder a la API de Intercom
- Con las credenciales de tu empresaToken de acceso de una app creada en el Developer Hub de Intercom para el propio workspace, u OAuth para apps públicas.
- La API se versiona por cabecera; fija la versión que uses.
- Hay límites de solicitudes por app y por workspace.
- Las respuestas al cliente empiezan con aprobación.
Documentación oficial: developers.intercom.com
Qué hace un agente de iTeam con la API de Intercom
Datos del producto en la conversación
Antes de que el agente humano abra el caso, el agente de IA busca el plan, el uso y las facturas y deja una nota en la conversación.
De la conversación a un bug en Jira
El agente resume los reportes de error y los convierte en una issue con un enlace a la conversación.
Atributos siempre actualizados
El agente sincroniza el plan y el estado de pago desde el sistema de facturación al contacto en Intercom.
Artículo a partir de las dudas
Las preguntas que se repiten se convierten en un borrador de artículo para que lo revise el equipo de soporte.
De la credencial al agente trabajando, con aprobación
Crear la app en el Developer Hub
En el Developer Hub de Intercom, crea una app interna para el workspace y copia el token de acceso.
Registrar la credencial en la bóveda de iTeam
La credencial de Intercom queda en la bóveda de iTeam, fuera de prompts y hojas de cálculo. Cada agente recibe solo las acciones que necesita (leer conversaciones, añadir una nota, actualizar un contacto), y lo que escribe datos pasa por aprobación.
Probar con aprobación humana
Antes de habilitarlo, añade una nota en una conversación interna. En las primeras semanas, las acciones de escritura quedan con aprobación y todo queda en la auditoría.
Equipos de IA listos que usan Intercom
Soporte al cliente
Jaca contesta los tickets repetidos con lo que ya está escrito en Confluence, y tu equipo se queda con los casos que piden criterio.
Postventa y customer success
Nina vigila cómo usa cada cliente lo que compró, Jaca lo contacta en el momento justo y Romeo detecta quién está listo para ampliar.
Preguntas sobre la API de Intercom
¿La API de Intercom es gratuita?
La API está disponible para los workspaces de Intercom; el costo es el del plan y el de recursos de pago como Fin.
¿Necesito programar para usar la API de Intercom con iTeam?
No necesariamente. La herramienta HTTP de iTeam aprende los endpoints de la API de Intercom a partir de la documentación, y el equipo de implantación configura credenciales, permisos y el proceso. Tu equipo valida el resultado.
¿Puedo usar el agente de iTeam junto con Fin?
Sí. Fin atiende dentro de Intercom; el agente de iTeam se ocupa de lo que cruza sistemas, como consultar el ERP o abrir un ticket en otra herramienta.
