# Nodos de HubSpot

HubSpot en la paleta es un nodo por objeto. Cada tarjeta permanece **Setup required** hasta que HubSpot esté conectado en [Integrations](https://docs.voicelogica.ai/es/integrations/hubspot/). La herramienta **HubSpot** del agent (ID de llamante, actualizaciones de propiedades en vivo) está en esa página — esta página es el *grafo*.

  <ShotPlaceholder
    src="/assets/workflow-nodes/hubspot.png"
    name="wn-hs"
    alt="Gestionar Contacto en HubSpot"
    capture="HubSpot Contact node. 1600×900. Operation visible. Redact emails."
  />

## Por qué estos nodos

Una escritura determinística después de que ya conozca el teléfono o correo electrónico. Los triggers **HubSpot Contact Created** / **Property Changed** son [Triggers de Workflow](https://docs.voicelogica.ai/es/workflows/) más la misma conexión.

## Qué nodo usar

Títulos del catálogo:

- **Encontrar o crear la persona** — turn on **Manage Contact in HubSpot** (needs Get / Get or create / Create or update / List / Search / Delete. Teléfono desde **Call Parameters**.)
- **La empresa** — turn on **Manage Company in HubSpot** (needs Nombre + dominio al crear.)
- **Un negocio o un ticket** — turn on **Manage Deal / Manage Ticket** (needs Pipeline + etapa al crear.)
- **Una tarea de seguimiento para un humano** — turn on **Manage Task in HubSpot** (needs Título requerido. Propietario + fecha de vencimiento.)
- **Una nota en el registro** — turn on **Create Note in HubSpot** (needs Cuerpo requerido. **Associations** la vincula.)
- **Registrar la actividad** — turn on **Log Call / Log Email / Schedule Meeting** (needs En un trigger de teléfono, los metadatos de la llamada (dirección, duración) se completan desde la llamada — no los configure manualmente.)

**Operation** es requerido en cada tarjeta. Los campos de búsqueda usan **Get by** / **Value** (`{{call.phone_number}}`). Los campos de creación cambian con la operación.

Los puertos siguen al objeto (Contact: **Contact saved** / **HubSpot error** / **No wait**).

Galaxy, Shopify, Soft1, WooCommerce, Salesforce, Guesty siguen la misma regla: conéctelos en [Integrations](https://docs.voicelogica.ai/es/integrations/), luego agregue el nodo de ese proveedor. No tienen sus propias páginas aquí.

## Primera configuración — crear o actualizar el llamante después de colgar

1. [Conectar HubSpot](https://docs.voicelogica.ai/es/integrations/hubspot/).

2. [On Call End](https://docs.voicelogica.ai/es/workflows/on-call-end/) → **Manage Contact in HubSpot**. Operation **Create or update**. Phone = número del llamante.

     <ShotPlaceholder
       src="/assets/workflow-nodes/hubspot-filled.png"
       name="hubspot-filled"
       alt="Gestionar Contacto en HubSpot completado"
       capture="Workflow builder → Manage Contact in HubSpot selected. Operation Create or update, phone mapped. 1600×900. Redact numbers/emails/PINs."
     />

3. **Save & go live**, adjuntar, colgar. Abra el contacto en HubSpot.

## Cómo se ve "roto"

- **Setup required** — Integrations → HubSpot no está conectado.
- Contacto vacío — Value no coincidió (falta `+`, **Get by** incorrecto).
- Los campos del registro de llamadas que escribió se ignoran — un trigger de teléfono ya los posee.

## Solución de problemas

**¿Herramienta vs nodo de workflow?**

La herramienta es lo que el *modelo* puede hacer mientras habla. El nodo es lo que el *grafo* siempre hace en ese trigger. Use el nodo para "siempre archivar este contacto". Use la herramienta para "actualizar una propiedad que acaban de confirmar".

## Próximos pasos

[Conectar HubSpot](https://docs.voicelogica.ai/es/integrations/hubspot/).  
[On Call End](https://docs.voicelogica.ai/es/workflows/on-call-end/).  
[Elegir un nodo](https://docs.voicelogica.ai/es/workflow-nodes/).