Guía de la aplicación HubSpot

OOMOL te permite conectar HubSpot una vez y luego poner las herramientas autorizadas de HubSpot CRM a disposición de los agentes de IA y Skills reutilizables con los que ya trabajas. Esta guía explica cómo añadir la aplicación HubSpot, qué permisos usa OOMOL, qué puedes hacer con ella, cómo solucionar problemas comunes y cómo eliminar la aplicación.

Requisitos previos

Una cuenta de OOMOL.
Una cuenta de HubSpot que tengas permitido autorizar para aplicaciones de terceros.
Acceso a OOMOL Console en https://console.oomol.com/.
Permiso en HubSpot para autorizar aplicaciones con los scopes de objetos CRM y esquema CRM.
Registros de contacto, empresa y negocio de prueba si quieres probar las herramientas de búsqueda, lectura o actualización.
Si tu organización de HubSpot restringe las aplicaciones de terceros, es posible que tu administrador de HubSpot deba permitir la aplicación OOMOL antes de que puedas autorizarla.

Añadir la aplicación

Inicia sesión en OOMOL Console.
Abre Connectables o ve directamente a Connections.
Busca HubSpot.
Selecciona HubSpot y luego elige Connect.
OOMOL te redirige a HubSpot. Inicia sesión en HubSpot si se te solicita.
Revisa la pantalla de autorización de HubSpot, incluidos los permisos de CRM solicitados.
Selecciona la cuenta de HubSpot que quieres conectar.
Selecciona Connect app o la acción de autorización equivalente que muestre HubSpot.
Después de que HubSpot te redirija de vuelta a OOMOL, confirma que HubSpot aparece como conectado en tus conexiones de OOMOL.

Si algún paso falla, consulta Solución de problemas.

Después de la autorización, OOMOL almacena la conexión necesaria para llamar a las herramientas de HubSpot en tu nombre. Luego puedes usar las herramientas de HubSpot desde agentes compatibles con OOMOL, Skills reutilizables y flujos de trabajo.

Uso

Las herramientas de HubSpot solo están disponibles después de que conectes una cuenta de HubSpot. La lista exacta de herramientas que se muestra en OOMOL puede cambiar a medida que se actualiza el conector, pero el conector de HubSpot actual admite leer definiciones de propiedades de CRM y buscar, leer, crear y actualizar contactos, empresas y negocios.

Usar las herramientas de HubSpot con oo CLI

Para poner las herramientas de HubSpot conectadas a disposición en un entorno de agente de IA compatible, instala y configura oo CLI después de iniciar sesión en OOMOL.

Inicia sesión en OOMOL Console.
Abre la página de instalación de oo CLI.
Sigue las instrucciones de esa página. La página proporciona un prompt de copia con un solo clic para instalar y configurar oo CLI en un entorno de agente de IA compatible.
Después de que oo CLI esté configurado y HubSpot esté conectado en OOMOL, pide al agente que use las herramientas conectadas de HubSpot CRM con datos de CRM de demostración.

El prompt exacto del agente puede variar según el entorno. Por ejemplo, puedes pedir al agente que cree un contacto de demostración, busque ese contacto por correo electrónico, actualice un campo editable como el cargo o enumere las propiedades de HubSpot CRM.

Permisos utilizados

OOMOL usa estos scopes de HubSpot para permitir que un usuario autorizado de HubSpot conecte HubSpot como una App en OOMOL y luego ponga las herramientas de CRM aprobadas a disposición de agentes y Skills reutilizables.

Scopes requeridos:

Scope de HubSpot	Usado por	Por qué OOMOL lo usa
`oauth`	Conexión OAuth de HubSpot	Completar el flujo de autorización OAuth de HubSpot y mantener la conexión autorizada de HubSpot en OOMOL.
`crm.objects.contacts.read`	Search Contacts, Get Contact	Buscar y leer registros de contacto de HubSpot cuando un usuario o una acción de agente aprobada solicita información de contacto.
`crm.objects.contacts.write`	Create Contact, Update Contact	Crear o actualizar registros de contacto de HubSpot cuando un usuario o una acción de agente aprobada proporciona los detalles de contacto requeridos.
`crm.objects.companies.read`	Search Companies, Get Company	Buscar y leer registros de empresa de HubSpot cuando un usuario o una acción de agente aprobada solicita información de empresa.
`crm.objects.companies.write`	Create Company, Update Company	Crear o actualizar registros de empresa de HubSpot cuando un usuario o una acción de agente aprobada proporciona los detalles de empresa requeridos.
`crm.objects.deals.read`	Search Deals, Get Deal	Buscar y leer registros de negocio de HubSpot cuando un usuario o una acción de agente aprobada solicita información de negocio.
`crm.objects.deals.write`	Create Deal, Update Deal	Crear o actualizar registros de negocio de HubSpot cuando un usuario o una acción de agente aprobada proporciona los detalles de negocio requeridos.
`crm.schemas.contacts.read`	List Properties, Get Property	Leer definiciones de propiedades de contacto para que las herramientas puedan usar campos de contacto válidos de HubSpot.
`crm.schemas.companies.read`	List Properties, Get Property	Leer definiciones de propiedades de empresa para que las herramientas puedan usar campos de empresa válidos de HubSpot.
`crm.schemas.deals.read`	List Properties, Get Property	Leer definiciones de propiedades de negocio para que las herramientas puedan usar campos de negocio válidos de HubSpot.

Herramientas de HubSpot compatibles

Herramienta	Función compatible	Caso de uso típico	Requisitos previos
List Properties	Enumera definiciones de propiedades de contactos, empresas o negocios.	Permitir que un agente entienda qué campos de CRM están disponibles antes de crear filtros, crear registros o actualizar campos.	HubSpot está conectado en OOMOL y la cuenta conectada tiene acceso a los esquemas de propiedades de CRM.
Get Property	Lee una definición de propiedad, como la propiedad `email` en contactos.	Comprobar un campo de CRM específico antes de usarlo en una acción de búsqueda, creación o actualización.	HubSpot está conectado en OOMOL y la propiedad solicitada existe.
Search Contacts	Busca contactos con palabras clave, filtros, ordenación y campos de retorno seleccionados.	Encontrar a la persona correcta antes de una llamada, transferencia, tarea de soporte o seguimiento.	HubSpot está conectado en OOMOL y la cuenta conectada puede leer contactos.
Get Contact	Lee un contacto por el ID de registro de HubSpot o una propiedad única personalizada.	Extraer detalles de contacto en un flujo de trabajo de agente antes de dar el siguiente paso.	HubSpot está conectado en OOMOL y el contacto solicitado está disponible para la cuenta conectada.
Create Contact	Crea un contacto con las propiedades proporcionadas y asociaciones opcionales.	Guardar un nuevo lead, cliente o interlocutor a partir de la información que el usuario da al agente.	HubSpot está conectado en OOMOL y el usuario tiene los detalles de contacto requeridos.
Update Contact	Actualiza propiedades de contacto por ID de registro o una propiedad única personalizada.	Mantener actualizado un registro de contacto después de una llamada, correo electrónico, tarea de investigación o paso de flujo de trabajo.	HubSpot está conectado en OOMOL, el contacto se puede localizar y el usuario ha aprobado los detalles actualizados.
Search Companies	Busca empresas con palabras clave, filtros, ordenación y campos de retorno seleccionados.	Encontrar información de cuenta antes de preparar investigación, contacto o seguimiento.	HubSpot está conectado en OOMOL y la cuenta conectada puede leer empresas.
Get Company	Lee una empresa por el ID de registro de HubSpot o una propiedad única personalizada.	Extraer detalles de cuenta en un flujo de trabajo de agente antes de crear notas, planes o actualizaciones.	HubSpot está conectado en OOMOL y la empresa solicitada está disponible para la cuenta conectada.
Create Company	Crea una empresa con las propiedades proporcionadas y asociaciones opcionales.	Añadir una nueva cuenta a partir de la información de empresa proporcionada por el usuario.	HubSpot está conectado en OOMOL y el usuario tiene los detalles de empresa requeridos.
Update Company	Actualiza propiedades de empresa por ID de registro o una propiedad única personalizada.	Mantener actualizados los detalles de cuenta después de una investigación, trabajo de ventas o revisión de operaciones.	HubSpot está conectado en OOMOL, la empresa se puede localizar y el usuario ha aprobado los detalles actualizados.
Search Deals	Busca negocios con palabras clave, filtros, ordenación y campos de retorno seleccionados.	Encontrar la oportunidad correcta antes de una revisión de pipeline, previsión o seguimiento.	HubSpot está conectado en OOMOL y la cuenta conectada puede leer negocios.
Get Deal	Lee un negocio por el ID de registro de HubSpot o una propiedad única personalizada.	Extraer detalles de oportunidad en un flujo de trabajo de agente antes de resumirlo o actualizarlo.	HubSpot está conectado en OOMOL y el negocio solicitado está disponible para la cuenta conectada.
Create Deal	Crea un negocio con las propiedades proporcionadas y asociaciones opcionales.	Añadir una nueva oportunidad a partir de la información de ventas proporcionada por el usuario.	HubSpot está conectado en OOMOL y el usuario tiene los detalles de negocio requeridos.
Update Deal	Actualiza propiedades de negocio por ID de registro o una propiedad única personalizada.	Mantener actualizados los detalles del pipeline después de una interacción con el cliente o una revisión interna.	HubSpot está conectado en OOMOL, el negocio se puede localizar y el usuario ha aprobado los detalles actualizados.

Buscar y leer registros de CRM

Caso de uso: permitir que un agente encuentre el contacto, la empresa o el negocio correcto de HubSpot antes de una llamada, transferencia, tarea de investigación o seguimiento.

Requisitos previos:

HubSpot está conectado en OOMOL.
La cuenta de HubSpot conectada tiene permiso para leer el objeto de CRM solicitado.
El agente o flujo de trabajo tiene una palabra clave de búsqueda, un filtro, un ID de registro o un valor de propiedad única.

Qué hacen las herramientas:

Buscar o leer contactos, empresas y negocios disponibles para la cuenta de HubSpot conectada.
Devolver los campos de HubSpot solicitados por la entrada de la herramienta cuando estén disponibles.
No crear, actualizar ni eliminar registros durante acciones de solo lectura.

Crear registros de CRM

Caso de uso: permitir que un agente cree un contacto, una empresa o un negocio de HubSpot a partir de información proporcionada por el usuario, como un nuevo cliente, cuenta u oportunidad.

Requisitos previos:

HubSpot está conectado en OOMOL.
La cuenta de HubSpot conectada tiene permiso para crear el objeto de CRM solicitado.
El agente o flujo de trabajo tiene las propiedades requeridas para el nuevo registro.
Si se incluyen asociaciones, los registros relacionados deben ser válidos y estar disponibles para la cuenta conectada.

Qué hacen las herramientas:

Crear un contacto, una empresa o un negocio de HubSpot según las entradas proporcionadas.
Devolver la información del registro que HubSpot pone a disposición, como el ID de registro y las propiedades seleccionadas.
No inventar valores de CRM faltantes. Los valores requeridos deben ser proporcionados por el usuario, el flujo de trabajo o la fuente de datos conectada.

Actualizar registros de CRM

Caso de uso: permitir que un agente mantenga actualizados los registros de HubSpot cuando un usuario le pide que cambie un campo de contacto, empresa o negocio.

Requisitos previos:

HubSpot está conectado en OOMOL.
La cuenta de HubSpot conectada tiene permiso para actualizar el objeto de CRM solicitado.
El agente o flujo de trabajo puede localizar el registro objetivo por el ID de registro de HubSpot o una propiedad única personalizada.
Los valores actualizados son válidos para las definiciones de propiedades de HubSpot.

Qué hacen las herramientas:

Actualizar propiedades compatibles de contacto, empresa o negocio de HubSpot según las entradas proporcionadas.
Devolver el resultado de la actualización que HubSpot pone a disposición.
No eliminar registros.

Probar la aplicación

Puedes probar la aplicación HubSpot con cualquier cuenta de HubSpot que tengas permitido autorizar. Usa contactos, empresas y negocios de demostración para poder probar de forma segura las acciones de búsqueda, creación y actualización.

Prompts de prueba de ejemplo

Crea un contacto de HubSpot llamado Demo Contact con el correo electrónico demo-contact@example.com.
Busca en los contactos de HubSpot demo-contact@example.com.
Obtén el contacto de HubSpot con el correo electrónico demo-contact@example.com.
Actualiza el contacto de HubSpot con el correo electrónico demo-contact@example.com y establece el cargo como Demo Buyer.
Busca en las empresas de HubSpot Demo Company.
Crea una empresa de HubSpot llamada Demo Company.
Busca en los negocios de HubSpot Demo Deal.
Crea un negocio de HubSpot llamado Demo Deal con valores de prueba de ejemplo.
Actualiza el importe o la fecha de cierre de Demo Deal.
Enumera las propiedades de contacto de HubSpot.
Obtén la definición de la propiedad de contacto de HubSpot para email.

Usa solo datos de demostración durante las pruebas. No uses datos de clientes reales en los prompts de prueba.

Solución de problemas

No puedo añadir la aplicación HubSpot

Asegúrate de haber iniciado sesión en la cuenta de OOMOL correcta.
Asegúrate de iniciar sesión en la cuenta de HubSpot que quieres conectar.
Confirma que la cuenta de HubSpot permite los scopes de CRM solicitados.
Si la cuenta de HubSpot pertenece a una organización, pregunta a un administrador de HubSpot si las aplicaciones de terceros requieren aprobación.
Intenta desconectar cualquier conexión de HubSpot fallida o parcial en OOMOL y luego vuelve a conectar.
Si el problema continúa, contacta con el soporte de OOMOL e incluye el correo electrónico de la cuenta de OOMOL, la cuenta de HubSpot o el ID de portal, la hora del intento y cualquier mensaje de error o captura de pantalla.

Una herramienta de HubSpot no encuentra un registro

Confirma que la cuenta de HubSpot conectada tiene acceso al contacto, la empresa o el negocio solicitados.
Confirma que el flujo de trabajo usa el ID de registro, la propiedad única, la palabra clave de búsqueda o el filtro correctos.
Comprueba si el registro existe en la cuenta de HubSpot conectada a OOMOL.
Si cambiaste recientemente los permisos de HubSpot, vuelve a conectar HubSpot en OOMOL para que se actualice el estado de autorización.

Una herramienta de HubSpot no puede crear un registro

Confirma que la cuenta de HubSpot conectada puede crear el contacto, la empresa o el negocio solicitados directamente en HubSpot.
Comprueba que se incluyen todas las propiedades requeridas de HubSpot.
Comprueba que los valores proporcionados son válidos para las definiciones de propiedades de HubSpot.
Si se incluyen asociaciones, confirma que los registros asociados y los tipos de asociación son válidos.

Una herramienta de HubSpot no puede actualizar un registro

Confirma que la cuenta de HubSpot conectada tiene permiso para actualizar el registro solicitado.
Confirma que el flujo de trabajo usa el ID de registro de HubSpot o la propiedad única personalizada correctos.
Comprueba que los campos y valores actualizados son válidos para HubSpot.
Si una propiedad es de solo lectura o está restringida en HubSpot, quítala de la solicitud de actualización o actualízala directamente en HubSpot.

Eliminar la aplicación

Puedes eliminar la aplicación HubSpot desde OOMOL o desde HubSpot. Recomendamos eliminarla de ambos lugares si ya no quieres que OOMOL acceda a HubSpot.

Eliminar HubSpot de OOMOL

Inicia sesión en OOMOL Console.
Abre Connections.
Encuentra HubSpot en tus aplicaciones conectadas.
Abre los detalles de la conexión de HubSpot.
Elige Disconnect, Remove o la acción de eliminación equivalente que se muestre en OOMOL.
Confirma la eliminación.

Eliminar OOMOL de HubSpot

Inicia sesión en HubSpot.
Abre Settings.
Abre Integrations y luego Connected Apps.
Encuentra OOMOL.
Elige la acción para desinstalar, desconectar o eliminar la aplicación.
Confirma la eliminación.

Qué ocurre después de la eliminación

OOMOL ya no puede usar las herramientas de HubSpot para tu cuenta después de que se elimine o se desautorice la conexión de HubSpot.
Los flujos de trabajo, agentes o Skills que dependen de HubSpot pueden fallar hasta que vuelvas a conectar HubSpot.
Los registros de HubSpot existentes creados o actualizados antes de la eliminación permanecen en HubSpot a menos que los cambies o elimines en HubSpot.
Eliminar la aplicación no elimina tu cuenta de OOMOL.

Tratamiento de datos

OOMOL accede a los datos de HubSpot solo después de que un usuario de HubSpot autorice la aplicación y una acción de usuario o de agente aprobada requiera HubSpot. OOMOL usa los datos de HubSpot solo para proporcionar las herramientas de HubSpot solicitadas a través de agentes compatibles con OOMOL, Skills reutilizables y flujos de trabajo.

Los tokens OAuth de HubSpot se almacenan cifrados.
OOMOL no expone los tokens OAuth de HubSpot a agentes de IA, prompts, clientes de navegador, código de aplicación ni usuarios finales.
OOMOL puede procesar metadatos de contacto, empresa, negocio y propiedades de CRM de HubSpot cuando se llama a una herramienta de HubSpot.
Los datos de HubSpot pueden almacenarse solo según sea necesario en resultados de herramientas visibles para el usuario, registros de uso, historial de ejecución o registros operativos.
Los datos almacenados se cifran en reposo y se transmiten mediante TLS/SSL.
OOMOL no vende tus datos de HubSpot.
OOMOL no usa datos de HubSpot para publicidad.
OOMOL no usa contenido privado de clientes para entrenar modelos de IA.
Cuando eliminas o desautorizas la aplicación HubSpot, OOMOL deja de usar la autorización de HubSpot revocada. OOMOL elimina o invalida los tokens de autorización de HubSpot almacenados según su proceso normal de eliminación de conexiones.
Algunos registros, registros de soporte, registros de seguridad o registros relacionados con la facturación pueden conservarse como se describe en la Privacy Policy.

Preguntas frecuentes

¿OOMOL sincroniza continuamente los datos de HubSpot?

OOMOL accede a los datos de HubSpot a petición cuando un usuario autorizado o una acción de agente aprobada llama a una herramienta de HubSpot.

¿Puede un agente usar HubSpot automáticamente después de que lo conecte?

Conectar HubSpot pone las herramientas de HubSpot a disposición en OOMOL, pero el uso de herramientas aún depende del agente, el flujo de trabajo, el Skill y los permisos que elijas. Los servicios basados en cuenta aún requieren tu autorización.

¿Puede OOMOL eliminar registros de HubSpot?

El conector de HubSpot actual descrito en esta guía admite buscar, leer, crear y actualizar contactos, empresas y negocios. No incluye una herramienta de eliminación de registros.

¿Puedo conectar más de una cuenta de HubSpot?

Usa OOMOL Console para comprobar las opciones de conexión actuales disponibles para tu cuenta o espacio de trabajo. Si necesitas ayuda con varias cuentas de HubSpot, contacta con soporte.

¿Necesito una cuenta de HubSpot de pago?

La mayoría de las herramientas de HubSpot de OOMOL requieren una cuenta de HubSpot que pueda autorizar los scopes de CRM solicitados. Algunas funciones de HubSpot, acceso a objetos, acceso a propiedades o controles de administración pueden depender de tu plan de HubSpot o de la configuración de la organización.

Contactar con soporte

Si necesitas ayuda para añadir, usar, probar o eliminar la aplicación HubSpot, contacta con el soporte de OOMOL:

Correo electrónico: support@oomol.com
Página de soporte: Soporte de OOMOL

Incluye el correo electrónico de tu cuenta de OOMOL, la cuenta de HubSpot conectada o el ID de portal si es relevante, la acción que intentabas realizar y cualquier mensaje de error o captura de pantalla.