Tools de Intercom
Las 13 operaciones de Intercom que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- 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.
- Crear mensajePOSTEnvía un mensaje nuevo de un miembro del equipo a un contacto, en el Messenger (in_app) o por email. Email exige subject y template. La conversación solo existe después de que el contacto responde, salvo que create_conversation_without_contact_reply sea true.
- Listar miembros del equipoGETLista los miembros del equipo (admins) del workspace con id, nombre, email, away_mode_enabled y team_ids. El id es el admin_id de respuestas y acciones de conversación y el owner_id de contactos.
- Listar equiposGETLista los equipos del workspace con id, nombre y admin_ids. El id es el assignee_id de una conversación asignada a un equipo.
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.
