¿Qué plan de HubSpot necesito?

Cualquier plan de HubSpot funciona: Gratuito, Básico, Profesional o Empresarial.

¿Mis datos de HubSpot están seguros?

Sí. Cifrado AES-256, conexiones solo de salida, los datos nunca pasan por los servidores de Query Streams.

¿Puedo acceder a las propiedades personalizadas de HubSpot?

Sí, utilice json_extract_string(raw_data, '$.properties.your_custom_field') para acceder a cualquier propiedad.

¿Puede Query Streams modificar mis datos de HubSpot?

No. Query Streams es estrictamente de solo lectura y solo solicita permisos .read.

Conectar HubSpot con Google Sheets: consultar datos del CRM con SQL

Conectar HubSpot con Google Sheets

Obtenga datos de HubSpot en Hojas de cálculo de Google

Importa filas en tiempo real desde tu cuenta de HubSpot a Google Sheets y actualízalas cuando quieras. Sin subir archivos CSV, sin usar Apps Script, sin copiar y pegar. Solo te llevará unos diez minutos la primera vez, y el plan gratuito lo incluye.

Aproximadamente 10 minutos No se necesita programar Las credenciales permanecen contigo Cualquier navegador, cualquier dispositivo

¿Tienes algún problema? Pregúntanos. Abrir Ayuda En Consultas de flujos (menú superior derecho → Soporte) y envíanos un mensaje. Personas reales lo leen, y «No sé qué me pide esta pantalla» es una pregunta perfectamente válida.

Lo que obtendrás al final

Una hoja de cálculo de Google que muestra los resultados en tiempo real de una consulta SQL en tu cuenta de HubSpot, con un botón que muestra las filas más recientes cada vez que cambian los datos. Algo así:

Ventas Guardado en Drive

ArchivoEditarVistaInsertarFormatoDatosHerramientasExtensionesAyuda

	A	B	C	D	E
1	customer_id	nombre de pila	apellido	país	total
2	1042	María	Álvarez	EE.UU	1,284.50
3	1043	Daniel	Okafor	EE.UU	612.00
4	1047	Priya	Nair	EE.UU	2,090.75
5	1051	Thomas	Iceberg	EE.UU	338.20
6	1056	Lucía	Ferreira	EE.UU	1,455.00
7	1060	Kenji	Sato	EE.UU	874.10
8

+ clientes Hoja1

En directo desde HubSpot

HubSpot almacena tus datos en su API. Para importarlos a Google Sheets, normalmente tienes que exportar un archivo CSV desde el panel de control de HubSpot cada vez que necesites datos actualizados. Query Streams evita este paso: un pequeño programa auxiliar llamado Agente ejecuta la consulta donde se encuentran tus datos, y un complemento de Google Sheets solicita las filas que necesitas. Solo se transmiten los resultados a través de un enlace cifrado, y Google Sheets puede estar en cualquier lugar: en cualquier navegador y en cualquier dispositivo.

El agente reside con tus datos. Tu hoja de cálculo se encuentra en la nube de Google. Ábrela desde cualquier lugar y las filas aparecerán automáticamente.

Lo que necesitarás

Una cuenta de Query Streams

El plan gratuito es suficiente para esta guía. Regístrate en mi.querystreams.com.

El agente en cualquier ordenador que esté siempre encendido

Un pequeño programa que se ejecuta en segundo plano y llama a HubSpot cuando Google Sheets lo solicita. Solo necesita acceso a internet.

Tu inicio de sesión de HubSpot

Deberás iniciar sesión en HubSpot una sola vez y otorgar acceso de lectura. No es necesario introducir contraseñas en los flujos de consultas.

¿Qué ordenador recibe el Agente? Cualquier máquina que esté siempre encendida y que ya pueda acceder a tu cuenta de HubSpot. Google Sheets puede estar en cualquier lugar; se ejecuta en tu navegador.

Conéctalo en cinco pasos

Crea tu cuenta

Ir a mi.querystreams.com y regístrese. Elija el Gratis Es un plan real, no una versión de prueba, y cubre la conexión de tu cuenta de HubSpot y la ejecución de consultas desde Google Sheets.
Instale el agente en cualquier ordenador que esté siempre encendido.
Iniciar sesión, abrir DescargarInstale el Agente en cualquier ordenador o servidor que esté siempre encendido y tenga acceso a internet. El proceso tarda un minuto y, a partir de ese momento, se inicia automáticamente.
¿Por qué un programa pequeño en lugar de un controlador? El Agente es una única instalación para Windows, Mac o Linux (aproximadamente 85 MB en Windows, algo más de 100 MB en Mac y Linux) que se ejecuta discretamente en segundo plano. Establece una única conexión saliente cifrada a Query Streams, del mismo modo que lo hace un navegador, por lo que no es necesario abrir ningún puerto del firewall ni configurar una VPN. Tus claves permanecen en tu equipo y los datos se transmiten a dondequiera que estés, incluso a través de internet si es necesario. Lo único que necesitas es el complemento.
La página de descarga muestra Su clave de accesoPégalo en el Agente cuando te lo pida y espera a que aparezca la insignia. Conectado a flujos de consulta. Eso es lo único que debes hacer en el propio Agente.
Si lo deseas, aquí tienes las guías completas: Ventanas, Impermeable, Linux.

Apúntalo a tu cuenta de HubSpot

De vuelta en tu navegador, abre Agentes de datos (bajo Datos (en el menú superior). Su agente aparece allí. Haga clic. Agregar conector y elegir HubSpot¿Necesitas primero tus credenciales de HubSpot? Abre el tutorial y luego completa:

Crea tus credenciales de HubSpot (unos 5 minutos)

A continuación, mantén HubSpot abierto en otra pestaña. Query Streams guarda lo que crees aquí para que tu agente pueda usarlo, y solo lee datos de HubSpot.

¿Quién puede hacer esto?: Superadministrador o un usuario con permisos de acceso a las herramientas de desarrollador (claves de servicio). Las aplicaciones privadas heredadas necesitan un superadministrador.
Recomendado: Clave de servicio con permisos de solo lectura (Desarrollo → Claves → Claves de servicio). HubSpot recomienda usar claves de servicio para sincronizar datos programadas con herramientas y almacenes de BI, y está eliminando la opción de crear nuevas aplicaciones privadas heredadas.

Antes de empezar

Se requiere una cuenta de HubSpot con privilegios de superadministrador o con acceso a las herramientas para desarrolladores. Solo se pueden asignar permisos a una clave de servicio que tu usuario de HubSpot ya tenga.
Sepa qué cuenta de HubSpot desea consultar. Una clave solo lee la cuenta en la que se creó, así que créela en esa cuenta, no en una cuenta de prueba o de entorno de pruebas.
Decide qué tablas de HubSpot quieres usar. Contactos, Empresas, Negocios, Propietarios, Canales de ventas, Etapas de canalización y Propiedades están activadas por defecto; cada tabla adicional necesita su propio ámbito de lectura (consulta Permisos).
El agente de Query Streams está instalado y en línea en un ordenador siempre encendido, y el portal de Query Streams está abierto en otra pestaña: Agentes de datos → Agregar conector → HubSpot.

Pasos

Inicia sesión en HubSpot
Abre HubSpot en una pestaña nueva e inicia sesión como superadministrador o como usuario con permiso de acceso a las herramientas para desarrolladores.
Si tienes más de una cuenta de HubSpot, cambia a la que contiene los datos que deseas consultar antes de continuar. La clave solo funciona en la cuenta en la que se creó.
Desarrollo abierto
En el menú principal de la izquierda, cerca de la parte inferior, haga clic en Desarrollo (el icono </>). Se abrirá la página de Desarrollo con su propia barra lateral: Resumen, Proyectos, Aplicaciones heredadas, Monitorización, Claves y más.
¿No encuentras el elemento de Desarrollo? Tu usuario de HubSpot no es un superadministrador y carece de acceso a las herramientas para desarrolladores. Pídele a un superadministrador que cree la clave o que te otorgue ese permiso.
Claves de servicio abiertas
En la barra lateral de Desarrollo, haga clic en Claves para expandirla y, a continuación, en Claves de servicio (tiene un distintivo Beta). Se abrirá la página Claves de servicio; si aún no tiene ninguna, aparecerá el mensaje No se han creado claves de servicio.
No utilice la Clave de acceso personal ni la Clave API de desarrollador, que se encuentran justo encima de las Claves de servicio en el mismo menú. Son claves de herramientas para desarrolladores y no se conectarán. Algunas cuentas también acceden a esta página desde Configuración (icono de engranaje) → Integraciones → Claves de servicio.
Haga clic en Crear clave de servicio.
En la esquina superior derecha de la página Claves de servicio, haga clic en Crear clave de servicio. Se abrirá la página Crear clave de servicio con un cuadro Nombre y una sección Ámbitos.
Nombra la clave
En Nombre, escriba un nombre que reconozca más adelante, por ejemplo, "Consulta de flujos de solo lectura". HubSpot mostrará este nombre en sus registros.
El nombre debe ser único en tu cuenta de HubSpot.
Abrir el selector de alcance
Junto a Ámbitos seleccionados, haga clic en + Agregar nuevo ámbito. Se abrirá un panel a la derecha con un cuadro de búsqueda para encontrar un ámbito y una casilla de verificación para cada ámbito.
Marque los cuatro ámbitos requeridos.
Escriba cada nombre en Buscar un ámbito y marque su casilla: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Estos cuatro abarcan todas las tablas que Query Streams sincroniza de forma predeterminada.
Marque únicamente los ámbitos que terminen en .read. Query Streams solo lee desde HubSpot; nunca necesita un ámbito .write.
Marque los ámbitos para cualquier tabla adicional
Para cada tabla adicional que desee, marque su ámbito en la lista de permisos que aparece a continuación. Por ejemplo: crm.objects.tickets.read para Tickets; crm.objects.line_items.read para Artículos, Impuestos, Descuentos y Comisiones; crm.lists.read para Listas. Omita este paso si las tablas predeterminadas son suficientes.
Puedes añadir ámbitos más adelante sin necesidad de crear una nueva clave (abre la clave y luego Editar).
Haz clic en Actualizar
Haz clic en Actualizar en el panel derecho. El panel se cerrará y tus ámbitos aparecerán en la sección Ámbitos seleccionados.
Consulta la lista de alcance
Revisa los ámbitos seleccionados. Si alguno termina en .write, haz clic en Eliminar junto a él. Expande el resumen de los ámbitos seleccionados si deseas una lista en lenguaje sencillo de lo que la clave puede ver.
Crea la clave
Haz clic en Crear en la esquina superior derecha y, a continuación, confirma en el cuadro de diálogo que se abre.
Abre tu nueva llave
Ve a Desarrollo → Claves → Claves de servicio y haz clic en el nombre de la clave que acabas de crear. Se abrirá su página de detalles con un cuadro de Clave de servicio.
Muestra y copia la clave.
En el cuadro Clave de servicio, el valor está parcialmente oculto y comienza con pat- (por ejemplo, pat-na1-…). Haga clic en Mostrar debajo y, a continuación, en Copiar.
Utiliza la función Copiar en lugar de seleccionar el texto manualmente: si falta algún carácter, hay un espacio al final o los puntos ocultos, la prueba fallará. HubSpot no muestra la clave solo una vez; puedes volver y hacer clic en Mostrar de nuevo. Trátala como una contraseña.
Pégalo en Flujos de consulta y prueba.
En el portal de Query Streams, abra Data Agents, haga clic en Agregar conector y seleccione HubSpot. Pegue la clave en Token de acceso a la aplicación, escriba un nombre de conexión y, a continuación, haga clic en Probar conexión. El resultado indicará Conectado.
Query Streams almacena la clave de tu agente y solo lee tus datos de HubSpot.
Adapta las tablas a tus ámbitos.
En el paso de sincronización que sigue, deje solo las tablas de HubSpot cuyos ámbitos marcó en los pasos 7 y 8, y luego finalice el asistente.
Una tabla activada sin su ámbito no se sincroniza y muestra un error de acceso prohibido. Añada el ámbito a la clave (paso 8) o desactive la tabla.

Alternativas

Utilice un token de aplicación privada heredado

Tu cuenta ya tiene una aplicación privada heredada que deseas reutilizar. HubSpot eliminará la opción de crear nuevas: las cuentas creadas a partir del 28 de septiembre de 2026 ya no podrán hacerlo, y las cuentas más antiguas perderán esta opción el 26 de octubre de 2026. Las aplicaciones privadas existentes y sus tokens seguirán funcionando.

¿Quién puede hacer esto? Superadministrador

Abrir aplicaciones heredadas
En HubSpot, haga clic en Desarrollo en el menú de navegación principal de la izquierda y, a continuación, en Aplicaciones heredadas en la barra lateral de Desarrollo.
La navegación anterior de HubSpot se llamaba Configuración → Integraciones → Aplicaciones privadas.
Abre tu aplicación privada o inicia una nueva.
Si la aplicación aparece en la lista, haga clic en su nombre y vaya al paso 6 (o al paso 5 para agregar ámbitos). Si no aparece y el botón sigue visible, haga clic en Crear aplicación heredada en la esquina superior derecha y seleccione Privada en el cuadro de diálogo.
Si no aparece el botón "Crear aplicación heredada", significa que la creación de aplicaciones está desactivada para su cuenta. En su lugar, utilice una clave de servicio (consulte los pasos principales).
Nombra la nueva aplicación
En la pestaña Información básica, introduzca un nombre como «Flujos de consulta de solo lectura». El logotipo y la descripción son opcionales.
Agregue los ámbitos de lectura
Haz clic en la pestaña Ámbitos, luego en Agregar nuevo ámbito, marca los mismos ámbitos que en los pasos 7 y 8, y finalmente haz clic en Actualizar. A continuación, haz clic en Crear aplicación en la esquina superior derecha, lee el mensaje del token de acceso en el cuadro de diálogo y haz clic en Continuar creando.
Agregar ámbitos a una aplicación existente (solo si es necesario)
En la página de la aplicación, haga clic en Editar aplicación en la esquina superior derecha, abra la pestaña Ámbitos, agregue los ámbitos de lectura que falten y guarde. La cadena del token no cambia al modificar los ámbitos.
Muestra y copia el token
En la página de la aplicación, haz clic en la pestaña Aut. En Token de acceso, haz clic en Mostrar token y luego en Copiar. El token comienza con pat-. Pégalo en Token de acceso de la aplicación, como se indica en el paso 14.
Si se elimina de HubSpot al usuario que creó la aplicación, algunas llamadas fallarán con el error USER_DOES_NOT_HAVE_PERMISSIONS. Gire el token (haga clic en "Girar" junto a él) y pegue el nuevo, o bien, cambie a una clave de servicio.

Utilice el token de autenticación estático de una aplicación de plataforma para desarrolladores.

Tu equipo ya ha creado una aplicación de HubSpot en la nueva plataforma para desarrolladores con la interfaz de línea de comandos (CLI) de HubSpot, configurada con autenticación estática y distribución privada. Para crearla, necesitas la CLI; si no la tienes, usa una clave de servicio.

¿Quién puede hacer esto? Superadministrador o un usuario con licencia de desarrollador para ver el token; permiso de superadministrador o acceso a HubSpot Marketplace para instalar la aplicación.

Abrir el proyecto
En HubSpot, haz clic en Desarrollo, luego en Proyectos en la barra lateral y, a continuación, en el nombre del proyecto que contiene tu aplicación.
Abre la aplicación
En la pestaña Resumen del proyecto, en Componentes del proyecto, haga clic en el nombre de la aplicación.
Abra la pestaña Distribución
Haz clic en la pestaña Distribución.
Instala la aplicación si aún no lo está.
En la sección Gestionar distribución, aparece tu cuenta actual de HubSpot. Haz clic en Instalar ahora, comprueba que el acceso solicitado coincida con los permisos de lectura que configuraste y, a continuación, haz clic en Conectar aplicación.
Una aplicación con token estático solo se puede instalar en una cuenta estándar de HubSpot a la vez.
Muestra y copia el token
Una vez instalada, la pestaña Distribución muestra un token de acceso. Haga clic en Mostrar para revelarlo, cópielo y péguelo en Token de acceso de la aplicación, como se indica en el paso 14 principal.
Si posteriormente modificas los permisos de la aplicación, reinstálala mediante la URL de reinstalación que aparece en la pestaña Distribución; de lo contrario, los nuevos permisos no se aplicarán.

Permisos para otorgar

Recurso	Acceda a	Utilizado para
crm.objetos.contactos.leer	Leer	Obligatorio. hubspot.contacts, más las tablas de actividad hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks y hubspot.communications (las API de actividad de HubSpot utilizan este ámbito), y los campos de contacto en hubspot.properties y hubspot.associations.
crm.objetos.empresas.leer	Leer	Obligatorio. hubspot.companies y campos de empresa en hubspot.properties y hubspot.associations.
crm.objetos.negociaciones.leer	Leer	Obligatorio. hubspot.deals, los pipelines de acuerdos en hubspot.pipelines y hubspot.pipeline_stages, y los campos de acuerdos en hubspot.properties y hubspot.associations.
crm.objetos.propietarios.lectura	Leer	Obligatorio. hubspot.owners, los usuarios de HubSpot que poseen los registros, para que las oportunidades y los contactos se puedan vincular al nombre de un representante.
crm.objects.tickets.read	Leer	Solo si sincronizas Tickets: hubspot.tickets y las canalizaciones de tickets en hubspot.pipelines y hubspot.pipeline_stages. Las aplicaciones más antiguas pueden mostrar el ámbito de tickets heredado, que también permite realizar cambios.
crm.objects.products.read	Leer	Solo si sincronizas Productos: hubspot.products. Busca productos en el selector; la API de productos de HubSpot acepta este ámbito, aunque la página de referencia de ámbitos de HubSpot aún no lo incluye.
crm.objects.line_items.read	Leer	Solo si sincronizas los elementos de línea, los impuestos, los descuentos o las tarifas: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
crm.objects.quotes.read	Leer	Solo si sincronizas las citas: hubspot.quotes.
crm.objetos.facturas.leer	Leer	Solo si sincronizas las facturas: hubspot.invoices.
crm.objects.subscriptions.read	Leer	Solo si sincronizas las suscripciones: hubspot.subscriptions (suscripciones de comercio de HubSpot).
crm.objects.commercepayments.read	Leer	Solo si sincronizas Pagos: hubspot.payments (Pagos de comercio de HubSpot).
crm.objects.marketing_events.read	Leer	Solo si sincronizas los eventos de marketing: hubspot.marketing_events.
formas	Lectura y escritura (HubSpot no tiene ámbito de formularios de solo lectura).	Solo si sincroniza Formularios o Envíos de formularios: hubspot.forms y hubspot.form_submissions. Query Streams solo los lee.
crm.objects.feedback_submissions.read	Leer	Solo si sincronizas los comentarios: hubspot.feedback_submissions. Solo para Service Hub Professional o Enterprise. La referencia de ámbito de HubSpot lo escribe crm.objects.feedback_submission.read, así que busca "feedback" en el selector.
crm.lists.read	Leer	Solo si sincronizas las listas: hubspot.lists.
automatización	Lectura y escritura (HubSpot no tiene un ámbito de flujos de trabajo de solo lectura).	Solo si sincronizas flujos de trabajo: hubspot.workflows. Solo para cuentas profesionales o empresariales. Query Streams solo lee las definiciones de flujo de trabajo.
crm.schemas.custom.read	Leer	Solo si sincronizas esquemas personalizados: hubspot.schemas (definiciones de objetos personalizados). Solo para cuentas empresariales.

Pegar en flujos de consulta

Token de acceso a la aplicación: La clave de servicio que copiaste en el paso 13 (comienza con pat-), o un token de aplicación privada heredado, o un token de autenticación estática de una aplicación de plataforma de desarrollador.

Problemas comunes

La prueba de conexión falla con el mensaje "Token de acceso no válido o caducado" justo después de pegar una nueva clave.

Por qué: El valor no es una clave de aplicación ni de servicio. La confusión habitual se debe a la Clave de acceso personal o a la Clave API de desarrollador, que se encuentran junto a las Claves de servicio en Desarrollo → Claves y son para las herramientas de desarrollo de HubSpot.

Arreglar: Ve a Desarrollo → Claves → Claves de servicio, abre tu clave, haz clic en Mostrar, luego en Copiar y pégala en Token de acceso a la aplicación. Prueba la conexión de nuevo; debería aparecer como Conectado.

El asistente indica que el token de la aplicación HubSpot no es válido antes incluso de realizar la prueba.

Por qué: Solo se pegó una parte de la clave: el texto no empieza con pat- y es muy corto o contiene un espacio.

Arreglar: De vuelta en HubSpot, haz clic en Mostrar, luego usa el enlace Copiar (no selecciones el texto manualmente) y vuelve a pegar.

No puedes ver la opción Desarrollo en el menú de navegación izquierdo de HubSpot, o bien, falta la opción Claves de servicio en la sección Claves.

Por qué: Tu usuario de HubSpot no es un superadministrador y no tiene permiso de acceso a las herramientas para desarrolladores.

Arreglar: Pídele a un superadministrador de tu empresa que cree la clave (pasos 2 a 13) y la pegue en el asistente, o que te otorgue acceso a las herramientas para desarrolladores.

La prueba de conexión indica que está conectada, pero una tabla no se sincroniza y muestra un error de "Prohibido" o permanece vacía.

Por qué: La clave está en que falta el ámbito de lectura para esa tabla, o bien tu plan de HubSpot no incluye esa función (Workflows requiere Professional o Enterprise; Custom Schemas requiere Enterprise; Feedback requiere Service Hub Professional o Enterprise).

Arreglar: Abra la clave (Desarrollo → Claves → Claves de servicio → nombre de la clave), haga clic en Editar, agregue el ámbito de la lista Permisos y guarde, luego sincronice nuevamente. Si su plan no incluye esta función, desactive esa tabla en la configuración de sincronización de la conexión.

Las sincronizaciones que antes funcionaban ahora fallan con el mensaje "Token de acceso no válido o caducado".

Por qué: Alguien rotó o eliminó la clave. La opción "Rotar y expirar ahora" desactiva la clave antigua de inmediato; la opción "Rotar y expirar más tarde" la desactiva después de 7 días.

Arreglar: Copia la clave actual desde Desarrollo → Claves → Claves de servicio → nombre de la clave → Mostrar → Copiar. En Data Agents, edita la conexión de HubSpot, pégala en Token de acceso de la aplicación y ejecuta Probar conexión.

Con un token de aplicación privada heredado, algunas tablas fallan con el error USER_DOES_NOT_HAVE_PERMISSIONS.

Por qué: El usuario de HubSpot que creó la aplicación privada fue eliminado de la cuenta.

Arreglar: Gire el token de la aplicación (Desarrollo → Aplicaciones heredadas → app → Rotar) y pegue el nuevo token en la conexión, o bien cree una clave de servicio.

No puedes encontrar Crear aplicación heredada, o la documentación de HubSpot llama a las aplicaciones privadas heredadas.

Por qué: HubSpot dejará de permitir la creación de nuevas aplicaciones privadas heredadas (esta función ya está desactivada para las cuentas creadas a partir del 28 de septiembre de 2026; y para las cuentas más antiguas a partir del 26 de octubre de 2026). Las aplicaciones privadas existentes seguirán funcionando.

Arreglar: Cree una clave de servicio (pasos principales). Los tokens de aplicación privados existentes pueden mantenerse.

Los datos en los flujos de consulta no coinciden con lo que ve en HubSpot.

Por qué: La clave se creó en una cuenta de HubSpot diferente (por ejemplo, una cuenta de prueba o de entorno de pruebas).

Arreglar: Cambia a la cuenta de HubSpot correcta, crea una clave allí y pégala en la conexión.

Límites a conocer

Los límites de HubSpot para claves de servicio y aplicaciones privadas son: 100 solicitudes cada 10 segundos por clave en los planes Gratuito y Básico, 190 en los planes Profesional y Empresarial, y 250 con el complemento de Aumento del límite de API. El Agente ajusta su ritmo al límite más bajo, por lo que la primera sincronización completa de un CRM grande puede tardar un tiempo.
Límite diario por cuenta de HubSpot: 250 000 solicitudes en los planes Gratuito y Básico, 625 000 en el plan Profesional y 1 000 000 en el plan Empresarial. Este límite se comparte entre todas las claves de aplicaciones y servicios privados de la cuenta, por lo que otras integraciones utilizan el mismo presupuesto.
La función de búsqueda de CRM de HubSpot, que el agente utiliza para obtener únicamente los registros modificados, permite 5 solicitudes por segundo por cuenta y un máximo de 10.000 resultados por consulta.
Algunas tablas dependen de tu plan de HubSpot: Flujos de trabajo (Profesional o Empresarial), Esquemas personalizados (Empresarial), Comentarios (Service Hub Profesional o Empresarial).
Las claves de servicio están en fase beta pública (desde el 10 de febrero de 2026), por lo que HubSpot podría modificar algunos detalles. HubSpot recomienda rotar las claves cada seis meses.
No se pueden crear nuevas aplicaciones privadas heredadas en cuentas creadas a partir del 28 de septiembre de 2026, ni en cuentas antiguas creadas a partir del 26 de octubre de 2026. Las aplicaciones y los tokens existentes seguirán funcionando.

Nombre de la conexión: Cualquier nombre que reconocerás más adelante, como base de datos de ventas.
Token de acceso a la aplicación: Un token de aplicación privada de HubSpot (que comienza con pat-), que se encuentra en Configuración, Integraciones, Aplicaciones privadas, tu aplicación, pestaña Autenticación.

Haga clic en Probar la conexiónCuando se lee Conectado, haga clic GuardarLa conexión llega a su agente en cuestión de segundos.

Agentes de datos abiertos

¿La prueba falló? Por lo general, falta un permiso o las credenciales pertenecen a una cuenta de HubSpot incorrecta. El tutorial anterior enumera los problemas comunes y sus soluciones.

Vea sus datos en el Generador de consultas. Opcional

Puedes ver tu cuenta de HubSpot antes de que Google Sheets esté involucrado. Abrir Generador de consultas en el portal y elige la conexión que acabas de hacer. El Esquema La pestaña muestra las tablas y columnas, y al hacer clic en una, se inserta su nombre en el editor, de modo que puede escribir una consulta sin recordar los nombres exactos. Haga clic Ejecutar y las filas aparecen debajo ResultadosEl Generador de Consultas está incluido en todos los planes, incluido el gratuito.

En los planes Business, también puedes pedirle a Nova que te muestre los clientes en EE. UU. y generará la consulta SQL por ti. Cuando la consulta parezca correcta, guárdala: a partir del plan Personal Core, aparecerá en la lista de Consultas guardadas del complemento, y en cualquier plan puedes copiar la consulta SQL en el siguiente paso.
Agregar flujos de consultas a Google Sheets

Abre cualquier hoja de cálculo de Google, ve a Extensiones → Complementos → Obtener complementos, buscar Flujos de consultay haga clic Instale. O instálelo directamente desde Flujos de consultas en el Marketplace de Google WorkspaceGoogle te pedirá que permitas el complemento; eso es normal.

Después, aparece en cada Hoja de cálculo de Google que abres: un icono de Flujos de consulta en el panel lateral derecho, también listado en ExtensionesNo es necesario iniciar sesión por separado. Reconoce la cuenta de Google que ya estás usando, por lo que el correo electrónico debe ser el mismo que el de tu cuenta de Query Streams.
Trae tu primera mesa

Haga clic en el icono de Flujos de consulta en el panel lateral a la derecha de la hoja (o búsquelo en Extensiones). Elegir Transmisión de consultas y elige la conexión que acabas de hacer.

Escriba la consulta que desea ejecutar. Esta extrae algunas columnas de una hubspot.ofertas mesa:
Ejemplo · SQL
```
SELECCIONAR dealname, dealstage, amount, closedate FROM hubspot.deals ORDENAR POR closedate DESC LIMIT 100;
```
Bajo Hoja de destino Seleccione la pestaña en la que deben aparecer las filas y, a continuación, haga clic. Ejecutar consultaLas filas aparecen en esa pestaña en uno o dos segundos. Haga clic en Ejecutar consulta nuevamente cada vez que los datos cambien y la pestaña se actualizará automáticamente.

¿No sabes SQL? Construirlo en Generador de consultas Primero, péguelo aquí o selecciónelo de Consultas guardadas si lo guardó.

Eso es todo. Tus datos están en la hoja de cálculo y se actualizan con un solo clic. Solo las filas que solicitaste salieron de tu red.

Buenos pasos a seguir

Guardar la consulta en el portal para que puedas ejecutarlo de nuevo con un solo clic, desde Google Sheets o Excel.
Agregar un filtro como un rango de fechas, de modo que la misma consulta pueda responder "este mes" sin necesidad de editarla.
Comparte los resultados Con un colega. Ellos ven las filas, no tus credenciales.

Preguntas que hace la gente

¿Es necesario que mi cuenta de HubSpot esté instalada en el mismo ordenador en el que uso Hojas de cálculo?

No. Solo el agente debe estar en la misma ubicación que tu cuenta de HubSpot. Google Sheets funciona en tu navegador desde cualquier dispositivo. Abre el complemento con la misma cuenta de Google y ahí estarán tus conexiones.

¿Se copian mis datos a los flujos de consulta?

No. El agente ejecuta la consulta donde se encuentran sus datos y solo envía las filas que devuelve. No se sincroniza ni se almacena nada entretanto.

¿El plan gratuito realmente cubre esto?

Sí. Gratis es un plan que usted conserva, no una prueba que caduca. Vea exactamente lo que incluye en el página de precios.

¿La hoja se actualiza automáticamente?

Haz clic en Ejecutar consulta de nuevo cuando quieras ver las filas más recientes. Para que la hoja se actualice automáticamente según un horario, configura una automatización en el portal de Flujos de consulta (Flujos → Automatización). Esta función está disponible en todos los planes.

¿Sigues atascado? Abrir Ayuda En Query Streams, indíquenos en qué paso se encuentra y qué observa. Le ayudaremos a conectarse.

Crea tu cuenta del plan gratuito Vea qué incluye Free

Query Streams también conecta los mismos datos aExcel Claude, Cursor y ChatGPT una API REST y más

Cada guía para HubSpot

¿Problemas con la configuración?

¿El agente aparece como desconectado o las opciones "Probar conexión" y "Explorar" están deshabilitadas? Compruebe que el agente esté en línea → ¿Está el agente en línea?