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

# HubSpot

> Lleva tu CRM, marketing y soporte de HubSpot al flujo conversacional en Brain Studio.

**HubSpot** expone **63 tools** en Brain Studio, cubriendo CRM, marketing, ventas, servicio y automatización en un solo portal. A diferencia de CRMs más enfocados como Pipedrive (pipeline de ventas) o Salesforce (operaciones enterprise), HubSpot abarca desde la captación hasta el lifecycle completo del cliente.

En **Brain Studio**, la integración permite que tus flujos operen sobre contactos, empresas, ofertas, tickets, conversaciones, workflows, formularios, páginas y campañas directamente desde la conversación. La integración permite operar CRM, soporte y marketing directamente desde el canal conversacional.

## Qué habilita HubSpot

Al conectar **HubSpot**, puedes:

* **Cerrar el ciclo comercial desde la conversación** — capturar leads, mover ofertas, abrir tickets y registrar actividad sin que el equipo entre al portal
* **Registrar el contexto de cada interacción** — notas, tareas, reuniones e interacciones que reflejan lo que pasó en el canal
* **Operar soporte sobre la bandeja de HubSpot** — leer hilos, responder mensajes y dejar comentarios en el contexto del caso
* **Activar marketing desde el flujo** — inscribir contactos en workflows, agregar a listas, operar campañas y gestionar landing pages
* **Escalar con operaciones masivas y objetos personalizados** — sincronizar en lote y trabajar sobre el modelo de datos extendido del portal

***

## Instalación

### Requisitos previos

1. Una **cuenta de HubSpot** (portal) con los **módulos y permisos** que correspondan a las áreas que vas a usar (CRM, marketing, servicio, etc.).
2. Permiso para **instalar aplicaciones conectadas** o autorizar OAuth en nombre de la organización, si tu administrador lo exige.
3. Claridad sobre **qué objetos y áreas** usarás en producción: muchas tools dependen de que el portal tenga activado el producto adecuado (por ejemplo **Conversations** o **Marketing Hub**).

### Cómo conectarla

La forma más directa es usar [**Jelou Agent**](/guides/getting-started/jelou-agent): describe lo que necesitas y el agente conecta **HubSpot** automáticamente dentro del flujo.

Si prefieres instalar manualmente, sigue estos pasos en el **Marketplace**. La conexión usa **OAuth de HubSpot**; no necesitas copiar credenciales.

<Steps>
  <Step title="Abrir el Marketplace">
    En Brain Studio, abre **Marketplace** desde el menú lateral.
  </Step>

  <Step title="Buscar HubSpot">
    Encuentra la integración y haz clic en **Conectar**.
  </Step>

  <Step title="Autorizar con HubSpot">
    Inicia sesión en HubSpot y acepta los permisos que solicita la aplicación.
  </Step>

  <Step title="Confirmar instalación">
    La integración aparecerá como **conectada**.

    <Check>
      Puedes usarla en **Canvas** o agregarla como herramienta en **AI Agent**.
    </Check>
  </Step>
</Steps>

***

## Tools disponibles

La integración expone **63 tools** en Brain Studio. Para mantener esta página legible, las agrupamos por **categorías funcionales**. Abre cada bloque para ver las tools incluidas y el tipo de proceso que resuelven dentro de HubSpot.

<AccordionGroup>
  <Accordion title="CRM base">
    Gestiona el núcleo del CRM: contactos, empresas, ofertas, leads y tickets.

    **Tools incluidas**

    * Crear o Actualizar Contacto
    * Actualizar Contacto
    * Obtener datos de contacto
    * Agregar Contacto a la Lista
    * Crear Empresa
    * Obtener Empresa
    * Actualizar Empresa
    * Crear Oferta
    * Obtener oferta
    * Actualizar oferta
    * Crear Lead
    * Actualizar cliente potencial
    * Crear Ticket
    * Buscar en CRM

    **Cuándo usar esta categoría**

    * Cuando necesitas registrar o enriquecer leads
    * Cuando quieres crear o mover oportunidades en el pipeline
    * Cuando necesitas abrir tickets o consultar datos del CRM durante una conversación

    **Ideal para**
    Ventas, CRM ops y soporte con HubSpot como sistema principal.
  </Accordion>

  <Accordion title="Operaciones masivas">
    Ejecuta altas y actualizaciones sobre múltiples registros de una sola vez.

    **Tools incluidas**

    * Creación de empresas en lote
    * Actualización por lotes de empresas
    * Actualización/Inserción en lote de empresas
    * Creación o actualización masiva de contactos

    **Cuándo usar esta categoría**

    * Cuando recibes datos desde otro sistema y necesitas sincronizarlos en volumen
    * Cuando haces limpieza, migración o enriquecimiento masivo
    * Cuando el caso no justifica procesar contacto por contacto

    **Ideal para**
    Migraciones, sincronizaciones y operaciones de data management.
  </Accordion>

  <Accordion title="Asociaciones y relaciones">
    Conecta objetos entre sí y recupera actividad relacionada.

    **Tools incluidas**

    * Crear Asociaciones
    * Obtener correos electrónicos asociados
    * Obtener Reuniones Asociadas

    **Cuándo usar esta categoría**

    * Cuando necesitas vincular contactos, empresas, negocios u otros objetos
    * Cuando quieres recuperar contexto relacional antes de responder o actuar
    * Cuando el valor está en entender el historial conectado, no solo un registro aislado

    **Ideal para**
    Flujos con trazabilidad entre contacto, empresa, deal y actividad.
  </Accordion>

  <Accordion title="Actividades comerciales y seguimiento">
    Registra el trabajo comercial u operativo que ocurre alrededor del CRM.

    **Tools incluidas**

    * Crear interacción
    * Crear reunión
    * Programar Reunión
    * Crear tarea
    * Crear Nota

    **Cuándo usar esta categoría**

    * Cuando quieres dejar constancia de una conversación o gestión comercial
    * Cuando necesitas programar seguimiento o próxima acción
    * Cuando quieres que HubSpot refleje lo que pasó en el canal conversacional

    **Ideal para**
    Equipos comerciales y de customer success que trabajan con timeline de actividad.
  </Accordion>

  <Accordion title="Conversaciones y mensajería">
    Trabaja sobre la capa conversacional de HubSpot: canales, bandejas, hilos y mensajes.

    **Tools incluidas**

    * Obtener canal
    * Listar Canales
    * Obtener bandeja de entrada
    * Listar bandejas de entrada
    * Listar hilos
    * Listar mensajes
    * Enviar mensaje
    * Agregar comentario
    * Crear Comunicación

    **Cuándo usar esta categoría**

    * Cuando necesitas leer el contexto de una conversación antes de actuar
    * Cuando quieres responder o dejar comentarios desde el flujo
    * Cuando tu operación usa la bandeja de conversaciones de HubSpot como punto central

    **Ideal para**
    Soporte, atención al cliente y operaciones conversacionales.
  </Accordion>

  <Accordion title="Marketing y contenido">
    Gestiona piezas de marketing, páginas y activos publicados en HubSpot.

    **Tools incluidas**

    * Crear correo electrónico de marketing
    * Clonar correo de marketing
    * Listar correos electrónicos de marketing
    * Listar campañas
    * Listar Eventos de Marketing
    * Listar publicaciones del blog
    * Crear página
    * Actualizar página
    * Listar páginas
    * Crear página de aterrizaje
    * Actualizar página de aterrizaje
    * Clonar página del sitio web

    **Cuándo usar esta categoría**

    * Cuando quieres automatizar creación o iteración de contenido
    * Cuando necesitas listar o revisar activos activos en marketing
    * Cuando el flujo conversacional dispara acciones sobre campañas, landings o correos

    **Ideal para**
    Marketing ops, growth y equipos que gestionan contenido dentro de HubSpot.
  </Accordion>

  <Accordion title="Formularios y assets">
    Administra formularios, plantillas y archivos asociados a la captación.

    **Tools incluidas**

    * Crear Formulario
    * Formularios de Lista
    * Actualizar campos en el formulario
    * Plantillas de Listas
    * Obtener la URL pública del archivo

    **Cuándo usar esta categoría**

    * Cuando necesitas crear o ajustar formularios desde un flujo
    * Cuando quieres listar assets reutilizables
    * Cuando el proceso requiere exponer un archivo o recurso público

    **Ideal para**
    Captación de leads, automatización de formularios y gestión de assets.
  </Accordion>

  <Accordion title="Workflows y automatización">
    Conecta Brain con la automatización nativa de HubSpot.

    **Tools incluidas**

    * Crear flujo de trabajo de contacto
    * Crear un nuevo flujo de trabajo
    * Eliminar un flujo de trabajo
    * Inscribir contacto en el flujo de trabajo
    * Obtener detalles del flujo de trabajo
    * Recuperar flujos de trabajo
    * Recuperar Mapeos de Flujo de Trabajo Migrados
    * Recuperar correos electrónicos del flujo de trabajo

    **Cuándo usar esta categoría**

    * Cuando quieres activar automatizaciones ya existentes en HubSpot
    * Cuando necesitas inscribir contactos desde una conversación o evento
    * Cuando quieres auditar o consultar workflows y sus componentes

    **Ideal para**
    Marketing automation, lifecycle management y operaciones avanzadas en HubSpot.
  </Accordion>

  <Accordion title="Objetos personalizados y configuración">
    Extiende el modelo de datos y consulta preferencias clave del portal.

    **Tools incluidas**

    * Crear Objeto Personalizado
    * Actualizar Objeto Personalizado
    * Obtener preferencias de suscripción

    **Cuándo usar esta categoría**

    * Cuando tu operación depende de objetos no estándar en HubSpot
    * Cuando necesitas respetar preferencias de comunicación antes de actuar
    * Cuando el flujo debe trabajar sobre configuración más avanzada del portal

    **Ideal para**
    Implementaciones maduras de HubSpot con modelo de datos extendido.
  </Accordion>
</AccordionGroup>

***

## Cómo usar en Brain

Con **63 tools**, la integración es **amplia**: en cada flujo conviene **habilitar solo** las herramientas necesarias (CRM, conversaciones, marketing, workflows, etc.) para reducir errores, ruido y coste de tokens.

**AI Agent** encaja cuando la intención es **abierta** (“registrarme en el CRM”, “inscribirme en la secuencia”, “qué campañas hay”, “responde en la conversación de soporte”). El modelo elige dentro del subconjunto activado; cuanto más alineado esté con tu operación, mejor.

**Canvas** encaja cuando el proceso es **determinista**: por ejemplo **Buscar en CRM** → **Actualizar oferta** → **Crear Nota** → **Inscribir contacto en el flujo de trabajo**. Usa **Guardar respuesta** para pasar IDs y propiedades entre nodos.

### En AI Agent

<Steps>
  <Step title="Abre el nodo AI Agent">
    En el Canvas, selecciona o añade el nodo **AI Agent**.
  </Step>

  <Step title="Abre Herramientas">
    En el panel derecho, entra a la pestaña **Herramientas**.
  </Step>

  <Step title="Agrega HubSpot">
    Usa **Agregar tool**, busca **HubSpot** y actívala.
  </Step>

  <Step title="Configura las tools">
    Elige integración completa o activa solo las categorías de tools que este agente deba usar (evita exponer **workflows** o **marketing** si el canal es solo soporte).

    <Check>
      **HubSpot** aparece en la lista de herramientas del agente y puedes abrir su configuración con el icono de ajustes.
    </Check>
  </Step>
</Steps>

### En Canvas

<Steps>
  <Step title="Arrastra HubSpot al Canvas">
    En el panel lateral, abre **Marketplace** y arrastra **HubSpot** al flujo.
  </Step>

  <Step title="Selecciona la tool">
    Con el nodo seleccionado, en **Tools** elige la acción concreta (cada una corresponde a una de las 63 tools del catálogo).
  </Step>

  <Step title="Configura el cuerpo y la memoria">
    Completa el JSON del cuerpo de la petición y, si aplica, **Guardar respuesta** en una variable de memoria.
  </Step>

  <Step title="Conecta el flujo">
    Enlaza las salidas **Finalizó la tarea** y **Hubo un error** con los nodos siguientes.

    <Check>
      El nodo queda listo para ejecutarse en el orden definido por tu flujo.
    </Check>
  </Step>
</Steps>

**Ejemplo de configuración** para un paso que actualiza una oferta existente usando datos ya guardados en memoria:

```json theme={null}
{
  "deal_id": "{{$memory.id_oferta}}",
  "properties": {
    "dealstage": "qualifiedtobuy",
    "amount": "{{$memory.monto_estimado}}"
  }
}
```

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Del chat al CRM y al pipeline, sin operación manual">
    Este es uno de los casos de uso más representativos de **HubSpot** en Brain Studio: una conversación captura contexto comercial y lo convierte en operación real dentro del portal.

    **Flujo típico:**

    * El usuario conversa por WhatsApp, webchat o un canal interno
    * El flujo identifica si ya existe el registro con **Buscar en CRM** o **Obtener datos de contacto**
    * Crea o actualiza el contacto con **Crear o Actualizar Contacto**
    * Crea o mueve la oportunidad con **Crear Oferta** o **Actualizar oferta**
    * Registra la gestión con **Crear interacción**, **Crear Nota** o **Crear tarea**

    **Impacto:**

    * Menos trabajo manual para ventas y RevOps
    * Pipeline actualizado en tiempo real
    * Mejor trazabilidad entre conversación, contacto y negocio

    **Ideal para:** captación de leads, calificación comercial, seguimiento de oportunidades y operaciones de revenue.
  </Accordion>

  <Accordion title="HubSpot consultable por voz desde WhatsApp para uso interno">
    Un agente interno conectado a WhatsApp permite que líderes comerciales, ejecutivos o usuarios autorizados consulten el CRM en lenguaje natural —incluso por audio— sin entrar a HubSpot.

    **Flujo típico:**

    * Un usuario autorizado envía un mensaje o nota de voz preguntando por un lead, una negociación o el siguiente paso esperado
    * El agente interpreta la consulta y busca la información con **Buscar en CRM**, **Obtener datos de contacto**, **Obtener oferta** o tools relacionadas
    * Resume el estado actual, la etapa, actividad reciente o próxima acción recomendada
    * Si aplica, registra seguimiento con **Crear tarea**, **Crear Nota** o **Crear interacción**

    **Impacto:**

    * Acceso más rápido al CRM para equipo directivo y revenue
    * Menos dependencia de entrar al portal para consultas operativas
    * Mejor seguimiento comercial desde el mismo canal que el equipo ya usa a diario

    **Ideal para:** equipos internos de ventas, revenue, founders y liderazgo comercial que quieren consultar HubSpot de forma conversacional.
  </Accordion>

  <Accordion title="Soporte y conversaciones con contexto completo">
    Cuando HubSpot también es el centro de atención al cliente, Brain puede trabajar no solo sobre el CRM, sino sobre la capa conversacional: bandejas, hilos, mensajes, comentarios y tickets.

    **Flujo típico:**

    * El flujo identifica el contexto del caso con **Listar bandejas de entrada**, **Listar hilos** o **Listar mensajes**
    * Busca o enriquece el registro del cliente en el CRM
    * Abre o actualiza el caso con **Crear Ticket**
    * Deja trazabilidad con **Agregar comentario**, **Crear Nota** o responde con **Enviar mensaje** si el proceso lo requiere

    **Impacto:**

    * Atención más rápida y mejor contextualizada
    * Menos pérdida de información entre soporte y CRM
    * Continuidad real entre conversación, ticket e historial del cliente

    **Ideal para:** soporte, customer success y equipos que operan conversaciones dentro de HubSpot.
  </Accordion>

  <Accordion title="De la captación en chat a marketing y automatización">
    Un lead calificado en conversación no se queda solo en el CRM: puede entrar directamente a listas, workflows y procesos de marketing ya definidos dentro de HubSpot.

    **Flujo típico:**

    * El flujo crea o actualiza el contacto según el resultado de la conversación
    * Lo agrega a una lista con **Agregar Contacto a la Lista** o lo inscribe con **Inscribir contacto en el flujo de trabajo**
    * Activa pasos posteriores dentro de HubSpot, como automatización comercial o marketing
    * Si el caso lo requiere, también puede operar formularios, páginas, landings o correos desde las categorías correspondientes

    **Impacto:**

    * Menos fricción entre captación, CRM y automatización
    * Mejor orquestación entre marketing, ventas y lifecycle
    * HubSpot pasa de ser solo un repositorio a ser un sistema realmente operativo dentro del flujo

    **Ideal para:** growth, marketing ops, lifecycle automation y operaciones comerciales avanzadas.
  </Accordion>
</AccordionGroup>

***

## Integraciones que combinan bien con HubSpot

<AccordionGroup>
  <Accordion title="Gmail">
    Después de crear un lead o mover una oferta en HubSpot, el flujo puede enviar automáticamente un correo de seguimiento o propuesta al contacto desde la cuenta conectada de Gmail.

    **Flujo combinado:** oferta actualizada en HubSpot → correo con propuesta al contacto vía Gmail.

    [Documentación de Gmail](/guides/integraciones/productividad/gmail)
  </Accordion>

  <Accordion title="Calendly">
    Cuando la conversación termina en "agendemos una reunión", el flujo puede generar un enlace de Calendly y, una vez confirmada la cita, registrar la actividad o nota en HubSpot con el contexto comercial completo.

    **Flujo combinado:** lead calificado en HubSpot → enlace de Calendly → cita confirmada → nota registrada en HubSpot.

    [Documentación de Calendly](/guides/integraciones/agendamiento/calendly)
  </Accordion>

  <Accordion title="Slack">
    Cada lead de alto valor, oferta ganada o ticket urgente puede disparar una alerta al canal correspondiente en Slack, para que el equipo reaccione sin abrir HubSpot.

    **Flujo combinado:** lead enterprise creado en HubSpot → alerta a #ventas-enterprise en Slack con nombre y empresa.

    [Documentación de Slack](/guides/integraciones/productividad/slack)
  </Accordion>
</AccordionGroup>

***

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integraciones" href="/guides/integraciones/integraciones" icon="grid">
    Catálogo de integraciones disponibles en el Marketplace.
  </Card>

  <Card title="Cómo usar integraciones en Brain" href="/guides/integraciones/como-usar-integraciones-en-brain" icon="book-open">
    Flujo general para instalar y usar integraciones en Brain Studio.
  </Card>
</CardGroup>