Una guía de la API REST de Intercom (2025)

Probablemente usas Intercom todos los días para chatear con los clientes, y es genial para eso. Pero, ¿y si pudieras conectarlo con todas las demás herramientas de las que depende tu negocio? Imagina automatizar flujos de trabajo, sincronizar datos de clientes sin problemas y crear experiencias personalizadas sin el pesado trabajo manual. Ese es el verdadero poder que se esconde tras la API REST de Intercom.

Seamos sinceros, el término "API" puede sonar intimidante, especialmente si no tienes un desarrollador a mano. Pero no te preocupes. En esta guía, explicaremos qué es la API REST de Intercom, qué puedes hacer con ella y, lo más importante, cómo puedes obtener todos los beneficios sin necesidad de convertirte en un experto en programación de la noche a la mañana.

¿Qué es la API REST de Intercom?

Entonces, ¿qué es exactamente una API REST? Piensa en ella como un traductor que permite que diferentes programas de software se comuniquen entre sí en línea. La API REST de Intercom, específicamente, es un conjunto de herramientas que permite a tus otras aplicaciones acceder y modificar de forma segura los datos dentro de tu cuenta de Intercom.

En lugar de exportar manualmente una lista de usuarios o actualizar a mano el perfil de un cliente, puedes usar la API para que otra aplicación lo haga por ti automáticamente. Como dice Intercom, su API REST es un "pilar fundamental de la Plataforma Intercom" que puedes usar para extraer, actualizar, crear y eliminar información.

Esto te permite hacer cosas realmente útiles, como:

• Sincronizar conversaciones y datos de clientes con tu CRM.

• Añadir más contexto a los perfiles de los usuarios con información de tu base de datos interna.

• Crear alertas personalizadas para tu equipo de soporte en Slack.

Entendiendo los modelos de datos clave de la API REST de Intercom

Antes de empezar a construir cualquier cosa, es útil saber cómo Intercom organiza su información. Agrupa todo en unas pocas categorías principales. Una vez que te familiarices con ellas, tendrás una idea mucho más clara de lo que realmente puedes hacer con la API.

Contactos: Visitantes, leads y usuarios

Intercom divide a las personas con las que interactúas en tres grupos:

• Visitantes: Personas anónimas que navegan por tu sitio web antes de iniciar un chat.

• Leads: Visitantes que han enviado un mensaje o han respondido a uno. Es en este momento cuando Intercom comienza a guardar un historial de su actividad.

• Usuarios: Leads que se han registrado en tu producto o han iniciado sesión en una cuenta existente.

Conversaciones y mensajes

Esta es la esencia de toda la comunicación en Intercom:

• Mensajes: Cualquier pieza individual de comunicación, ya sea de tu equipo, de un chatbot o de un cliente.

• Conversaciones: El hilo completo de mensajes entre tú y un cliente.

Una vista del mensajero conversacional de Intercom, una parte clave de la API REST de Intercom.

Empresas, atributos y eventos

Estos datos te ayudan a organizar tus contactos y a añadir un contexto importante:

• Empresas: Te permite agrupar contactos por la organización a la que pertenecen.

• Atributos: Son simplemente campos que almacenan detalles sobre un contacto o una empresa, como su nombre, correo electrónico, plan de suscripción o cualquier otro dato personalizado del que quieras hacer seguimiento.

• Eventos: Acciones que realizan tus contactos y que quieres rastrear, como el uso del producto o una actividad específica en el sitio web.

Otros tipos de datos importantes

También te encontrarás con estos objetos para la organización interna del equipo y el seguimiento de problemas:

• Etiquetas y Segmentos: Se utilizan para etiquetar y agrupar contactos para que puedas filtrarlos o enviarles mensajes dirigidos.

• Notas: Comentarios internos que tu equipo puede añadir al perfil de un contacto.

• Tickets: Una forma más formal de rastrear y gestionar solicitudes específicas de los usuarios dentro de Intercom.

Una captura de pantalla de la vista de tickets de Intercom, que se puede gestionar a través de la API REST de Intercom, mostrando los detalles del cliente.

Casos de uso comunes (y limitaciones) de la API REST de Intercom

La API suena genial en teoría, ¿verdad? Puedes construir todo tipo de cosas interesantes para personalizar tu soporte. Pero construir y mantener estas integraciones puede ser un verdadero dolor de cabeza, con muchos costes ocultos y complicaciones.

Sincronización de datos de leads y clientes

Un objetivo común es sincronizar nuevos leads de Intercom con tu CRM, o extraer datos de tus herramientas internas para dar a los agentes más contexto en sus conversaciones. ¿La pega? Tienes que escribir y alojar código personalizado para gestionar todo esto. Y si Intercom o tu CRM actualizan su API, tu integración personalizada podría romperse, dejando tus datos desincronizados en el peor momento posible.

Construcción de chatbots y flujos de trabajo personalizados

Otra idea es construir bots personalizados que hagan más que los nativos de Intercom, como comprobar el estado de un pedido en Shopify o verificar una característica de una cuenta. Este es un proyecto de desarrollo masivo. Tendrías que gestionar el flujo de la conversación, la lógica y las llamadas a otros sistemas, todo ello manteniéndote dentro de los límites de la API de Intercom.

Sinceramente, es un trabajo a tiempo completo. En lugar de construir desde cero, una plataforma como eesel AI te permite crear potentes agentes de IA en minutos. Con integraciones sencillas para herramientas como Intercom y tu propia base de conocimientos, puedes tener un agente autónomo que gestione preguntas complejas sin escribir una sola línea de código. También obtienes un control total sobre la personalidad de la IA y las acciones específicas que puede realizar.

Un ejemplo de un creador de flujos de trabajo visual que simplifica los procesos en comparación con la construcción directa con la API REST de Intercom.

Creación de alertas y gestión de asignaciones de equipo

O tal vez quieras asignar automáticamente conversaciones a los agentes de forma rotativa, o recibir una alerta en Slack cuando un cliente VIP te escriba. Para hacer esto por tu cuenta, necesitarías un desarrollador para construir un servicio que esté siempre escuchando estos eventos. Es otra pieza de tecnología personalizada que tu equipo tiene que construir, supervisar y arreglar cuando se rompa.

Este es otro punto en el que una herramienta de IA dedicada ahorra un montón de esfuerzo. Por ejemplo, la automatización de triaje de eesel AI se conecta directamente a tu helpdesk para automatizar el enrutamiento y el etiquetado, para que tu equipo pueda dejar de organizar colas y empezar a hablar con los clientes.

Cómo empezar con la API REST de Intercom

Vale, has escuchado las advertencias y todavía quieres lanzarte y construir algo por tu cuenta. Es comprensible. Aquí tienes un resumen rápido de cómo es ese proceso.

Autenticación y cómo hacer tu primera llamada

Para empezar con la API, primero necesitas un Token de Acceso de la configuración de desarrollador de Intercom. Este token es simplemente una clave que demuestra que tienes permiso para acceder a los datos de tu espacio de trabajo. Luego, incluyes este token en tus solicitudes. Por ejemplo, podrías usar un simple comando "cURL" para obtener una lista de los administradores de tu espacio de trabajo.

Navegando por los endpoints clave de la API REST de Intercom

La API se divide en diferentes "endpoints", que son simplemente URLs para acceder a diferentes tipos de datos. Los más comunes que usarás son para los modelos de datos de los que hablamos antes:

• "/contacts"

• "/conversations"

• "/companies"

• "/tickets"

• "/messages"

La alternativa más sencilla y sin código a la API REST de Intercom

Construir con la API REST de Intercom te da mucho control, pero es un gran compromiso de tiempo, dinero y horas de desarrollo. Para la mayoría de los equipos de soporte, simplemente no es práctico. Un enfoque mucho más rápido es usar una plataforma que se encargue de todo ese trabajo pesado por ti.

eesel AI está diseñado para ser completamente autoservicio. Puedes conectar Intercom con un solo clic y estar en funcionamiento en minutos, no en meses. Incluso puedes simular la IA en miles de tus tickets pasados para ver una previsión precisa de tu tasa de resolución antes de activarla para los clientes. Se acabó el adivinar.

Precios de Intercom

Hablando de costes, también es importante ver cómo Intercom estructura sus propios precios, especialmente cuando se trata de sus propias funciones de IA. Sus planes principales tienen un precio por agente, pero su agente de IA, Fin, se vende por separado.

Según su página de precios, Fin cuesta 0,99 $ por resolución. Esto significa que, además de lo que pagas por cada agente, se te cobra un extra cada vez que la IA cierra con éxito un ticket. Esto puede hacer que tu factura mensual sea bastante impredecible, ya que cambia según tu volumen de soporte.

Este modelo de pago por uso es bastante común, pero puede ser un verdadero engorro para el presupuesto. En eesel AI, hacemos las cosas de manera diferente. Nuestros precios son claros y predecibles, basados en un número fijo de interacciones de IA cada mes. Obtienes todas nuestras herramientas, el Agente de IA, Copilot y Triage, todo en un plan simple sin cargos sorpresa.

Plan	Precio por puesto/mes (facturado anualmente)	Coste del Agente de IA Fin
Essential	29 $	+ 0,99 $ por resolución
Advanced	85 $	+ 0,99 $ por resolución
Expert	132 $	+ 0,99 $ por resolución

Ve más allá de lo básico de la API REST de Intercom

Entonces, ¿cuál es la conclusión? La API REST de Intercom es una herramienta fantástica que puede ayudarte a crear flujos de trabajo personalizados y a conectar tus datos. Pero intentar construir todo por tu cuenta es un camino largo y costoso, lleno de obstáculos técnicos y mantenimiento continuo.

Las plataformas de IA modernas te ofrecen una forma mucho más rápida y accesible de obtener los mismos resultados, o incluso mejores. En lugar de luchar con el código, puedes usar una herramienta como eesel AI para unificar todas tus fuentes de conocimiento y automatizar el soporte, todo ello manteniendo las herramientas que tu equipo ya adora.

Automatiza tu soporte de Intercom en minutos

¿Listo para ver lo que un agente de IA diseñado específicamente para ello puede hacer por tu equipo de soporte? Conecta tu helpdesk de Intercom con un solo clic y comienza tu prueba gratuita con eesel AI. No se necesita un desarrollador.

Comienza tu prueba gratuita