> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar HubSpot

> Conecta tu HubSpot para que tu agente busque contactos, los dé de alta, abra negocios y deje notas mientras habla.

Conectar HubSpot hace que cada conversación quede registrada donde tu equipo ya trabaja. Tu agente reconoce a quien llama, da de alta a quien es nuevo, abre el negocio cuando hay intención de compra y deja la nota de lo que se acordó.

El resultado práctico: nadie tiene que capturar a mano lo que pasó en la llamada, y el seguimiento arranca con contexto en vez de con una nota vacía.

## Qué necesitas antes de empezar

* Una cuenta de **HubSpot** con permisos para crear y editar contactos y negocios.
* Plan **Starter** o superior en Ryvo, con el módulo Engine activo.
* Si tu HubSpot tiene varios *accounts*, ten claro en cuál debe escribir tu agente: la autorización se hace sobre uno.

## Cómo conectarla

<Steps>
  <Step title="Abre Configuración › Integraciones">
    En el portal, entra a **Configuración** y después a **Integraciones**. Busca la tarjeta de **HubSpot**.
  </Step>

  <Step title="Da clic en Conectar app">
    Se abre la pantalla de autorización de HubSpot en una ventana nueva. La tarjeta queda mientras tanto en **En curso**.
  </Step>

  <Step title="Elige el account y autoriza">
    Selecciona el account de HubSpot donde quieres que escriba tu agente y acepta los permisos.
  </Step>

  <Step title="Vuelve a Ryvo">
    Regresas solo a la pantalla de Integraciones y la tarjeta pasa a **Conectada**. HubSpot no te pide nada más.
  </Step>
</Steps>

## Lo que tu agente puede hacer ya conectada

| Acción                  | Qué hace en la conversación                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Buscar contacto**     | Busca a la persona por correo, teléfono o nombre. Es lo primero que hace, para no duplicar a quien ya existe. |
| **Crear contacto**      | Da de alta a la persona cuando la búsqueda no la encontró.                                                    |
| **Actualizar contacto** | Corrige o completa datos de un contacto que ya localizó.                                                      |
| **Crear negocio**       | Abre un negocio en el pipeline cuando hay intención real de compra, asociado al contacto.                     |
| **Dejar nota**          | Guarda lo relevante de la conversación, para que quien dé seguimiento sepa qué pasó.                          |

Las acciones no se prenden solas. Entra a la integración con **Ver acciones** y enciende las que quieras en la sección [**Tools**](/es/guides/agents/tools) del constructor de cada agente, con un tope de **10 acciones de integración por agente**.

## Qué hacer si algo falla

| Lo que ves                                            | Qué pasó                                                                                | Qué hacer                                                                                           |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| La tarjeta se quedó en **En curso**                   | Cerraste la ventana de HubSpot antes de terminar                                        | Da **Comprobar de nuevo**. Si sigue igual, vuelve a dar **Conectar app** y completa la autorización |
| **La cuenta dejó de responder. Vuelve a conectarla.** | Alguien desinstaló la app desde HubSpot, o el usuario que autorizó perdió permisos      | Da **Reconectar** y autoriza con un usuario que sí pueda crear contactos y negocios                 |
| Aparecen contactos duplicados                         | La acción **Buscar contacto** no está prendida, así que el agente crea sin buscar antes | Enciéndela en el constructor, sección **Tools**, junto con **Crear contacto**                       |