> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom

> Intercom te ayuda a gestionar el chat en vivo, las conversaciones con clientes, los contactos, los tickets, las etiquetas y los registros de empresa mediante tu cuenta conectada.

# Intercom

Usa esta app cuando necesites encontrar, actualizar o responder a contactos, conversaciones, tickets y empresas en Intercom.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Nombre | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Sí | La cuenta de Intercom conectada que se usará para este paso. |
| Action | Sí | La acción de Intercom que se va a realizar (por ejemplo, Get contact, List contacts, Search contacts, Create contact). |
| Arguments | Sí | Campos del formulario específicos de cada acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Intercom en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuentas.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que se refieren a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Acciones comunes

| Action | Description |
| - | - |
| **Get contact** | Obtiene un único contacto por ID. |
| **List contacts** | Lista los contactos de tu espacio de trabajo con paginación. |
| **Search contacts** | Encuentra contactos con filtros y operadores de consulta. |
| **Create contact** | Crea un nuevo contacto en Intercom. |
| **Update contact** | Actualiza un contacto existente. |
| **Attach contact to company** | Vincula un contacto a una empresa. |
| **Detach contact from company** | Desvincula un contacto de una empresa. |
| **Get conversation** | Recupera una conversación con sus mensajes y detalles. |
| **List conversations** | Lista las conversaciones de tu espacio de trabajo con paginación. |
| **Search conversations** | Encuentra conversaciones con filtrado y ordenación. |
| **Create conversation** | Crea una nueva conversación. |
| **Reply to conversation** | Envía una respuesta a una conversación existente. |
| **Close conversation** | Marca una conversación como resuelta. |
| **Reopen conversation** | Reabre una conversación cerrada. |
| **Assign conversation** | Asigna una conversación a un administrador o equipo. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso guarda la respuesta de Intercom como salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta Intercom si aún no lo has hecho.
2. Añade un paso **Intercom** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get contact** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para referenciar la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Casos de uso

### Responder a un cliente

1. Search conversations
2. Get conversation
3. Reply to conversation

### Crear un ticket de soporte

1. Search contacts
2. Create ticket
3. Update ticket

### Organizar un contacto

1. Get contact
2. Attach contact to company
3. Tag contact

## Notas

* Este paso depende de una integración de Intercom conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta de Intercom pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar una marca de autorización de terceros.

## Using Intercom as an Agent Tool

También puedes añadir Intercom como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Intercom**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a las acciones de Intercom cuando son relevantes para la conversación.

Ver también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md) y [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.