Atención al cliente
Intercom en tu producto y en tus agentes de IA, con una API
El toolkit de Intercom cubre contactos (usuarios y leads), conversaciones con respuestas y asignación, mensajes salientes y los miembros del equipo y equipos de un workspace. Tu cliente conecta Intercom una vez con OAuth, y tu producto o agente de IA llama a cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/intercom_search_contacts/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Intercom.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Intercom. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Intercom.
Mantén los contactos sincronizados
Crea o actualiza contactos de Intercom con sus atributos personalizados cuando los usuarios se registran o cambian de plan en tu producto.
Agente de soporte hace el triaje
Un agente de IA busca conversaciones abiertas asignadas a un equipo, lee cada una, responde como miembro del equipo y la cierra o la pospone.
Contacto proactivo desde tu app
Envía un mensaje a un contacto en el Messenger o por email cuando algo ocurre en tu producto, como un pago fallido.
Tools
13 tools de Intercom
- Listar contactosGETLista los contactos del workspace, usuarios y leads, 10 por página por defecto. La página siguiente viene de pages.next.starting_after en la respuesta; sin él, esta es la última página. Los contactos fusionados no aparecen.
- Buscar contactosPOSTBusca contactos por sus atributos, por ejemplo por email, role o un atributo personalizado. Los timestamps son segundos Unix en UTC. Devuelve total_count y data, 50 por página por defecto, y la página siguiente viene de pages.next.starting_after. Un contacto creado en los últimos minutos puede no aparecer todavía.
- Obtener contactoGETDevuelve un contacto con role, email, teléfono, nombre, owner_id, custom_attributes, tags, empresas y ubicación. Un contacto fusionado en otro devuelve 410.
- Crear contactoPOSTCrea un contacto, usuario o lead. Envía al menos uno entre email, external_id o role. Todo atributo personalizado enviado debe existir ya en el workspace, o Intercom rechaza el contacto.
- Actualizar contactoPUTActualiza un contacto: envía solo los campos a cambiar. Un usuario no puede pasar a lead. Todo atributo personalizado enviado debe existir ya en el workspace.
- Listar conversacionesGETLista las conversaciones del workspace, 20 por página por defecto. La página siguiente viene de pages.next.starting_after en la respuesta; sin él, esta es la última página. Obtener conversación devuelve todas las partes de una conversación.
- Buscar conversacionesPOSTBusca conversaciones por sus atributos, por ejemplo las abiertas asignadas a un miembro del equipo o a un equipo. Los timestamps son segundos Unix. Devuelve total_count y conversations, 20 por página por defecto, y la página siguiente viene de pages.next.starting_after.
- Obtener conversaciónGETDevuelve una conversación con sus partes (mensajes, notas y acciones), hasta las 500 más recientes, además de state, asignados, contactos y tags.
- Responder conversaciónPOSTResponde a una conversación como miembro del equipo. Un comment llega al contacto por el canal de la conversación, como el Messenger o email; una note queda interna, visible solo para el equipo. Cerrar, posponer, reabrir y asignar se hacen con Gestionar conversación.
- Gestionar conversaciónPOSTCierra, pospone, reabre o asigna una conversación. close exige type admin; snoozed exige snoozed_until; assignment exige type y assignee_id, y una conversación puede tener un admin y un equipo asignados a la vez. Asignar una conversación cerrada la reabre, salvo que skip_reopen sea true.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/intercom, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Intercom
¿Necesito implementar la API de Intercom?
No. Connect ya trae 13 tools de Intercom descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Intercom?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
