# Llamadas y registro de clientes potenciales de HubSpot
#### **🎯 Objetivo de la Campaña**
Llamar contactos recién agregados de HubSpot de una lista específica y entregar una introducción rápida del producto usando tu agente de voz. Registrar los detalles y resultados de la llamada de vuelta en HubSpot para seguimiento por tu equipo de ventas.
**🔧 Resumen del Flujo de Trabajo**
1. Conecta tu cuenta de HubSpot
2. Obtén una lista de contactos de HubSpot
3. Activa llamadas usando tu agente de voz con IA
4. Captura datos de llamada (grabación, transcripción, estado)
5. Registra resultados y actualiza registros de contacto en HubSpot
Comencemos !!!\
\
**🔑 Paso 1: Conecta tu Cuenta de HubSpot** \
Para comenzar, necesitarás autorizar tu cuenta de HubSpot para que Dapta pueda extraer datos de contacto y actualizar registros.
**🧭 Cómo Conectar HubSpot:**
1. Haz clic en tu avatar de perfil en la esquina inferior izquierda de Dapta.\
2. Selecciona **Credenciales** del menú desplegable.
3. Haz clic en el botón **➕** junto a HubSpot.
4. En el modal:
* **Nombra** tu conexión (ej. "HubSpot Principal").
* Pega tu **Token de Aplicación Privada de HubSpot**. \
🔗 [Aprende más sobre la Configuración de Aplicación Privada de HubSpot](https://docs.dapta.ai/dapta-docs-es/integraciones/hubspot)
* Haz clic en **Guardar**.
Una vez conectado, podrás utilizar HubSpot en cualquier flujo a través de los nodos «Obtener lista», «Buscar registro» y «Actualizar registro».
✅ **Paso 2: Crea tu flujo y añade el nodo «Obtener lista»**
🆕 Inicia un Flujo\
Desde **Flow Studio:**
Haz clic en Nuevo flujo > Nuevo flujo desde cero
* Nota: Aquí también puedes elegir entre plantillas preconstruidas (por ejemplo, «Actualizar contacto y registrar llamada en HubSpot»).
🔌 Añade el Nodo «Obtener Lista»\
Una vez dentro de tu flujo:
* Busca «Obtener Lista» en la barra lateral derecha.
* Arrástralo al lienzo
**Conectar al Trigger** \
Conecta el nodo **Trigger** al nodo **Obtener Lista** arrastrando desde la parte inferior del Disparador hasta la parte superior de Obtener Lista.
⚡ **Acerca del Nodo Disparador**
Cada flujo nuevo de Dapta comienza con un nodo Disparador. \
Esto es lo que inicia el flujo cuando se cumple una condición.
Hay dos tipos principales de disparadores:
* **Webhook (Solicitud HTTP)** – \
Inicia el flujo cuando un servicio externo envía una solicitud a esta URL. Útil para sincronizar datos de CRMs como HubSpot o responder a acciones del usuario.
* **Programación** – \
Ejecuta el flujo automáticamente en una programación (ej. diariamente, cada hora).
Para este caso de uso, estamos usando un **Disparador Webhook** con un método `GET` para que el flujo se active cuando se envíe una solicitud GET a la URL de Webhook proporcionada.
Aprende más sobre [LINK Triggers](https://docs.dapta.ai/flow-studio/setting-up-triggers-in-flow-studio)
**Configure el Get List Node**
* **Credenciales:** Selecciona tu cuenta autorizada de HubSpot.
* **Lista:** Elige la lista de contactos que deseas recuperar. \
🔗[Learn More about HubSpot Lists](https://knowledge.hubspot.com/lists/create-active-or-static-lists)
* **Propiedades de salida (opcional):** Define qué campos quieres extraer (por ejemplo: `email`, `company`, `createdate`, etc.).
Esto configura tu flujo para extraer una lista de contactos de HubSpot cada vez que se active.
**🔁 Paso 3: Agregar el Nodo "Loop List" (Acción Dapta)**
Ahora que hemos extraído tus contactos de HubSpot, necesitamos iterar a través de ellos uno por uno.
* **Buscar y Agregar Nodo**\
En el panel de **Acciones**, busca `Loop List`. \
Lo verás etiquetado como una **Acción Dapta**. \
Arrástralo al lienzo.
* **Conectalo**\
Conecta el nodo `Get List` al nodo `Loop List` para comenzar a iterar a través de tu lista de contactos.
* **Configurar el Bucle** \
En el campo **Lista de Elementos a Procesar**, ingresa: `{{get_list.response.results}}` Esto le dice a Dapta que itere sobre cada contacto en la lista. Cada elemento será accesible con la variable `item` en los siguientes pasos.\
**📞 Paso 4: Agregar el Nodo "Dapta Phone Call"** \
Ahora que estamos iterando a través de cada contacto, es hora de realizar las llamadas.
**Buscar y Agregar Nodo** \
En el panel de Acciones, busca `Dapta Phone Call`.
Arrástralo al lienzo y conéctalo al nodo Loop List.\
\
**Configurar la Llamada** \
Haz clic en el nodo para establecer tus parámetros de llamada:
* Elige tu **Agente de Voz**
* Puedes mapear las variables como `{{item.firstname}}`, `{{item.phone}}`, etc.
* Ajusta la velocidad de llamada y lógica de reintentos si es necesario \
🔗 Aprende más sobre [Configuración de Agente de Voz](https://docs.dapta.ai/ai-voice-agents/how-to-set-up-your-ai-voice-agent/voice-agent-settings-guide)
Este nodo marcará cada contacto en tu lista de HubSpot usando el agente de voz seleccionado, uno a la vez.
**📤 Paso 4: Configurar Recuperación de Datos Post-Llamada**
🔗 Aprende Información de [Extracción de tus Llamadas](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/como-extraer-informacion-de-tus-conversaciones)
**1. Ve a la Configuración de tu Agente** \
Abre tu agente en Dapta, \
luego navega a la pestaña **Análisis de Llamadas**.
**2. Selecciona un Flujo de Análisis de Llamadas** \
Haz clic en **"Seleccionar Flujo de Análisis de Llamadas"** y elige un flujo Dapta que hayas creado.
**3. Opcional Agregar Campos Post-Llamada**
Bajo **Recuperación de Datos Post-Llamada**, haz clic en **"+ Agregar"** para definir las percepciones que quieres extraer.
Campos de ejemplo:
* `detailed_call_summary` → *"Da un resumen detallado de la llamada respecto a los detalles de la llamada."*
* `reason_to_buy` → *"¿Cuál fue la razón principal por la que el contacto estaba interesado?"*
Estas instrucciones guían a la IA sobre qué extraer después de que termine la llamada.
**4. Construir el Nuevo Flujo Receptor**
Crea un nuevo flujo Dapta para manejar datos post-llamada entrantes:
* Comienza con un **Disparador Webhook**
* Método: `POST`
* Acepta parámetros como: `event`, `call`, y `data`
* Agrega tu lógica para actualizar tu CRM usando valores de:
* `call_analysis.call_summary`
* `call_analysis.custom_analysis_data.detailed_call_summary`, etc.
**✅ Paso Final: Conectar el Nodo de Registro de HubSpot**
Para enviar los datos analizados de la llamada a tu CRM, conecta el nodo final **Log Phone Call**.
**Campos Requeridos:**
* **Datos de Llamada:** `{{trigger.body.call}}` \
⚠️ *Importante:* \
Esto debe establecerse en `trigger.body.call`. Dapta maneja algunas mecánicas de actualización de CRM en segundo plano, por lo que esta estructura específica es requerida para que el registro funcione correctamente.
* **Nombre de Llamada:** `{{trigger.body.call.call_id}}`
* **ID de Contacto HubSpot o Número de Teléfono:** `{{trigger.body.call.to_number}}`
**🧪 Probar y Depurar Registro Post-Llamada**
1. **Abre el Flujo**
* Ve a tu flujo activado por webhook que recibe datos post-llamada.
2. **Ejecuta una Ejecución Anterior**
* Ve a la pestaña **Ejecuciones** en tu Flujo de Análisis de Llamadas.
* Haz clic en el ícono 👁️ en una ejecución exitosa.
* En el panel **Request Body**, \
haz clic en **"Copiar a entrada."**\
**Ver Solicitud Enviada**
* Expande el panel **Request Body** para inspeccionar exactamente qué datos se enviaron.
3. **Activar el Flujo de Registro**
* Presiona **"Ejecutar Flujo"**
4. **Confirmar Registro de CRM**
* Verifica los Contactos de HubSpot para confirmar que la llamada se registró correctamente.
* ✅ **Una vez que el flujo se ejecute exitosamente,** \
**la llamada se registrará dentro de la línea de tiempo de actividad del contacto en HubSpot.**
---
# Agent Instructions: 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:
```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-voz-ia/sesiones-practicas/llamadas-y-registro-de-clientes-potenciales-de-hubspot.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
