Intercom
Gestiona contactos, empresas, conversaciones, tickets y mensajes en Intercom
Configuración
Crear contacto
Operación
Crear contacto
Token de acceso*
••••••••
Rol
Select...
Correo electrónico
Correo del contacto
ID externo
Identificador externo del contacto
Teléfono
Número de teléfono del contacto
Nombre
Nombre del contacto
URL del avatar
URL de la imagen del avatar
Fecha de registro
Timestamp Unix
Última vez visto
Timestamp Unix
ID del propietario
ID de administrador
Baja de correos
Select...
Atributos personalizados
Objeto JSON con atributos personalizados
ID de empresa
ID de empresa para asociar al contacto
Crear contacto (
intercom_create_contact)Crear un contacto nuevo en Intercom con email, external_id o role
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
role | string | No | El rol del contacto. Acepta 'user' o 'lead'. El valor predeterminado 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 del 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 del contacto |
signed_up_at | number | No | La hora de registro del usuario como marca de tiempo Unix |
last_seen_at | number | No | La última vez que se vio al usuario como marca de tiempo Unix |
owner_id | string | No | El id de un administrador al que se 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 (p. ej., {"attribute_name": "value"}) |
company_id | string | No | ID de empresa para asociar el contacto durante la creación |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contact | object | Objeto del contacto creado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener contacto
Operación
Obtener contacto
Token de acceso*
••••••••
ID de contacto*
ID de contacto
Obtener contacto (
intercom_get_contact)Obtener un único contacto por ID desde Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
contactId | string | Sí | ID del contacto que se va a obtener |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contact | object | Objeto de contacto |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Actualizar contacto
Operación
Actualizar contacto
Token de acceso*
••••••••
Rol
Select...
ID de contacto*
ID de contacto
Correo electrónico
Correo del contacto
ID externo
Identificador externo del contacto
Teléfono
Número de teléfono del contacto
Nombre
Nombre del contacto
URL del avatar
URL de la imagen del avatar
Fecha de registro
Marca de tiempo Unix
Visto por última vez
Marca de tiempo Unix
ID del propietario
ID de administrador
Dado de baja de correos
Select...
Atributos personalizados
Objeto JSON con atributos personalizados
ID de empresa
ID de empresa para asociar al contacto
Actualizar contacto (
intercom_update_contact)Actualizar un contacto existente en Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
contactId | string | Sí | ID del contacto a actualizar |
role | string | No | Rol del contacto. Acepta 'user' o 'lead'. |
external_id | string | No | Identificador único del contacto proporcionado por el cliente |
email | string | No | Dirección de correo electrónico del contacto |
phone | string | No | Número de teléfono del contacto |
name | string | No | Nombre del contacto |
avatar | string | No | URL de la imagen de avatar del contacto |
signed_up_at | number | No | Hora de registro del usuario como marca de tiempo Unix |
last_seen_at | number | No | Hora de la última vez que se vio al usuario como marca de tiempo Unix |
owner_id | string | No | ID de un administrador al que se asignó la propiedad de la cuenta del contacto |
unsubscribed_from_emails | boolean | No | Indica si el contacto está dado de baja de los correos electrónicos |
custom_attributes | string | No | Atributos personalizados como objeto JSON (p. ej., {"attribute_name": "value"}) |
company_id | string | No | ID de la empresa con la que asociar el contacto |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contact | object | Objeto de contacto actualizado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Listar contactos
Operación
Listar contactos
Token de acceso*
••••••••
Por página
Resultados por página (máx.: 150)
A partir de
Cursor de paginación
Listar contactos (
intercom_list_contacts)Lista todos los contactos de Intercom con soporte de paginación
Entrada
| 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 de paginación: ID a partir del cual empezar |
Salida
| Parameter | Type | Description |
|---|---|---|
contacts | array | Array de objetos de contacto |
pages | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Buscar contactos
Operación
Buscar contactos
Token de acceso*
••••••••
Consulta de búsqueda*
Consulta de búsqueda JSON o texto
Campo de ordenación
Campo por el que ordenar (p. ej., name, created_at)
Orden
Select...
Por página
Resultados por página (máx.: 150)
A partir de
Cursor de paginación
Buscar contactos (
intercom_search_contacts)Buscar contactos en Intercom mediante una consulta
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | Sí | Consulta de búsqueda (p. 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 la paginación |
sort_field | string | No | Campo por el que ordenar (p. ej., "name", "created_at", "last_seen_at") |
sort_order | string | No | Orden: "ascending" o "descending" |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
contacts | array | Array de objetos de contacto coincidentes |
pages | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Eliminar contacto
Operación
Eliminar contacto
Token de acceso*
••••••••
ID de contacto*
ID de contacto
Eliminar contacto (
intercom_delete_contact)Elimina un contacto de Intercom por ID
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
contactId | string | Sí | ID del contacto a eliminar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del contacto eliminado |
deleted | boolean | Indica si se eliminó el contacto |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Crear empresa
Operación
Crear empresa
Token de acceso*
••••••••
ID de empresa (externo)*
Tu identificador único de la empresa
Nombre de la empresa
Nombre de la empresa
Sitio web
Sitio web de la empresa
Plan
Plan de suscripción
Tamaño
Número de empleados
Industria
Industria de la empresa
Gasto mensual
Importe de ingresos
Fecha de creación remota
Marca de tiempo Unix de creación de la empresa
Crear empresa (
intercom_create_company)Crear o actualizar una empresa en Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
company_id | string | Sí | Tu identificador único de 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 de la empresa |
industry | string | No | El sector en el que opera la empresa |
monthly_spend | number | No | Los ingresos que la empresa genera para tu negocio. Nota: Este campo trunca los valores de punto flotante a enteros (p. ej., 155.98 se convierte en 155) |
custom_attributes | string | No | Atributos personalizados como objeto JSON |
remote_created_at | number | No | El momento en que creaste la empresa, como marca de tiempo Unix |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
company | object | Objeto de empresa creada o actualizada |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener empresa
Operación
Obtener empresa
Token de acceso*
••••••••
ID de empresa*
ID de empresa de Intercom
Obtener empresa (
intercom_get_company)Recuperar una empresa por ID desde Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
companyId | string | Sí | ID de la empresa que se va a recuperar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
company | object | Objeto de empresa |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Listar empresas
Operación
Listar empresas
Token de acceso*
••••••••
Por página
Resultados por página (máx.: 150)
A partir de
Cursor de paginación
Página
Número de página
Listar empresas (
intercom_list_companies)Lista todas las empresas de Intercom con soporte de paginación. Nota: Este endpoint tiene un límite de 10,000 empresas que se pueden devolver mediante paginación. Para conjuntos de datos de más de 10,000 empresas, usa la Scroll API.
Entrada
| 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 la paginación por páginas) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
companies | array | Array de objetos de empresa |
pages | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener conversación
Operación
Obtener conversación
Token de acceso*
••••••••
ID de conversación*
ID de conversación
Mostrar como
Select...
Incluir traducciones
Select...
Obtener conversación (
intercom_get_conversation)Recupera una conversación individual por ID de Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
conversationId | string | Sí | ID de la conversación que se va a recuperar |
display_as | string | No | Establece "plaintext" para recuperar los mensajes en texto plano |
include_translations | boolean | No | Si es true, las partes de la conversación se traducirán al idioma detectado de la conversación |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
conversation | object | Objeto de conversación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Listar conversaciones
Operación
Listar conversaciones
Token de acceso*
••••••••
Ordenar por
Campo por el que ordenar (p. ej., waiting_since, updated_at)
Orden
Select...
Por página
Resultados por página (máx.: 150)
A partir de
Cursor de paginación
Listar conversaciones (
intercom_list_conversations)Lista todas las conversaciones de Intercom con soporte de paginación
Entrada
| 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 de paginación |
sort | string | No | Campo por el que ordenar (p. ej., "waiting_since", "updated_at", "created_at") |
order | string | No | Orden: "asc" (ascendente) o "desc" (descendente) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
conversations | array | Array de objetos de conversación |
pages | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Responder a la conversación
Operación
Responder a la conversación
Token de acceso*
••••••••
ID de conversación*
ID de conversación
Tipo de mensaje*
Select...
Cuerpo del mensaje*
Texto del mensaje
ID de administrador*
ID del administrador que envía el mensaje
URL de archivos adjuntos
URL de imágenes separadas por comas (máx. 10)
Fecha de creación
Marca de tiempo Unix de creación de la respuesta
Responder a la conversación (
intercom_reply_conversation)Responder a una conversación como administrador en Intercom
Entrada
| 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 URL de imágenes separadas por comas (máx. 10) |
created_at | number | No | Marca de tiempo Unix de creación de la respuesta. Si no se proporciona, se usa la hora actual. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
conversation | object | Objeto de conversación actualizado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Buscar conversaciones
Operación
Buscar conversaciones
Token de acceso*
••••••••
Consulta de búsqueda*
Consulta de búsqueda JSON o texto
Campo de ordenación
Campo por el que ordenar (p. ej., name, created_at)
Orden
Select...
Por página
Resultados por página (máx.: 150)
A partir de
Cursor de paginación
Buscar conversaciones (
intercom_search_conversations)Buscar conversaciones en Intercom mediante una consulta
Entrada
| 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: "ascending" o "descending" |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
conversations | array | Array de objetos de conversación coincidentes |
pages | object | Información de paginación |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Crear ticket
Operación
Crear ticket
Token de acceso*
••••••••
ID de tipo de ticket*
ID del tipo de ticket
Contactos*
Array JSON de identificadores de contacto
Atributos del ticket*
Objeto JSON con atributos del ticket
ID de empresa
ID de empresa para asociar al ticket
Fecha de creación
Timestamp Unix de creación del ticket
Conversación a vincular
ID de la conversación para vincular al ticket
Desactivar notificaciones
Select...
Crear ticket (
intercom_create_ticket)Crear un ticket nuevo en Intercom
Entrada
| 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, incluidos default_title y default_description |
company_id | string | No | ID de empresa para asociar el ticket |
created_at | number | No | Marca de tiempo Unix de creación del ticket. Si no se proporciona, se usa la hora actual. |
conversation_to_link_id | string | No | ID de una conversación existente para vincular a este ticket |
disable_notifications | boolean | No | Si es true, suprime las notificaciones al crear el ticket |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
ticket | object | Objeto del ticket creado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Obtener ticket
Operación
Obtener ticket
Token de acceso*
••••••••
ID del ticket*
ID del ticket
Obtener ticket (
intercom_get_ticket)Recupera un único ticket por ID desde Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
ticketId | string | Sí | ID del ticket a recuperar |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
ticket | object | Objeto ticket |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Crear mensaje
Operación
Crear mensaje
Token de acceso*
••••••••
Cuerpo del mensaje*
Texto del mensaje
Tipo de mensaje*
Select...
Plantilla*
Select...
Asunto
Asunto del correo (para tipo email)
Tipo de origen*
Select...
ID de origen*
ID de administrador
Tipo de destino*
Select...
ID de destino*
ID de contacto
Creado el
Marca de tiempo Unix de creación del mensaje
Crear mensaje (
intercom_create_message)Crear y enviar un nuevo mensaje iniciado por un administrador en Intercom
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
message_type | string | Sí | Tipo de mensaje: "inapp" para mensajes en 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 el 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 creación del mensaje. Si no se proporciona, se usa la hora actual. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
message | object | Objeto del mensaje creado |
metadata | object | Metadatos de la operación |
success | boolean | Estado de éxito de la operación |
Instrucciones de uso
Integra Intercom en el workflow. Permite 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.
Notas
- Categoría:
tools - Tipo:
intercom