> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/hubspot.md).

# Hubspot

## Integración con HubSpot

HubSpot se conecta con Prometheo para crear y actualizar contactos en tu CRM a partir de las conversaciones que entran por tus canales.

***

### Qué hace la integración

* Un lead conversa por WhatsApp, Instagram u otro canal conectado a Prometheo.
* Según la configuración que hagas, cuando se cumpla cierta condición, Prometheo crea o actualiza ese contacto en HubSpot.
* Podés definir qué datos se envían: nombre, teléfono, email, variables personalizadas, tags, etc.

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>HubSpot no se completa solo. Primero hay que definir cuándo se sincroniza y qué información se envía.</p></div>

### Qué revisar antes de configurarlo

Antes de conectar, tené claro estas tres cosas:

**1. Qué va a disparar la creación o actualización** Por ejemplo: cuando entra un lead nuevo, cuando cambia un dato, o cuando se aplica un tag puntual como `Interesado` o `Lead calificado`.

**2. Qué datos querés mandar a HubSpot** Por ejemplo: nombre, teléfono, email, canal de origen, producto de interés, zona, presupuesto, o cualquier variable que captures en Prometheo.

**3. Que esos campos existan en HubSpot** Si el campo de destino no existe en HubSpot, no vas a poder mapearlo. Crealo primero desde tu cuenta de HubSpot.

***

### Cómo conectar HubSpot

Andá a **Conexiones → Integraciones → HubSpot** y seguí los pasos del modal para ingresar tus credenciales.

La conexión es el primer paso, pero no alcanza. Después hay que configurar la lógica de sincronización.

***

### Qué se configura después de conectar

Una vez conectada la cuenta, hay cuatro bloques de configuración:

#### 1. Disparador de sincronización

Acá definís cuándo Prometheo envía información a HubSpot.

| Disparador                      | Cuándo usarlo                                                                                                             |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Cuando se crea un lead**      | Si querés registrar todos los contactos desde el primer mensaje. Riesgo: podés mandar leads muy fríos o sin datos útiles. |
| **Cuando se actualiza un lead** | Si querés que HubSpot se actualice a medida que avanza la conversación y se capturan más datos.                           |
| **Cuando se actualiza un tag**  | La opción más ordenada. Solo sincroniza cuando la conversación alcanza un tag específico.                                 |

***

#### 2. Condición de creación

Además del disparador, podés definir una condición para que solo se cree el lead si tiene determinado tag.

Ejemplo:

* Disparador: cuando se actualiza un tag
* Condición: tag = `Lead calificado`

Así HubSpot solo recibe contactos ya filtrados por Prometheo, no todas las conversaciones.

***

#### 3. Mapeo de campos

Acá relacionás los campos de Prometheo con los campos de HubSpot.

Ejemplos típicos:

| Campo en Prometheo          | Campo en HubSpot        |
| --------------------------- | ----------------------- |
| Nombre                      | `firstname`             |
| Apellido                    | `lastname`              |
| Teléfono                    | `phone`                 |
| Email                       | `email`                 |
| Variable `producto_interes` | Propiedad personalizada |
| Variable `presupuesto`      | Propiedad personalizada |

* Del lado de Prometheo: creá la variable primero en **CRM → Leads → Variables**.
* Del lado de HubSpot: el campo de destino tiene que existir antes de poder mapearlo.En la pantalla de mapeo también vas a ver la opción **Req.** — indica que ese campo es obligatorio para la sincronización. Usala con criterio: si marcás como obligatorios datos que no siempre están presentes, podés trabar la creación de leads.

***

#### 4. Valores predeterminados

Podés configurar campos que siempre se envíen con un valor fijo cada vez que se crea un contacto.

Ejemplos:

* `lifecycle_stage` = Lead
* `fuente` = Prometheo
* `canal` = WhatsApp
* `país` = Argentina

Esto te ayuda a estandarizar datos, identificar el origen de los leads y mejorar las automatizaciones dentro de HubSpot.

***

### Cómo crear variables en Prometheo

Si querés mandar datos personalizados a HubSpot, primero tenés que tener esas variables creadas en Prometheo.

Ruta: **CRM → Leads → Variables**

Completá:

* **Nombre** — por ejemplo: `presupuesto`
* **Tipo** — número, texto, etc.
* **Prompt** — instrucción para que el asistente sepa cuándo guardar ese dato

Ejemplo:

> *Nombre: `servicio_interes` / Tipo: texto / Prompt: "Guardá en esta variable el servicio de interés que mencione la persona en la conversación."*

***

### Ejemplo de configuración completa

Caso: calificación de leads por WhatsApp.

<table><thead><tr><th width="277.33331298828125">Bloque</th><th>Configuración</th></tr></thead><tbody><tr><td>Disparador</td><td>Cuando se actualiza un tag</td></tr><tr><td>Condición de creación</td><td>Tag = <code>Lead calificado</code></td></tr><tr><td>Mapeo</td><td>Nombre, teléfono, email, <code>servicio_interes</code>, <code>presupuesto</code></td></tr><tr><td>Valores fijos</td><td>Origen = Prometheo / Canal = WhatsApp / Estado = Nuevo lead</td></tr></tbody></table>

Resultado: HubSpot solo recibe leads calificados, con datos útiles y bien ordenados.

***

### Problemas frecuentes

<table><thead><tr><th width="308.66668701171875">Síntoma</th><th>Causa probable</th></tr></thead><tbody><tr><td>El campo no aparece en el mapeo</td><td>No existe en HubSpot o no está creado como variable en Prometheo</td></tr><tr><td>Se crean muy pocos leads</td><td>La condición de creación es muy restrictiva o el tag nunca se aplica</td></tr><tr><td>Se crean demasiados leads</td><td>El disparador está configurado en "cuando se crea un lead" sin filtro por tag</td></tr><tr><td>Faltan datos en HubSpot</td><td>La variable no estaba bien creada, el lead no compartió ese dato, o el mapeo apunta al campo incorrecto</td></tr></tbody></table>

***

### Recomendación para empezar

### **Configuración inicial sugerida**

1. Definí uno o dos smart tags clave, por ejemplo: `Lead calificado` y `Solicita contacto humano`.
2. Creá las variables necesarias en Prometheo.
3. Conectá HubSpot.
4. Usá como disparador: **cuando se actualiza un tag**.
5. Usá como condición de creación: el tag más útil para tu operación.
6. Mapeá solo los campos importantes: nombre, teléfono, email y 2 o 3 variables clave.
7. Agregá al menos un valor fijo: `Origen = Prometheo`.

Empezá simple. Cuando el flujo funcione bien, sumás más campos y condiciones.