For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.


📘 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.

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.

Las Oportunidades en GoHighLevel son las tarjetas que se mueven entre etapas del pipeline.

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.

Los Deals en HubSpot son las tarjetas que se mueven entre etapas del pipeline.


⚙️ 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

  1. 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.

  2. 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

  1. Haz clic en Elegir etapas para abrir el selector. Marca cada etapa a la que el agente puede mover contactos.

  2. 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.

  1. 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.

Última actualización