Skip to main content

​
Configuración básica

Puedes instalar la integración de HubSpot desde nuestro Marketplace. Una vez instalada, podrás:
  • Crear y actualizar contactos
  • Buscar contactos por email, teléfono o ID
  • Crear y actualizar deals (oportunidades)
  • Consultar información completa de un deal y listar pipelines/etapas
  • Crear tickets de soporte y asociarlos a contactos
  • Listar compañías

​
Funcionalidades

​
Verificar autenticación

Consulta el estado de autenticación y disponibilidad del token. Inputs:
  • (sin inputs)
Ejemplo: 
{}

​
Crear contacto

Crea un nuevo contacto en HubSpot CRM. Útil para registrar leads desde WhatsApp, formularios u otras fuentes. Inputs:
  • email (string) — Correo del contacto.
  • firstname (opcional, string) — Nombre.
  • lastname (opcional, string) — Apellido.
  • phone (opcional, string) — Teléfono.
  • company (opcional, string) — Empresa.
  • custom_fields (opcional, object<string,string>) — Campos adicionales válidos en tu portal.
Ejemplo: 
{
  "email": "cliente@ejemplo.com",
  "firstname": "Juan",
  "lastname": "Pérez",
  "phone": "+521234567890",
  "company": "Empresa Ejemplo",
  "custom_fields": {
    "lifecyclestage": "lead",
    "jobtitle": "Gerente"
  }
}

​
Listar contactos

Obtén contactos con soporte de paginación (límite). Inputs:
  • limit (number, 1–100, por defecto 10) — Cantidad de contactos a recuperar.
Ejemplo: 
{
  "limit": 10
}

​
Buscar contacto

Busca un contacto por email, teléfono o ID. Inputs:
  • email (opcional, string) — Email a buscar.
  • phone (opcional, string) — Teléfono a buscar.
  • contact_id (opcional, string) — ID de contacto en HubSpot.
Nota: Debes proporcionar al menos uno de los campos anteriores. Ejemplo: 
{
  "email": "cliente@ejemplo.com"
}

​
Actualizar contacto

Actualiza propiedades de un contacto existente. Inputs:
  • contact_id (string) — ID de contacto en HubSpot.
  • properties (object<string,string>) — Propiedades a actualizar.
Ejemplo: 
{
  "contact_id": "1234567890",
  "properties": {
    "lifecyclestage": "customer",
    "phone": "+521234567891"
  }
}

​
Obtener propiedades de contacto

Lista propiedades disponibles para contactos en tu portal (útil para saber qué campos puedes usar). Inputs:
  • (sin inputs)
Ejemplo: 
{}

​
Crear deal

Crea una oportunidad de venta en un pipeline y etapa específicos. Inputs:
  • dealname (string) — Nombre del deal.
  • amount (opcional, string | number) — Monto del deal.
  • pipeline (string) — ID del pipeline.
  • stage (string) — ID de la etapa dentro del pipeline.
  • closedate (opcional, string) — Fecha estimada de cierre (formatos comunes aceptados).
  • associated_contact_id (opcional, string) — ID de contacto a asociar.
  • custom_fields (opcional, object<string,string>) — Campos adicionales válidos en tu portal.
Ejemplo: 
{
  "dealname": "Implementación sitio web - Empresa Ejemplo",
  "amount": "15000",
  "pipeline": "default",
  "stage": "appointmentscheduled",
  "closedate": "2025-11-21",
  "associated_contact_id": "1234567890",
  "custom_fields": {
    "description": "Proyecto web corporativo",
    "deal_currency_code": "USD"
  }
}

​
Actualizar deal

Actualiza propiedades de un deal existente (por ejemplo mover de etapa, cambiar monto, etc.). Inputs:
  • deal_id (string) — ID del deal.
  • properties (object<string,string>) — Propiedades a actualizar.
Ejemplo: 
{
  "deal_id": "9876543210",
  "properties": {
    "dealstage": "closedwon",
    "amount": "20000",
    "closedate": "2025-12-01"
  }
}

​
Obtener información de un deal

Devuelve información detallada del deal, incluyendo contacto asociado si existe. Inputs:
  • deal_id (string) — ID del deal.
Ejemplo: 
{
  "deal_id": "9876543210"
}

​
Listar pipelines y etapas de deals

Obtén los pipelines de deals disponibles y sus etapas para usarlos en creación/actualización de deals. Inputs:
  • (sin inputs)
Ejemplo: 
{}

​
Crear ticket

Crea un ticket de soporte y opcionalmente lo asocia a un contacto. Inputs:
  • subject (string) — Asunto del ticket.
  • content (string) — Descripción del ticket.
  • status (opcional, string) — Estado del ticket (p. ej. new, pending, open, in_progress, resolved, closed).
  • priority (opcional, string) — Prioridad del ticket (LOW, MEDIUM, HIGH).
  • associated_contact_id (opcional, string) — ID de contacto a asociar.
  • custom_fields (opcional, object<string,string>) — Campos adicionales válidos en tu portal.
Ejemplo: 
{
  "subject": "Problema con inicio de sesión",
  "content": "El cliente no puede acceder a su cuenta (error de credenciales).",
  "status": "new",
  "priority": "HIGH",
  "associated_contact_id": "1234567890",
  "custom_fields": {
    "source_type": "chatbot"
  }
}

​
Listar compañías

Obtén compañías con soporte de paginación (límite). Inputs:
  • limit (number, 1–100, por defecto 10) — Cantidad de compañías a recuperar.
Ejemplo: 
{
  "limit": 10
}