> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/sincronizacion-crm-pipeline.md).

# Sincronización CRM Pipeline

Mueve contactos a la etapa correcta de tu pipeline de CRM automáticamente después de cada conversación. Conecta GoHighLevel o HubSpot, elige las etapas elegibles y deja que el agente se encargue del r

La **Sincronización CRM Pipeline** permite que tu Agente de Texto mueva contactos en un pipeline de GoHighLevel o HubSpot de forma automática — sin actualizaciones manuales. Después de que cada conversación cierra y se ejecuta el análisis post-conversación, un juez de IA lee el análisis y mueve el contacto a la etapa correspondiente.

{% hint style="info" %}
Para configurar la Sincronización CRM Pipeline, necesitas permiso para editar el Agente de Texto y una credencial conectada de HubSpot o GoHighLevel. No necesitas solicitar acceso a un lanzamiento limitado.
{% endhint %}

***

**📘 Qué aprenderás en este documento:**

* **Paso 1:** Conecta una credencial de CRM en **Configuración → OAuth**.
* **Paso 2:** Activa y configura la Sincronización CRM Pipeline para un Agente de Texto específico.
* **Cómo funciona:** qué ocurre en tiempo real cuando una conversación cierra.

***

#### 🔐 Paso 1: Conecta una credencial de CRM

Antes de configurar tu agente, agrega tu credencial de CRM en **Configuración → OAuth**. Puedes agregar múltiples credenciales por proveedor.

{% tabs %}
{% tab title="GoHighLevel" %}
Necesitarás un **Private Integration Token** y tu **Location ID**.

1. En tu cuenta de GoHighLevel, ve a **Settings → Integrations → Private Integrations** y crea una nueva integración.
2. Copia el **Private Integration Token** generado.
3. Encuentra tu **Location ID** en **Settings → Business Info**.
4. En Dapta, ve a **Configuración → OAuth** y haz clic en **Agregar credencial**.
5. Selecciona **GoHighLevel**, pega tu token y Location ID, asigna un nombre a la credencial y haz clic en **Guardar**.

{% hint style="info" %}
Las Oportunidades en GoHighLevel son las tarjetas que se mueven entre etapas del pipeline.
{% endhint %}
{% endtab %}

{% tab title="HubSpot" %}
Necesitarás un **Private App Token** con los permisos de CRM correctos.

1. En HubSpot, ve a **Settings → Integrations → Private Apps** y crea una nueva aplicación.
2. En la pestaña **Scopes**, habilita como mínimo:
   * `crm.objects.contacts.read` / `write`
   * `crm.objects.deals.read` / `write`
   * `crm.schemas.deals.read` / `write`
3. Haz clic en **Create app** y copia el token generado.
4. En Dapta, ve a **Configuración → OAuth** y haz clic en **Agregar credencial**.
5. Selecciona **HubSpot**, pega tu token, asígnale un nombre y haz clic en **Guardar**.

{% hint style="info" %}
Los Deals en HubSpot son las tarjetas que se mueven entre etapas del pipeline.
{% endhint %}
{% endtab %}
{% endtabs %}

***

#### ⚙️ Paso 2: Activa la Sincronización CRM Pipeline en tu Agente de Texto

Una vez conectada la credencial, abre el agente que deseas configurar.

1. Abre tu **Agente de Texto** y ve a la pestaña **Análisis de Conversación**.
2. Expande la sección **Sincronización CRM Pipeline**.
3. Activa el interruptor **Habilitar sincronización CRM Pipeline para este agente**.

***

#### 🔌 Selecciona una credencial y un pipeline

4. Haz clic en el selector **Credencial**. Cada opción muestra el ícono del proveedor (HubSpot o GoHighLevel). Si aún no tienes una credencial, selecciona **Agregar credencial** — esto te lleva a **Configuración → OAuth**.
5. Una vez seleccionada la credencial, elige un **Pipeline** desde el menú desplegable. La lista se obtiene directamente desde tu CRM.

***

#### 🎯 Elige etapas y configura condiciones de movimiento

6. Haz clic en **Elegir etapas** para abrir el selector. Marca cada etapa a la que el agente puede mover contactos.
7. Haz clic en **Confirmar**. Cada etapa seleccionada aparece como una tarjeta. Usa su **ícono de lápiz** para escribir, de forma opcional, una **condición de movimiento** — una breve descripción de cuándo un contacto pertenece a esa etapa.

> Dapta genera una condición de respaldo con IA a partir del nombre de la etapa y la mantiene oculta. El campo editable contiene tu propia condición, no ese respaldo. Tu condición tiene prioridad; si dejas el campo vacío, se usa el respaldo cuando está disponible.

***

#### ➕ Interruptor "Agregar contacto al pipeline si aún no está"

Este interruptor controla qué ocurre cuando un contacto existente en el CRM no tiene aún un deal/oportunidad en el pipeline elegido:

| Estado del interruptor | Comportamiento                                                                                                                                                    |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Activado**           | Si el contacto existe en el CRM pero no tiene un deal en este pipeline, se crea un nuevo deal/oportunidad en la etapa correspondiente para que entre al pipeline. |
| **Desactivado**        | Solo se mueven los contactos que ya tienen un deal/oportunidad en este pipeline.                                                                                  |

{% hint style="warning" %}
**La Sincronización CRM Pipeline nunca crea contactos.** Solo actúa sobre personas que ya existen en tu CRM. Si un contacto no puede encontrarse por número de teléfono o correo electrónico, no ocurre nada — sin error, sin datos creados.
{% endhint %}

8. Configura el interruptor según tu flujo de trabajo y haz clic en **Guardar Agente** para guardar el borrador. Revisa tus cambios y haz clic en **Publicar** para activarlos.

***

## Cómo funciona en tiempo real

Cuando una sesión de conversación cierra (ya sea porque el agente llama a la acción **Cerrar Conversación** o tras el tiempo de inactividad), el análisis post-conversación se ejecuta. Como parte de ese análisis:

1. Dapta busca el contacto en tu CRM por **número de teléfono** o **correo electrónico** capturados durante la conversación.
2. Un juez de IA lee los resultados del análisis y los compara con la condición de cada etapa elegible: tu propia condición tiene prioridad sobre su respaldo generado con IA.
3. El juez selecciona la etapa elegible que mejor coincide y mueve el deal/oportunidad del contacto a esa etapa.

> El movimiento de etapa es de **mejor esfuerzo** — se ejecuta después de que la conversación cierra y nunca bloquea ni retrasa la conversación en sí. Si el contacto no se encuentra en el CRM, el movimiento se omite silenciosamente.

***

## Requisitos y limitaciones

| Requisito                     | Detalle                                                                                                                           |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Versión del agente**        | Solo Agentes de Texto V2 (runtime temporal/durable).                                                                              |
| **Coincidencia de contactos** | El contacto debe existir en el CRM. La coincidencia es por número de teléfono (se recomienda formato E.164) o correo electrónico. |
| **Formato de teléfono**       | Los números de teléfono deben coincidir con el formato almacenado en tu CRM. Usa E.164 (ej. `+15551234567`) cuando sea posible.   |
| **Objeto en HubSpot**         | Mueve **Deals** entre etapas del pipeline.                                                                                        |
| **Objeto en GoHighLevel**     | Mueve **Oportunidades** entre etapas del pipeline.                                                                                |
| **Múltiples credenciales**    | Puedes agregar múltiples credenciales por proveedor en **Configuración → OAuth**. Cada agente usa una credencial + un pipeline.   |
| **Análisis de Conversación**  | El Análisis Post-Conversación debe estar habilitado en el agente para que la sincronización de CRM se ejecute.                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/sincronizacion-crm-pipeline.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.