> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Configurar HubSpot
> Configura el intercambio de datos entre CloudTalk y HubSpot para que tu información se mantenga siempre actualizada.
En este artículo te explicamos cómo conectar HubSpot con CloudTalk, configurar los ajustes de sincronización y entender cómo se mapean los datos entre los dos sistemas.
**Nivel de usuario:** Admin
***
Antes de empezar
* Debes ser Admin en CloudTalk.
* Debes tener permiso para instalar aplicaciones en HubSpot.
* La dirección de correo electrónico que uses en CloudTalk debe coincidir exactamente con la dirección de correo electrónico de tu cuenta de HubSpot. Si los correos no coinciden, la sincronización no funcionará correctamente.
* Los agentes de CloudTalk deben tener la misma dirección de correo electrónico que su usuario de HubSpot.
* Cuando conectas HubSpot por primera vez, CloudTalk importa tus deals y tickets junto con tus contactos. Los registros importados no se pueden eliminar de forma masiva más adelante.
Conectar HubSpot con CloudTalk
1. Desde tu [Dashboard](https://dashboard.cloudtalk.io), ve a **Cuenta** > **Integraciones**.
2. En la lista de integraciones, pasa el cursor sobre **HubSpot** y selecciona **`+ Añadir`**.
3. Se te redirigirá a la página de inicio de sesión de HubSpot para que introduzcas tus credenciales.
4. Si tienes varias cuentas de HubSpot, se te pedirá que elijas una para integrarla con CloudTalk.
5. **Connect app** para conceder los permisos y continuar.
6. Tras completar la autenticación correctamente, volverás al dashboard de CloudTalk, donde podrás personalizar tu integración.
7. Haz clic en **Guardar** para aplicar los cambios y activar la integración.
1. *Puedes poner la integración en Inactiva en cualquier momento con el interruptor de la parte superior.*
Una vez configurada la integración, todos tus contactos de HubSpot se sincronizarán con CloudTalk. Cuando cambia el **propietario de un contacto en HubSpot**, CloudTalk actualiza en consecuencia el **Agente favorito** del contacto (siempre que ese usuario exista como agente en CloudTalk).
Las [Automatizaciones de flujo de trabajo](/es/articles/5450779-configuring-workflow-automations) de CloudTalk solo funcionan con la **integración de HubSpot creada más recientemente**. Aunque configures varias integraciones de HubSpot, los cambios en la estructura de autenticación de HubSpot hacen que solo la última integración funcione con las automatizaciones de flujo de trabajo.
Personalización de la integración
* **Elige qué llamadas se registrarán en HubSpot**. Puedes definir qué llamadas *(llamadas entrantes, llamadas salientes, llamadas perdidas y buzones de voz)* se registran en HubSpot. La llamada se registrará como un engagement de HubSpot.
* Elige si CloudTalk debe crear una actividad de llamada en HubSpot **cuando se responde la llamada** o **cuando termina la llamada**. Puedes elegir cuándo debe crear CloudTalk una actividad de llamada en HubSpot:
* **Respondido**: la actividad de llamada se creará en HubSpot en cuanto se descuelgue la llamada.
* **Finalizado**: la actividad de llamada se creará solo cuando la llamada haya terminado (comportamiento predeterminado).
Este ajuste te da flexibilidad: por ejemplo, si tu equipo quiere ver las llamadas en HubSpot de inmediato o activar flujos de trabajo de HubSpot en cuanto empieza una llamada, usa la opción **Respondido**.
* **Vincula a tu integración de HubSpot solo la actividad de determinados números** mediante la sección *Connected numbers*. Si dejas esta sección en blanco, se sincronizarán los datos asociados a todos los números de la empresa.
* Decide si quieres **registrar todas las llamadas** o **solo las llamadas realizadas dentro del horario comercial**, y a quién asignar las **llamadas perdidas.** Personaliza cómo **se crean nuevos contactos para los números no asociados**.
* **Elige cómo se asocian las actividades de llamada y SMS con las empresas de HubSpot** mediante el ajuste **Estrategia para registrar llamadas en las empresas de HubSpot**. Esto controla si las actividades de llamada (y de SMS) se registran también en los registros de empresa vinculados al contacto coincidente:
* **No registrar en una empresa**: la actividad solo se registra en el contacto, el deal y el ticket (igual que antes de esta función).
* **Registrar en la empresa principal**: la actividad se registra también en la empresa principal del contacto en HubSpot.
* **Registrar en todas las empresas**: la actividad se registra en todas las empresas vinculadas al contacto en el momento de la exportación.
Las **integraciones nuevas** usan de forma predeterminada *Registrar en la empresa principal*. Las **integraciones existentes** usan de forma predeterminada *No registrar en una empresa*; el comportamiento no cambia a menos que modifiques este ajuste. Las mismas opciones están disponibles para SMS en **Configuración del flujo de trabajo para SMS**.
⚠️ Este ajuste solo se aplica a las actividades exportadas después de configurarlo. Las llamadas y los SMS anteriores no se asocian de forma retroactiva a los registros de empresa.
* Reproduce las grabaciones de llamadas y consulta las transcripciones directamente en HubSpot como **call engagements**.
* Especifica una **etiqueta** para tus contactos de HubSpot en CloudTalk e **importa casos** desde HubSpot como actividades de contacto.
- Activa el registro de llamadas de **VoiceAgent** y elige qué usuario debe asignarse a las llamadas de VoiceAgent registradas. Estas llamadas aparecen en HubSpot con la etiqueta "Voice Agent Call".
Mapa de resultados
CloudTalk puede rellenar el campo **HubSpot Activity Outcome** de tres formas distintas, según tu configuración.
Disposición por tipo de llamada
En **Configuración del flujo de trabajo**, puedes definir un resultado predeterminado para cada tipo de llamada con la opción\
"\ disposition as".
Esto te permite asignar un HubSpot Activity Outcome concreto para:
* Llamadas entrantes
* Llamadas salientes
* Llamadas perdidas
* Buzones de voz
Este ajuste funciona como lógica de reserva si no se aplica ningún otro mapa de resultados.
Mapa de resultados basado en etiquetas
Dentro de la sección **Mapa de resultados**, puedes asignar etiquetas de llamada de CloudTalk a HubSpot Activity Outcomes concretos.
Cuando se aplica a una llamada una etiqueta mapeada, se usará el resultado de HubSpot correspondiente.
Si se aplican varias etiquetas mapeadas a la misma llamada, el resultado lo determina la primera que aparezca en la tabla de Mapa de resultados. Puedes arrastrar y soltar los resultados para reordenarlos.
También puedes configurar un resultado predeterminado que se usará si no hay ninguna etiqueta mapeada.
Mapeo de disposiciones de campaña
Si usas el marcador de campañas de CloudTalk, puedes asignar las disposiciones de campaña a HubSpot Activity Outcomes mediante la columna **Mapeo de Integración** en **[Configuración de Disposiciones](/es/articles/9562215-using-hubspot-with-campaign-dialers#:~:text=PM%20each%20day.-,Disposition%20Mapping%20to%20HubSpot%20Outcomes,-%E2%9A%A0%EF%B8%8F%20Important%3A)**.
Si una disposición de campaña está asignada a un resultado de HubSpot, ese valor se usará para la llamada.
Lógica de prioridad de los resultados
Si se aplican varias configuraciones a la misma llamada, el HubSpot Activity Outcome se determina según el siguiente orden de prioridad:
1. **Mapeo de disposiciones de campaña** (prioridad más alta)
2. **Mapa de resultados basado en etiquetas**
3. **Ajuste de tipo de llamada del flujo de trabajo** (reserva)
De dónde proceden los resultados de llamada de HubSpot
CloudTalk obtiene los resultados de llamada de HubSpot de los ajustes internos de Calling de HubSpot. Estos resultados proceden del campo de sistema llamado `hs_call_disposition`, que HubSpot utiliza para almacenar los resultados de llamadas y reuniones.
En CloudTalk solo pueden aparecer los resultados creados en los ajustes de Calling Outcome de HubSpot. Crear "Call Outcomes" como una propiedad personalizada del CRM no funcionará, ya que CloudTalk no lee los resultados de propiedades personalizadas.
HubSpot permite a los clientes gestionar los resultados de llamada directamente en los ajustes de Calling. Los resultados de llamada personalizados deben crearse en la interfaz de HubSpot.
Para más información, consulta la [guía de HubSpot sobre cómo crear resultados de llamada personalizados](https://knowledge.hubspot.com/calling/create-custom-call-and-meeting-outcomes).
**Llamar desde HubSpot**
Sigue la [guía CTI de HubSpot](https://knowledge.hubspot.com/calling/integrate-a-third-party-calling-provider-with-hubspot) para configurar CloudTalk como tu teléfono principal en HubSpot, y consulta nuestras guías sobre [cómo usar el CTI de HubSpot](/es/articles/5368689-cloudtalk-phone-in-hubspot) y [soluciones rápidas](/es/articles/8272721-hubspot-quick-fixes).
Sincronización de datos y mapeo de campos
Mapeo de contactos nuevos
\* = campo obligatorio
| **Contacto de CloudTalk** | **Dirección de sincronización** | **Contacto de HubSpot** |
| - | - | - |
| Nombre completo\* (el nombre de pila es solo la primera palabra) | ⬅➡ | First name\* y Last name\* |
| Número(s) de teléfono\* (solo el 1.º y el 2.º número) | ⬅➡ | Phone number (número principal y número de móvil) |
| Email\* (solo la primera dirección de correo electrónico) | ⬅➡ | Email\* (solo el correo electrónico principal) |
| Empresa | ➡ | Company name (no una empresa de HubSpot vinculada) |
| Dirección | ➡ | Street address |
| Ciudad | ➡ | City |
| Código postal | ➡ | Postal code |
| Provincia | ➡ | State/region |
| Agente favorito | ⬅ | Contact owner (solo direcciones de correo electrónico de agentes de CloudTalk existentes) |
| Etiquetas (a nivel de contacto) | 🚫 | No se sincronizan como propiedades de contacto |
| Campos personalizados | 🚫 | No se sincronizan |
Actualizar un contacto en Hubspot
\* = campo obligatorio
| Contacto de CloudTalk | Actualizado | Contacto de HubSpot |
| - | - | - |
| Nombre completo\* (el nombre de pila es solo la primera palabra) | ⬅ | First name\* y Last name\* |
| Teléfono\* (añade otro número y conserva los anteriores) | ⬅ | Phone number (números principal y móvil) |
| Email (añade otra dirección de correo electrónico y conserva las anteriores) | ⬅ | Email\* (solo la dirección de correo electrónico principal) |
| Empresa | 🚫 | Company name o Company asociada |
| Dirección | 🚫 | Street address |
| Ciudad | 🚫 | City |
| Código postal | 🚫 | Postal code |
| Provincia | 🚫 | State/region |
| Agente favorito | ⬅ | Contact owner |
| Etiquetas (a nivel de contacto) | 🚫 | No se sincronizan |
| Campos personalizados | 🚫 | No se sincronizan |
***
💡 *¿Quieres desactivar la sincronización de contactos de CloudTalk a HubSpot?* Nuestro equipo de ingeniería puede ajustar esta opción en el backend por ti. Como no hay ningún interruptor en la configuración de la aplicación, basta con que envíes una solicitud a nuestro [equipo de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) para desactivar la exportación de actualizaciones de contactos
Actualizar un contacto en CloudTalk
\* = campo obligatorio
| **Contacto de CloudTalk** | **Actualizado** | **Contacto de HubSpot** |
| - | - | - |
| Nombre completo\* (el nombre de pila es solo la primera palabra) | ➡ | First name\* y Last name\* |
| Teléfono\* (editar la primera opción actualiza el número principal) | ➡ | Phone number (números principal y móvil) |
| Email (editar la primera opción actualiza la dirección de correo electrónico principal) | ➡ | Email\* (solo la dirección de correo electrónico principal) |
| Empresa | ➡ | Company (no una empresa de HubSpot vinculada) |
| Dirección | ➡ | Street address |
| Ciudad | ➡ | City |
| Código postal | ➡ | Postal code |
| Provincia | ➡ | State/region |
| Agente favorito | 🚫 | Contact owner |
| Etiquetas (a nivel de contacto) | 🚫 | No se sincronizan |
| Campos personalizados | 🚫 | No se sincronizan |
⚠️ Si un contacto de CloudTalk no tiene nombre y se asocia a un contacto de HubSpot por número de teléfono, una sincronización puede borrar el nombre en HubSpot. Para evitarlo, asegúrate de que tus contactos de CloudTalk tengan el nombre guardado, o ponte en contacto con [atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) para desactivar las actualizaciones de contactos de CloudTalk a HubSpot.
Cómo evitar la pérdida de datos en campos personalizados con la sincronización y las automatizaciones de HubSpot
Cuando la **sincronización entrante de contactos de HubSpot** está activada, usar las Automatizaciones de flujo de trabajo de CloudTalk para actualizar propiedades de contacto puede borrar sin querer tus campos personalizados exclusivos de CloudTalk.
**Cómo se produce la sobrescritura**
1. Una **[Automatización de flujo de trabajo](/es/articles/10568412-workflow-automations-guide)** (o una herramienta externa como Zapier/n8n) edita un contacto en CloudTalk.
2. CloudTalk emite un evento `contact edited`.
3. La integración de HubSpot detecta el evento y fuerza una nueva sincronización del contacto usando la **versión de HubSpot** del contacto.
4. Como HubSpot no registra los campos personalizados exclusivos de CloudTalk, sobrescribe esos campos en CloudTalk con valores vacíos.
*Nota: editar un contacto manualmente en CloudTalk no desencadena este bucle de sincronización.*
**Acciones recomendadas**
* **Revisa tus automatizaciones:** elimina las acciones de edición de contactos innecesarias de tus Automatizaciones de flujo de trabajo de CloudTalk, o ajusta los activadores para evitar actualizaciones de contactos.
* **Revisa las herramientas externas:** ten cuidado al usar Zapier o n8n para rellenar campos exclusivos de CloudTalk si una automatización de CloudTalk edita ese mismo contacto justo después.
* **Contactar con soporte:** [ponte en contacto con el equipo de atención al cliente de CloudTalk](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) para que revise tu configuración o aplique ajustes de sincronización en el backend.
⚠️ Este comportamiento está relacionado con una incidencia conocida de ingeniería. Si los campos personalizados están desapareciendo a gran escala en tu cuenta, **pausa de inmediato las automatizaciones afectadas** y ponte en contacto con atención al cliente para evitar más pérdidas de datos.
Desconectar la integración de HubSpot
Si decides dejar de usar HubSpot con CloudTalk, puedes seguir estos pasos para desconectar la integración.
1. Inicia sesión en tu [Dashboard](https://dashboard.cloudtalk.io/) y ve a **Cuenta > Integraciones** en el menú de la izquierda.
2. Esta página muestra tus integraciones actuales. Junto a la integración de HubSpot, selecciona **`Cambiar`**.
3. Baja hasta el final y selecciona **Eliminar integración**.
4. Para confirmar, escribe `DELETE` y selecciona **Eliminar.**
Una vez completados estos pasos, la integración se eliminará de tu dashboard de CloudTalk. Hay pasos adicionales que debes seguir para [eliminar CloudTalk dentro de HubSpot](https://knowledge.hubspot.com/integrations/connect-apps-to-hubspot#uninstall-an-app).
**Advertencia:** si desconectas y desinstalas CloudTalk, dejará de compartirse información como los datos de llamadas con HubSpot y desde HubSpot, lo que también afectará a las cuentas de HubSpot vinculadas y a sus datos.
***
*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aquí para ayudarte.
## Related topics
- [Configurar HubSpot Help Desk](/es/articles/16900799-configure-hubspot-help-desk.md)
- [Usar CloudTalk con HubSpot](/es/articles/14136029-using-cloudtalk-with-hubspot.md)
- [CloudTalk Phone en HubSpot](/es/articles/5368689-cloudtalk-phone-in-hubspot.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.