Intercom es una plataforma líder de comunicación con clientes que te permite gestionar y automatizar tus interacciones con contactos, empresas, conversaciones, tickets y mensajes, todo en un solo lugar. La integración de Intercom en Aptlystar permite a tus agentes gestionar programáticamente las relaciones con los clientes, las solicitudes de soporte y las conversaciones directamente desde tus flujos de trabajo automatizados.
Con las herramientas de Intercom, puedes:
- Gestión de contactos: Crear, obtener, actualizar, listar, buscar y eliminar contactos—automatiza tus procesos de CRM y mantén actualizados los registros de tus clientes.
- Gestión de empresas: Crear nuevas empresas, recuperar detalles de empresas y listar todas las empresas relacionadas con tus usuarios o clientes comerciales.
- Manejo de conversaciones: Obtener, listar, responder y buscar conversaciones—permitiendo a los agentes seguir hilos de soporte en curso, proporcionar respuestas y automatizar acciones de seguimiento.
- Gestión de tickets: Crear y recuperar tickets programáticamente, ayudándote a automatizar el servicio al cliente, el seguimiento de problemas de soporte y las escalaciones de flujo de trabajo.
- Enviar mensajes: Activar mensajes a usuarios o leads para incorporación, soporte o marketing, todo desde dentro de tu automatización de flujo de trabajo.
Al integrar las herramientas de Intercom en Aptlystar, potencias tus flujos de trabajo para comunicarte directamente con tus usuarios, automatizar procesos de atención al cliente, gestionar leads y agilizar las comunicaciones a escala. Ya sea que necesites crear nuevos contactos, mantener sincronizados los datos de los clientes, gestionar tickets de soporte o enviar mensajes de engagement personalizados, las herramientas de Intercom proporcionan una forma integral de gestionar las interacciones con los clientes como parte de tus automatizaciones inteligentes.
Integra Intercom en el flujo de trabajo. Puede crear, obtener, actualizar, listar, buscar y eliminar contactos; crear, obtener y listar empresas; obtener, listar, responder y buscar conversaciones; crear y obtener tickets; y crear mensajes.
Crear un nuevo contacto en Intercom con email, external_id o rol
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
role | string | No | El rol del contacto. Acepta 'user' o 'lead'. Por defecto es 'lead' si no se especifica. |
email | string | No | La dirección de correo electrónico del contacto |
external_id | string | No | Un identificador único para el contacto proporcionado por el cliente |
phone | string | No | El número de teléfono del contacto |
name | string | No | El nombre del contacto |
avatar | string | No | Una URL de imagen de avatar para el contacto |
signed_up_at | number | No | La hora en que el usuario se registró como marca de tiempo Unix |
last_seen_at | number | No | La hora en que el usuario fue visto por última vez como marca de tiempo Unix |
owner_id | string | No | El id de un administrador al que se le ha asignado la propiedad de la cuenta del contacto |
unsubscribed_from_emails | boolean | No | Si el contacto está dado de baja de los correos electrónicos |
custom_attributes | string | No | Atributos personalizados como objeto JSON (ej., {"attribute_name": "value"}) |
company_id | string | No | ID de empresa para asociar el contacto durante la creación |
| Parámetro | Tipo | Descripción |
|---|
contact | object | Objeto de contacto creado |
Obtener un solo contacto por ID desde Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | ID del contacto a recuperar |
| Parámetro | Tipo | Descripción |
|---|
contact | object | Objeto de contacto |
Actualizar un contacto existente en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | ID del contacto a actualizar |
role | string | No | El rol del contacto. Acepta 'user' o 'lead'. |
external_id | string | No | Un identificador único para el contacto proporcionado por el cliente |
email | string | No | La dirección de correo electrónico del contacto |
phone | string | No | El número de teléfono del contacto |
name | string | No | El nombre del contacto |
avatar | string | No | Una URL de imagen de avatar para el contacto |
signed_up_at | number | No | La hora en que el usuario se registró como marca de tiempo Unix |
last_seen_at | number | No | La hora en que el usuario fue visto por última vez como marca de tiempo Unix |
owner_id | string | No | El id de un administrador al que se le ha asignado la propiedad de la cuenta del contacto |
unsubscribed_from_emails | boolean | No | Si el contacto está dado de baja de los correos electrónicos |
custom_attributes | string | No | Atributos personalizados como objeto JSON (ej., {"attribute_name": "value"}) |
company_id | string | No | ID de empresa para asociar el contacto |
| Parámetro | Tipo | Descripción |
|---|
contact | object | Objeto de contacto actualizado |
Listar todos los contactos de Intercom con soporte de paginación
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
per_page | number | No | Número de resultados por página (máx: 150) |
starting_after | string | No | Cursor para paginación - ID para comenzar después |
| Parámetro | Tipo | Descripción |
|---|
contacts | array | Array de objetos de contacto |
Buscar contactos en Intercom usando una consulta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
query | string | Sí | Consulta de búsqueda (ej., {"field":"email","operator":"=","value":"user@example.com"}) |
per_page | number | No | Número de resultados por página (máx: 150) |
starting_after | string | No | Cursor para paginación |
sort_field | string | No | Campo por el cual ordenar (ej., "name", "created_at", "last_seen_at") |
sort_order | string | No | Orden de clasificación: "ascending" o "descending" |
| Parámetro | Tipo | Descripción |
|---|
contacts | array | Array de objetos de contacto coincidentes |
Eliminar un contacto de Intercom por ID
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | ID del contacto a eliminar |
| Parámetro | Tipo | Descripción |
|---|
id | string | ID del contacto eliminado |
deleted | boolean | Si el contacto fue eliminado |
metadata | object | Metadatos de la operación |
Crear o actualizar una empresa en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
company_id | string | Sí | Tu identificador único para la empresa |
name | string | No | El nombre de la empresa |
website | string | No | El sitio web de la empresa |
plan | string | No | El nombre del plan de la empresa |
size | number | No | El número de empleados en la empresa |
industry | string | No | La industria en la que opera la empresa |
monthly_spend | number | No | Cuántos ingresos genera la empresa para tu negocio. Nota: Este campo trunca decimales a números enteros (ej., 155.98 se convierte en 155) |
custom_attributes | string | No | Atributos personalizados como objeto JSON |
remote_created_at | number | No | La fecha en que creaste la empresa como marca de tiempo Unix |
| Parámetro | Tipo | Descripción |
|---|
company | object | Objeto de empresa creado o actualizado |
Recuperar una única empresa por ID desde Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
companyId | string | Sí | ID de la empresa a recuperar |
| Parámetro | Tipo | Descripción |
|---|
company | object | Objeto de empresa |
Lista todas las empresas de Intercom con soporte de paginación. Nota: Este endpoint tiene un límite de 10,000 empresas que pueden ser devueltas usando paginación. Para conjuntos de datos mayores a 10,000 empresas, usa la API Scroll en su lugar.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
per_page | number | No | Número de resultados por página |
page | number | No | Número de página |
starting_after | string | No | Cursor para paginación (preferido sobre paginación basada en páginas) |
| Parámetro | Tipo | Descripción |
|---|
companies | array | Array de objetos de empresa |
Recuperar una sola conversación por ID desde Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | ID de la conversación a recuperar |
display_as | string | No | Establecer en "plaintext" para recuperar mensajes en texto plano |
include_translations | boolean | No | Cuando es true, las partes de la conversación se traducirán al idioma detectado de la conversación |
| Parámetro | Tipo | Descripción |
|---|
conversation | object | Objeto de conversación |
Listar todas las conversaciones de Intercom con soporte de paginación
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
per_page | number | No | Número de resultados por página (máx: 150) |
starting_after | string | No | Cursor para paginación |
sort | string | No | Campo por el que ordenar (p. ej., "waiting_since", "updated_at", "created_at") |
order | string | No | Orden de clasificación: "asc" (ascendente) o "desc" (descendente) |
| Parámetro | Tipo | Descripción |
|---|
conversations | array | Array de objetos de conversación |
Responder a una conversación como administrador en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | ID de la conversación a la que responder |
message_type | string | Sí | Tipo de mensaje: "comment" o "note" |
body | string | Sí | El cuerpo de texto de la respuesta |
admin_id | string | No | El ID del administrador que escribe la respuesta. Si no se proporciona, se usará un administrador predeterminado (Operator/Fin). |
attachment_urls | string | No | Lista de URLs de imágenes separadas por comas (máx 10) |
created_at | number | No | Marca de tiempo Unix de cuándo se creó la respuesta. Si no se proporciona, se usa la hora actual. |
| Parámetro | Tipo | Descripción |
|---|
conversation | object | Objeto de conversación actualizado |
Buscar conversaciones en Intercom usando una consulta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
query | string | Sí | Consulta de búsqueda como objeto JSON |
per_page | number | No | Número de resultados por página (máx: 150) |
starting_after | string | No | Cursor para paginación |
sort_field | string | No | Campo por el que ordenar (p. ej., "created_at", "updated_at") |
sort_order | string | No | Orden de clasificación: "ascending" o "descending" |
| Parámetro | Tipo | Descripción |
|---|
conversations | array | Array de objetos de conversación coincidentes |
Crear un nuevo ticket en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
ticket_type_id | string | Sí | El ID del tipo de ticket |
contacts | string | Sí | Array JSON de identificadores de contacto (p. ej., [{"id": "contact_id"}]) |
ticket_attributes | string | Sí | Objeto JSON con atributos del ticket incluyendo default_title y default_description |
company_id | string | No | ID de la empresa para asociar el ticket |
created_at | number | No | Marca de tiempo Unix de cuándo se creó el ticket. Si no se proporciona, se utiliza la hora actual. |
conversation_to_link_id | string | No | ID de una conversación existente para vincular a este ticket |
disable_notifications | boolean | No | Cuando es true, suprime las notificaciones cuando se crea el ticket |
| Parámetro | Tipo | Descripción |
|---|
ticket | object | Objeto de ticket creado |
Recuperar un solo ticket por ID desde Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
ticketId | string | Sí | ID del ticket a recuperar |
| Parámetro | Tipo | Descripción |
|---|
ticket | object | Objeto de ticket |
Crear y enviar un nuevo mensaje iniciado por el administrador en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
message_type | string | Sí | Tipo de mensaje: "inapp" para mensajes dentro de la aplicación o "email" para mensajes de correo electrónico |
template | string | Sí | Estilo de plantilla del mensaje: "plain" para texto sin formato o "personal" para estilo personalizado |
subject | string | No | El asunto del mensaje (para tipo email) |
body | string | Sí | El cuerpo del mensaje |
from_type | string | Sí | Tipo de remitente: "admin" |
from_id | string | Sí | El ID del administrador que envía el mensaje |
to_type | string | Sí | Tipo de destinatario: "contact" |
to_id | string | Sí | El ID del contacto que recibe el mensaje |
created_at | number | No | Marca de tiempo Unix de cuándo se creó el mensaje. Si no se proporciona, se utiliza la hora actual. |
| Parámetro | Tipo | Descripción |
|---|
message | object | Objeto de mensaje creado |
- Categoría:
tools
- Tipo:
intercom
Crea y envía un nuevo mensaje iniciado por el administrador en Intercom. Devuelve solo campos alineados con la API.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
message_type | string | Sí | Tipo de mensaje: "inapp" para mensajes dentro de la aplicación o "email" para mensajes de correo electrónico |
template | string | Sí | Estilo de plantilla del mensaje: "plain" para texto plano o "personal" para estilo personalizado |
subject | string | No | El asunto del mensaje (para tipo email) |
body | string | Sí | El cuerpo del mensaje |
from_type | string | Sí | Tipo de remitente: "admin" |
from_id | string | Sí | El ID del administrador que envía el mensaje |
to_type | string | Sí | Tipo de destinatario: "contact" |
to_id | string | Sí | El ID del contacto que recibe el mensaje |
created_at | number | No | Marca de tiempo Unix de cuándo se creó el mensaje. Si no se proporciona, se usa la hora actual. |
| Parámetro | Tipo | Descripción |
|---|
message | object | Objeto de mensaje creado |
↳ id | string | Identificador único del mensaje |
↳ type | string | Tipo de objeto (message) |
↳ created_at | number | Marca de tiempo Unix de cuándo se creó el mensaje |
↳ body | string | Cuerpo del mensaje |
↳ message_type | string | Tipo del mensaje (in_app o email) |
↳ conversation_id | string | ID de la conversación creada |
↳ owner | object | Propietario del mensaje |
messageId | string | ID del mensaje creado |
success | boolean | Estado de éxito de la operación |
Obtener una lista de todos los administradores del espacio de trabajo
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| Parámetro | Tipo | Descripción |
|---|
admins | array | Array de objetos de administrador |
↳ id | string | Identificador único del administrador |
↳ type | string | Tipo de objeto (admin) |
↳ name | string | Nombre del administrador |
↳ email | string | Correo electrónico del administrador |
↳ job_title | string | Cargo del administrador |
↳ away_mode_enabled | boolean | Si el administrador está en modo ausente |
↳ away_mode_reassign | boolean | Si se deben reasignar conversaciones cuando está ausente |
↳ has_inbox_seat | boolean | Si el administrador tiene un asiento de bandeja de entrada de pago |
↳ team_ids | array | Lista de IDs de equipo a los que pertenece el administrador |
↳ avatar | object | Información del avatar |
↳ email_verified | boolean | Si el correo electrónico está verificado |
type | string | Tipo de objeto (admin.list) |
Cerrar una conversación en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | El ID de la conversación a cerrar |
admin_id | string | Sí | El ID del administrador que realiza la acción |
body | string | No | Mensaje de cierre opcional para añadir a la conversación |
| Parámetro | Tipo | Descripción |
|---|
conversation | object | El objeto de conversación cerrada |
↳ id | string | Identificador único de la conversación |
↳ type | string | Tipo de objeto (conversation) |
↳ state | string | Estado de la conversación (closed) |
↳ open | boolean | Si la conversación está abierta (false) |
↳ read | boolean | Si la conversación ha sido leída |
↳ created_at | number | Marca de tiempo Unix de cuándo se creó la conversación |
↳ updated_at | number | Marca de tiempo Unix de cuándo se actualizó la conversación por última vez |
conversationId | string | ID de la conversación cerrada |
state | string | Estado de la conversación (closed) |
Abrir una conversación cerrada o pospuesta en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | El ID de la conversación a abrir |
admin_id | string | Sí | El ID del administrador que realiza la acción |
| Parámetro | Tipo | Descripción |
|---|
conversation | object | El objeto de conversación abierta |
↳ id | string | Identificador único de la conversación |
↳ type | string | Tipo de objeto (conversation) |
↳ state | string | Estado de la conversación (open) |
↳ open | boolean | Si la conversación está abierta (true) |
↳ read | boolean | Si la conversación ha sido leída |
↳ created_at | number | Marca de tiempo Unix de cuándo se creó la conversación |
↳ updated_at | number | Marca de tiempo Unix de cuándo se actualizó la conversación por última vez |
conversationId | string | ID de la conversación abierta |
state | string | Estado de la conversación (open) |
Posponer una conversación para reabrirla en un momento futuro
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | El ID de la conversación a posponer |
admin_id | string | Sí | El ID del administrador que realiza la acción |
snoozed_until | number | Sí | Marca de tiempo Unix para cuando la conversación debe reabrirse |
| Parámetro | Tipo | Descripción |
|---|
conversation | object | El objeto de conversación pospuesta |
↳ id | string | Identificador único de la conversación |
↳ type | string | Tipo de objeto (conversation) |
↳ state | string | Estado de la conversación (snoozed) |
↳ open | boolean | Si la conversación está abierta |
↳ snoozed_until | number | Marca de tiempo Unix cuando la conversación se reabrirá |
↳ created_at | number | Marca de tiempo Unix cuando se creó la conversación |
↳ updated_at | number | Marca de tiempo Unix cuando se actualizó la conversación por última vez |
conversationId | string | ID de la conversación pospuesta |
state | string | Estado de la conversación (snoozed) |
snoozed_until | number | Marca de tiempo Unix cuando la conversación se reabrirá |
Asignar una conversación a un administrador o equipo en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | El ID de la conversación a asignar |
admin_id | string | Sí | El ID del administrador que realiza la asignación |
assignee_id | string | Sí | El ID del administrador o equipo al que asignar la conversación. Establecer en "0" para desasignar. |
body | string | No | Mensaje opcional para agregar al asignar (ej., "Pasando al equipo de soporte") |
| Parámetro | Tipo | Descripción |
|---|
conversation | object | Objeto de conversación asignada |
↳ id | string | Identificador único de la conversación |
↳ type | string | Tipo de objeto (conversation) |
↳ state | string | Estado de la conversación |
↳ open | boolean | Si la conversación está abierta |
↳ admin_assignee_id | number | ID del administrador asignado |
↳ team_assignee_id | string | ID del equipo asignado |
↳ created_at | number | Marca de tiempo Unix de cuándo se creó la conversación |
↳ updated_at | number | Marca de tiempo Unix de cuándo se actualizó la conversación por última vez |
conversationId | string | ID de la conversación asignada |
admin_assignee_id | number | ID del administrador asignado |
team_assignee_id | string | ID del equipo asignado |
Obtener una lista de todas las etiquetas en el espacio de trabajo
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| Parámetro | Tipo | Descripción |
|---|
tags | array | Array de objetos de etiqueta |
↳ id | string | Identificador único de la etiqueta |
↳ type | string | Tipo de objeto (tag) |
↳ name | string | Nombre de la etiqueta |
type | string | Tipo de objeto (list) |
Crear una nueva etiqueta o actualizar el nombre de una etiqueta existente
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
name | string | Sí | El nombre de la etiqueta. Creará una nueva etiqueta si no se encuentra, o actualizará el nombre si se proporciona el id. |
id | string | No | El ID de una etiqueta existente para actualizar. Omitir para crear una nueva etiqueta. |
| Parámetro | Tipo | Descripción |
|---|
id | string | Identificador único de la etiqueta |
name | string | Nombre de la etiqueta |
type | string | Tipo de objeto (tag) |
Añadir una etiqueta a un contacto específico
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | El ID del contacto a etiquetar |
tagId | string | Sí | El ID de la etiqueta a aplicar |
| Parámetro | Tipo | Descripción |
|---|
id | string | Identificador único de la etiqueta |
name | string | Nombre de la etiqueta |
type | string | Tipo de objeto (tag) |
Eliminar una etiqueta de un contacto específico
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | El ID del contacto del que eliminar la etiqueta |
tagId | string | Sí | El ID de la etiqueta a eliminar |
| Parámetro | Tipo | Descripción |
|---|
id | string | Identificador único de la etiqueta que fue eliminada |
name | string | Nombre de la etiqueta que fue eliminada |
type | string | Tipo de objeto (tag) |
Añadir una etiqueta a una conversación específica
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
conversationId | string | Sí | El ID de la conversación a etiquetar |
tagId | string | Sí | El ID de la etiqueta a aplicar |
admin_id | string | Sí | El ID del administrador que aplica la etiqueta |
| Parámetro | Tipo | Descripción |
|---|
id | string | Identificador único de la etiqueta |
name | string | Nombre de la etiqueta |
type | string | Tipo de objeto (tag) |
Añadir una nota a un contacto específico
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | El ID del contacto al que añadir la nota |
body | string | Sí | El contenido de texto de la nota |
admin_id | string | No | El ID del administrador que crea la nota |
| Parámetro | Tipo | Descripción |
|---|
id | string | Identificador único de la nota |
body | string | El contenido de texto de la nota |
created_at | number | Marca de tiempo Unix de cuándo se creó la nota |
type | string | Tipo de objeto (note) |
author | object | El administrador que creó la nota |
↳ type | string | Tipo de autor (admin) |
↳ id | string | ID del autor |
↳ name | string | Nombre del autor |
↳ email | string | Email del autor |
contact | object | El contacto para el que se creó la nota |
↳ type | string | Tipo de contacto |
↳ id | string | ID del contacto |
Rastrear un evento personalizado para un contacto en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
event_name | string | Sí | El nombre del evento (ej., "order-completed"). Usa formato verbo-sustantivo en pasado para mejor legibilidad. |
created_at | number | No | Marca de tiempo Unix de cuándo ocurrió el evento. Muy recomendado para unicidad. |
user_id | string | No | Tu identificador para el usuario (external_id) |
email | string | No | Dirección de correo electrónico del usuario. Usa solo si tu app usa email para identificar usuarios de forma única. |
id | string | No | El ID de contacto de Intercom |
metadata | string | No | Objeto JSON con hasta 10 pares clave-valor de metadatos sobre el evento (ej., {"order_value": 99.99}) |
| Parámetro | Tipo | Descripción |
|---|
accepted | boolean | Si el evento fue aceptado (202 Aceptado) |
Asociar un contacto a una empresa en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | El ID del contacto a asociar a la empresa |
companyId | string | Sí | El ID de la empresa a la que asociar el contacto |
| Parámetro | Tipo | Descripción |
|---|
company | object | El objeto de empresa al que se asoció el contacto |
↳ id | string | Identificador único de la empresa |
↳ type | string | Tipo de objeto (company) |
↳ company_id | string | El company_id que definiste |
↳ name | string | Nombre de la empresa |
↳ created_at | number | Marca de tiempo Unix de cuándo se creó la empresa |
↳ updated_at | number | Marca de tiempo Unix de cuándo se actualizó la empresa |
↳ user_count | number | Número de usuarios en la empresa |
↳ session_count | number | Número de sesiones |
↳ monthly_spend | number | Cantidad de gasto mensual |
↳ plan | object | Detalles del plan de la empresa |
companyId | string | ID de la empresa |
name | string | Nombre de la empresa |
Eliminar un contacto de una empresa en Intercom
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
contactId | string | Sí | El ID del contacto a desasociar de la empresa |
companyId | string | Sí | El ID de la empresa de la cual desasociar el contacto |
| Parámetro | Tipo | Descripción |
|---|
company | object | El objeto de empresa del cual se desasoció el contacto |
↳ id | string | Identificador único de la empresa |
↳ type | string | Tipo de objeto (company) |
↳ company_id | string | El company_id que definiste |
↳ name | string | Nombre de la empresa |
companyId | string | ID de la empresa |
name | string | Nombre de la empresa |
