Abrir app

DocumentaciónWorkflowsApps y servicios

HubSpot Kontakte nodo

Contactos del CRM en la cuenta de HubSpot conectada: buscar, mostrar, crear, actualizar. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.

8 min de lecturaActualizado el

Qué hace este nodo

Contactos del CRM en la cuenta de HubSpot conectada: buscar, mostrar, crear, actualizar.

Usa HubSpot Kontakte como un paso claramente definido en un workflow de anymize.

  • Procesa 1 entrada.
  • Ofrece 1 salida para los pasos siguientes.
  • Se ejecuta como un paso normal del flujo.

Configurar el nodo

  1. 01Abre un workflow y añade HubSpot Kontakte desde el catálogo de nodos.
  2. 02Selecciona tu conexión de hubspot. Puedes crearla directamente en el workflow.
  3. 03Completa los campos obligatorios y asigna valores de los pasos anteriores.
  4. 04Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
  5. 05Conecta la salida correcta y activa el workflow después de una prueba completa.

Acciones y modos

Elige la función necesaria en Acción. El panel mostrará los ajustes correspondientes.

  • Buscar contactos
  • Leer contacto
  • Crear contacto
  • Crear o actualizar contacto por email
  • Actualizar contacto

Ajustes

CampoSignificadoÁrea
AcciónOpciones: Buscar contactos, Leer contacto, Crear contacto, Crear o actualizar contacto por email, Actualizar contactoEstándar
Término de búsquedaBusca en correo, nombre/apellido, nombre de empresa y número de teléfono. Vacío = todos los contactos (hasta la cantidad de abajo).Estándar
Cantidad (máx. 100)Número máximo de contactos por llamada. HubSpot devuelve menos si tu cuenta tiene menos contactos (p. ej. solo los contactos de muestra).Estándar
ID de contactoConfigura este valor en el panel del nodo.Estándar
CorreoConfigura este valor en el panel del nodo.Estándar
NombreConfigura este valor en el panel del nodo.Estándar
ApellidoConfigura este valor en el panel del nodo.Estándar
Otros camposOtros campos de HubSpot como campo → valor. P. ej. phone, company, jobtitle.Estándar
Ejecutar una vez por elementoDesactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada.Estándar
Si un elemento falla«Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible.Estándar
Pausa entre elementos (milisegundos)Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos).Estándar

Entradas y salidas

EntradaSignificadoTipo
EstándarRecibe el resultado completo del paso anterior.JSON
SalidaSignificadoTipo
EstándarEntrega el resultado al paso siguiente como JSON.JSON

Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.

Ejemplo y prueba

Crear un nuevo lead desde un webhook: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.

Ejemplo de prueba

{
  "email": "lisa@example.com",
  "firstname": "Lisa",
  "lastname": "Müller"
}

Acceso y seguridad

Este nodo usa una conexión de hubspot. Revisa los permisos y concede solo el acceso necesario.

Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.

Resolver errores

  • Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
  • Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
  • Conexión rechazada: vuelve a conectar el servicio con los permisos necesarios.
  • La lista se procesa una sola vez: activa la ejecución por elemento.

Artículos relacionados