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

# Uso de HubSpot con los marcadores de campaña

> Configura campañas, sincroniza datos y exporta llamadas integrando HubSpot con los marcadores de campaña.

<Note>
  Descubre cómo usar HubSpot con los marcadores de campaña: desde la importación de listas de contactos y la sincronización de audiencias hasta la configuración de campañas y la exportación de datos de llamadas.
</Note>

**Nivel de usuario:** Administrador, Agente, Supervisor

***

Integrar **HubSpot** con el **Marcador de CloudTalk** o el Marcador Automático ayuda a los equipos de ventas y de atención al cliente a trabajar de forma más eficiente, ya que simplifica los flujos de trabajo de las llamadas y automatiza la introducción de datos. En lugar de registrar manualmente los resultados de las llamadas, la integración actualiza automáticamente los **Activity Outcomes de HubSpot** según las disposiciones de llamada.

Con esta configuración, los equipos pueden centrarse más en las conversaciones que generan resultados en lugar de dedicar tiempo a tareas administrativas. Al sincronizar listas de contactos, hacer seguimiento de la actividad de llamadas y automatizar los seguimientos, las empresas mejoran los tiempos de respuesta y mantienen un registro preciso de cada interacción en HubSpot.

<h2 id="h_839adf6d63">
  Requisitos previos
</h2>

Para utilizar esta configuración, necesitas:

* un rol de **Administrador** o **Supervisor** en CloudTalk

* una [integración de HubSpot](/es/articles/3206271-configure-hubspot) activa

* Una o más [listas de contactos en HubSpot](https://knowledge.hubspot.com/lists/create-active-or-static-lists#types-of-lists) visibles para todo el mundo (sin restricciones de acceso)

<h2 id="h_62c0342c0a">
  Importar la audiencia de la campaña desde una lista de contactos
</h2>

Para configurar una campaña con una audiencia importada de HubSpot, sigue estos pasos para conectar tu lista de HubSpot y sincronizar los contactos directamente en la campaña.

1. Ve a **Marcador > Campañas**, haz clic en **`+ Añadir campaña`** y configura la campaña según tus necesidades.

2. En *Configuración básica*, hay dos opciones para añadir contactos a tu campaña.

   1. En **Contactos de tu CRM**, selecciona **Lista de contactos del CRM**.

   2. Escribe o desplázate para buscar y seleccionar la lista que quieras por su nombre.

   3. *Los nombres de lista entre los que puedes elegir provienen de las listas de contactos de HubSpot.*

      <Frame>
        <img src="https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9562215/8da380abb62e-screenshot-2025-03-20-at-15-50-57.png?fit=max&auto=format&n=xe2f6HmqhdjOgyCe&q=85&s=771f51f1f7f3c07f96bef36241334ea8" alt="" width="2712" height="925" data-path="images/help-center/articles/9562215/8da380abb62e-screenshot-2025-03-20-at-15-50-57.png" />
      </Frame>

3. Selecciona **Crear campaña** y **Confirmar** para finalizar los cambios.

   1. Los contactos de la lista o listas seleccionadas en HubSpot se añadirán automáticamente como contactos de la campaña.

<Warning>
  Solo se añaden a la campaña los contactos que tienen **al menos un número de teléfono**. A los contactos de tu lista de HubSpot sin número de teléfono no se les puede llamar, por lo que no se añaden ni se cuentan en el total de contactos de la campaña. Por eso tu campaña puede mostrar menos contactos que tu lista de HubSpot. Para incluirlos, añade un número de teléfono a esos contactos en HubSpot (o en CloudTalk) y se recogerán en la siguiente sincronización.
</Warning>

¡Tu campaña está lista! 🚀 Descubre cómo empezar a llamar con la aplicación que prefieras en el artículo [Uso de campañas con el Marcador de CloudTalk](/es/articles/11550309-using-campaigns-with-cloudtalk-dialer-legacy).

<h3 id="h_7f6cd14524">
  Cómo funciona la sincronización de listas de HubSpot
</h3>

CloudTalk mantiene la audiencia de tu campaña alineada con tu lista de HubSpot mediante dos mecanismos de sincronización que se ejecutan con una frecuencia distinta:

<h4 id="h_2bf1f0be02">
  Incorporaciones continuas: cada 10 minutos
</h4>

Cada 10 minutos, CloudTalk consulta a HubSpot si se han añadido contactos a la lista desde la última comprobación y los añade a la audiencia de la campaña en CloudTalk.

Este paso solo añade contactos. Nunca los elimina.

Los contactos nuevos que entran en tu lista de HubSpot, incluidos los que vuelven a entrar en una lista dinámica (por ejemplo, cuando ya se les puede llamar en su zona horaria), aparecerán en tu campaña en \~10 minutos.

<h4 id="h_b9f50d5817">
  Conciliación diaria: cada 24 horas
</h4>

Una vez cada 24 horas, CloudTalk descarga la lista completa y actual de HubSpot y la concilia con la audiencia de la campaña:

Los contactos que están en la lista de HubSpot pero no en la campaña se añaden.

Los contactos que están en la campaña pero ya no en la lista de HubSpot se eliminan.

Los contactos marcados con **Exclude from CloudTalk campaigns** se omiten, aunque sigan en la lista.

El ciclo de 24 horas empieza en el momento en que se configuró la campaña por primera vez. Si la campaña se creó a las 3:00 PM, la conciliación diaria se ejecuta cada día en torno a las 3:00 PM.

<h4 id="h_f0b9188209">
  Por qué puedes seguir viendo contactos después de vaciar una lista de HubSpot
</h4>

Como las eliminaciones solo se producen durante la conciliación diaria, los contactos que quites de tu lista de HubSpot seguirán en la audiencia de la campaña de CloudTalk hasta que se ejecute el siguiente ciclo de 24 horas. Si vacías la lista a las 9 PM pero la conciliación diaria ya se ejecutó antes ese mismo día, esos contactos permanecerán en la campaña hasta la siguiente conciliación, hasta \~24 horas después. Para dejar de llamar a un contacto concreto de inmediato, usa la propiedad **Exclude from CloudTalk campaigns** que se describe más abajo.

<Tip>
  Si tu lista usa condiciones dinámicas (ventanas TCPA, disponibilidad según la zona horaria, etapa del ciclo de vida, etc.), es normal que los contactos vuelvan a entrar en la lista a medida que empiezan a cumplir esas condiciones. La sincronización de incorporaciones cada 10 minutos los detectará y los añadirá a la campaña, incluso de madrugada. Es el comportamiento esperado.
</Tip>

<h3 id="h_exclude_from_campaigns">
  Eliminar un contacto de todas las campañas de inmediato
</h3>

Si ya no se debe llamar a alguien, no tienes que esperar a la conciliación diaria. Marca el contacto en HubSpot y CloudTalk lo eliminará de todas las campañas vinculadas a tu cuenta de HubSpot, normalmente en menos de un minuto.

<h4 id="h_exclude_setup">
  Configuración inicial: crea la propiedad de exclusión en HubSpot
</h4>

CloudTalk busca una propiedad de contacto concreta en tu cuenta de HubSpot. No se crea automáticamente, así que un administrador de HubSpot tiene que añadirla una vez:

1. En HubSpot, ve a **Settings > Properties** y selecciona el objeto **Contact**.

2. Haz clic en **Create property**.

3. Establece la etiqueta como **Exclude from CloudTalk campaigns**.

4. Establece el nombre interno exactamente como `cloudtalk_exclude_from_campaign`.

<Warning>
  **Importante:** de forma predeterminada, HubSpot genera un nombre interno distinto a partir de la etiqueta, así que edítalo antes de guardar. CloudTalk solo reconoce este nombre exacto. Elige el tipo de campo **Single checkbox** y guarda.
</Warning>

<Warning>
  Sin esta propiedad, los contactos solo se eliminan durante la conciliación diaria. El nombre interno debe coincidir exactamente, incluidos los guiones bajos.
</Warning>

<h4 id="h_exclude_flag">
  Marcar un contacto
</h4>

Marca la casilla **Exclude from CloudTalk campaigns** en el registro del contacto en HubSpot o haz que un workflow de HubSpot la establezca en `true`. CloudTalk comprueba el valor directamente en HubSpot y elimina el contacto de todas tus campañas. No hay que hacer nada en CloudTalk.

<h4 id="h_exclude_restore">
  Volver a incluir un contacto
</h4>

Desmarca la casilla. El contacto vuelve a ser elegible y la sincronización habitual de listas lo añade de nuevo si sigue en una lista sincronizada.

<h4 id="h_exclude_good_to_know">
  Conviene saber
</h4>

* Solo se elimina la pertenencia a la campaña. El contacto y sus datos permanecen en HubSpot y en CloudTalk.

* La marca es global: el contacto sale de todas las campañas de tu cuenta de HubSpot, no de una lista concreta.

* La conciliación diaria también respeta la marca, por lo que la sincronización nunca vuelve a añadir los contactos marcados.

* Las ediciones masivas se procesan a un ritmo de hasta 1.000 contactos cada 5 minutos por cuenta de HubSpot. Todo lo que supere ese límite se elimina durante la siguiente conciliación diaria. Todos los contactos marcados se eliminan, solo que no todos en el mismo minuto.

<h2 id="h_1094bdd021">
  Mapeo de disposiciones a los Outcomes de HubSpot
</h2>

<Warning>
  ⚠️ **Importante:** actualmente, el mapeo de disposiciones funciona **solo** con el **Marcador de CloudTalk**. Si usas el **Marcador Automático**, los mapeos de integración, como los tipos de actividad personalizados o la exportación de resultados de llamada, **no son compatibles** por el momento.
</Warning>

El **mapeo de disposiciones a los Outcomes de HubSpot** te permite sincronizar las disposiciones asignadas a las llamadas de campaña en CloudTalk directamente con el campo **Activity Outcome** de HubSpot, lo que garantiza informes precisos y coherentes en las dos plataformas.

1. Ve a la pestaña **Configuración de Disposiciones**.

2. Crea las disposiciones de tu campaña.

3. Usa el menú desplegable **Mapeo de Integración** para vincular cada disposición con el **Activity Outcome de HubSpot** correspondiente.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9562215/f1a8f355158b-screenshot-2025-02-21-at-11-15-42.png?fit=max&auto=format&n=xe2f6HmqhdjOgyCe&q=85&s=132041dbf127e8e80dcd9421cceaa481" alt="" width="2143" height="967" data-path="images/help-center/articles/9562215/f1a8f355158b-screenshot-2025-02-21-at-11-15-42.png" />
   </Frame>

4. Guarda la configuración para sincronizar automáticamente los resultados de las llamadas.

<h2 id="h_6bf421cd1e">
  Exportar las llamadas del Marcador a HubSpot
</h2>

Cuando las llamadas se realizan a través de una campaña, CloudTalk exporta los siguientes datos a HubSpot:

* Si están mapeadas, las **disposiciones de llamada** se registran automáticamente como **Activity Outcomes de HubSpot**

  <Frame>
    <img src="https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9562215/14e1e1bcc324-screenshot-2025-02-21-at-13-19-38.png?fit=max&auto=format&n=xe2f6HmqhdjOgyCe&q=85&s=e3bc3963e786f6840f9c66392c454021" alt="" width="2488" height="595" data-path="images/help-center/articles/9562215/14e1e1bcc324-screenshot-2025-02-21-at-13-19-38.png" />
  </Frame>

* Detalles estándar de la llamada, incluidos el **tiempo de conversación, el tiempo de trabajo posterior a la llamada, los contactos vinculados, los usuarios y los deals**

  <Frame>
    <img src="https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9562215/dc3d5a054bd9-screenshot-2025-02-21-at-13-22-14.png?fit=max&auto=format&n=xe2f6HmqhdjOgyCe&q=85&s=c36df48e86b8e0f7c721a63f62578ff0" alt="" width="300" data-path="images/help-center/articles/9562215/dc3d5a054bd9-screenshot-2025-02-21-at-13-22-14.png" />
  </Frame>

* Datos de [Conversation Intelligence](/es/articles/9128167-conversation-intelligence) (si está activada) para facilitar la toma de decisiones basada en 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](/es/articles/3206271-configure-hubspot.md)
- [Usar Zoho CRM con los marcadores de campaña](/es/articles/11503460-using-zoho-crm-with-campaign-dialers.md)
- [Usar Pipedrive con los marcadores de campaña](/es/articles/11508138-using-pipedrive-with-campaign-dialers.md)


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