HubSpot

Conexión de HubSpot con Siesta AI

1. En Conexiones selecciona Agregar Conexión y elige HubSpot.

2. Introduce el token de aplicación privada (clave API) y establece Compartido o Privado.

3. En HubSpot abre Configuración -> Integraciones -> Aplicaciones Privadas y crea una nueva aplicación.

4. Completa la información básica de la aplicación.

5. Establece los scopes necesarios para los objetos CRM.

6. En la pestaña Auth copia el token de acceso y úsalo en Siesta AI.

Resumen

Esta Conexión proporciona una interfaz estandarizada para trabajar con HubSpot CRM. Permite la creación y lectura de entidades básicas de CRM: Empresas, Contactos, Negocios y Pipelines.

La integración está diseñada como sin estado, determinista y fail-fast, adecuada para:

• Automatización de CRM
• Sincronización de leads
• Orquestación de pipelines de ventas y ingresos
• Flujos de trabajo empresariales auditables

Autenticación y seguridad

• La conexión se comunica exclusivamente a través de la API oficial de HubSpot.
• La autenticación se resuelve a nivel de cuenta de HubSpot (OAuth / token de aplicación privada).
• No se registran ni almacenan en caché datos sensibles.
• Todas las operaciones se ejecutan con los permisos asignados en HubSpot.

Los derechos de acceso (scopes) afectan directamente la disponibilidad de las operaciones. Un scope incorrecto significa un fallo.

Entidades soportadas

• Empresa
• Contacto
• Negocio
• Pipeline

Cada operación trabaja con IDs internos de HubSpot, no con nombres.

1. Operaciones de Empresa

1.1 CrearEmpresa

Descripción
Crea una nueva empresa en HubSpot CRM.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
name	String	Sí	Nombre de la empresa.
domain	String	Sí	Dominio de la empresa (debe ser único).

Comportamiento

• Si el dominio ya existe, la operación fallará.
• No realiza coincidencias difusas ni normalización de dominio.

Uso típico

• Incorporación de nuevos clientes
• Sincronización de empresas desde sistemas externos

2. Operaciones de Contacto

2.1 CrearContacto

Descripción
Crea un nuevo contacto en HubSpot CRM.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
email	String	Sí	Email del contacto (debe ser único).
firstName	String	Sí	Nombre de pila.
lastName	String	Sí	Apellido.

Comportamiento

• El email sirve como identificador único.
• Email duplicado = error grave.

2.2 ObtenerContactoPorEmail

Descripción
Devuelve un contacto basado en la dirección de correo electrónico.

Parámetros de entrada

Parámetro	Tipo	Obligatorio
email	String	Sí

2.3 ObtenerContactoPorId

Descripción
Devuelve un contacto según su ID único de HubSpot.

Parámetros de entrada

Parámetro	Tipo	Obligatorio
contactId	Int64	Sí

2.4 ObtenerTodosLosContactos

Descripción
Devuelve una lista de contactos en HubSpot CRM.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
limit	Int	No	Número máximo de registros devueltos.

3. Operaciones de Negocio

3.1 CrearNegocio

Descripción
Crea un nuevo negocio y lo asigna a un contacto específico.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
dealName	String	Sí	Nombre del negocio.
contactId	String	Sí	ID de Contacto existente.
pipelineId	Int64	Sí	ID del pipeline (no el nombre).
stageId	Int64	Sí	ID de la etapa (no el nombre).
amount	Int	No	Valor del negocio.

Comportamiento

• Tanto el pipeline como la etapa deben existir.
• No realiza mapeo automático de nombres a IDs.
• Relación incorrecta = fallo.

3.2 ObtenerNegocioPorId

Descripción
Devuelve los detalles del negocio según el ID.

Parámetros de entrada

Parámetro	Tipo	Obligatorio
dealId	Int64	Sí

3.3 ObtenerTodosLosNegocios

Descripción
Devuelve una lista de negocios.

Parámetros de entrada

Parámetro	Tipo	Obligatorio
limit	Int	No

4. Operaciones de Pipeline

4.1 ListarTodosLosPipelines

Descripción
Devuelve todos los pipelines incluyendo sus etapas y IDs correspondientes.

Parámetros de entrada
Ninguno.

Nota Este paso es obligatorio si no deseas crear negocios a ciegas.

5. Operaciones de Búsqueda

5.1 BuscarEmpresas

Descripción
Busca empresas por nombre.

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
name	String	No	Nombre de la empresa (sin dominio).

Restricciones

• No usar dominios, URLs ni correos electrónicos.
• La búsqueda es textual, sin coincidencias difusas.