Documentation Index
Fetch the complete documentation index at: https://help.treble.ai/llms.txt
Use this file to discover all available pages before exploring further.

Acciones disponibles por entidad
Contacto
| Acción | ¿Qué puedes hacer? |
|---|---|
| Create | Crear un nuevo contacto en HubSpot, incluyendo propiedades estándar y personalizadas. |
| Update | Actualizar un contacto existente, incluyendo propiedades estándar y personalizadas. |
| Remove | Eliminar un contacto existente en HubSpot. |
| List | Listar múltiples contactos según los filtros disponibles. |
| Get | Consultar un contacto específico por su identificador. |
Empresa (Company)
| Acción | ¿Qué puedes hacer? |
|---|---|
| Create | Crear una nueva empresa en HubSpot, incluyendo propiedades estándar y personalizadas. |
| Update | Actualizar una empresa existente, incluyendo propiedades estándar y personalizadas. |
| Remove | Eliminar una empresa existente en HubSpot. |
| List | Listar múltiples empresas según los filtros disponibles. |
| Get | Consultar una empresa específica por su identificador. |
Negocio (Deal / Oportunidad)
| Acción | ¿Qué puedes hacer? |
|---|---|
| Create | Crear un nuevo negocio en HubSpot, incluyendo propiedades estándar y personalizadas. |
| Update | Actualizar un negocio existente, incluyendo propiedades estándar y personalizadas. |
| Remove | Eliminar un negocio existente en HubSpot. |
| List | Listar múltiples negocios según los filtros disponibles. |
| Get | Consultar un negocio específico por su identificador. |
Pipeline
| Acción | ¿Qué puedes hacer? |
|---|---|
| Remove | Eliminar un pipeline existente en HubSpot. |
| List | Listar múltiples pipelines disponibles. |
| Get | Consultar un pipeline específico por su identificador. |
¿Cómo usar las herramientas de Treble para HubSpot?
La integración de HubSpot con Treble hace uso de el asistente de IA “Automatizar tareas complejas” para ejecutar las acciones de las herramientas de Treble para HubSpot. Para ello, es indispensable que sepas cómo usar el asistente de IA “Automatizar tareas complejas” en Treble y cómo configurar las herramientas de Treble para HubSpot. Si necesitas más información sobre cómo usar el asistente de IA “Automatizar tareas complejas” en Treble, puedes consultar la documentación de “Automatizar tareas complejas” en Treble en el siguiente enlace:Asistente de IA Automatizar tareas complejas en Treble
Aprende a usar el asistente de IA “Automatizar tareas complejas” en Treble.
Configuración de las herramientas de Treble para HubSpot
Para configurar las herramientas de Treble para HubSpot, debes seguir los siguientes pasos:- Ingresa a la sección de “AI Center” en Treble.
- Crea un nuevo agente de IA.
- Selecciona la opción de “Automatizar tareas complejas”.
- En la sección de “Herramientas”, selecciona la herramienta de “Aplicaciones Conectadas”.
- En la sección de “Aplicaciones Conectadas”, selecciona la aplicación de “HubSpot”.
- En la sección de “Herramientas”, selecciona la herramienta de “HubSpot” que deseas configurar.

Herramienta Buscar Contacto por Teléfono
Dentro de las herramientas listadas de Treble para HubSpot, existe la herramienta “Buscar Contacto por Teléfono”. Esta herramienta te permite buscar Contactos por teléfono. La herramienta automáticamente busca el Contacto en HubSpot según el teléfono de WhatsApp del cliente que está interactuando con tu asistente de IA por medio de una línea de WhatsApp conectada a Treble. No es necesario que tu asistente de IA tenga que preguntar por el teléfono del cliente, la herramienta lo hará automáticamente.

Formato del teléfono en HubSpot y propiedades
Treble utiliza el formato de teléfono internacional para buscar Contactos en HubSpot. Por ejemplo, si el teléfono del cliente es del país Estados Unidos y el teléfono es(917) 555-0111, Treble lo buscará en HubSpot como +19175550111. Treble hará la búsqueda dentro de la propiedad Phone en HubSpot.
Ten en cuenta que, en ultimas, el agente de IA es quien decide en qué formato realizar la busqueda. Por defecto, el agente intentará buscar en formato internacional. Sin embargo, si en tu HubSpot los telefonos no están guardados en formato internacional, puedes indicarle al agente dentro de sus instrucciones (prompt) qué formato debe usar para hacer la busqueda.
Ejemplos de instrucciones para el agente de IA:
- Colombia: “Cuando uses la herramienta de buscar Contacto por telefono, busca primero en formato local de Colombia (por ejemplo,
3001234567) y, si no encuentras resultados, intenta en formato internacional (+573001234567).” - Argentina: “Cuando busques por telefono en HubSpot, prioriza formato local de Argentina (por ejemplo,
1151234567o3515123456). Si no hay coincidencias, intenta formato internacional (+541151234567o+543515123456).” - Brasil: “Para buscar Contactos por telefono, usa primero formato local de Brasil (por ejemplo,
11987654321). Si no hay resultados, prueba tambien formato internacional (+5511987654321).”
Herramientas con Opciones de Configuración
Para las demás herramientas, como Crear Contacto, Actualizar Contacto, Crear Empresa, Crear Negocio, Buscar (Get) un Pipeline, etc., estas herramientas tienen opciones de configuración. Estas opciones de configuración te permiten interactuar con propiedades de esas entidades. Estas propiedades pueden ser estándar o personalizadas. Miremos algunos ejemplos de configuraciones de herramientas.Ejemplo Crear Contacto
La herramienta “Crear Contacto” te permite crear un nuevo contacto en HubSpot. Para configurar esta herramienta, debes seguir los siguientes pasos:- Activa la vista de herramientas de HubSpot dentro de la sección de “Herramientas” de tu asistente de IA.
- Has click en la herramienta de “Create CRM Contact”.
- En esta vista selecciona las propiedades que deseas configurar para el contacto. Puedes seleccionar propiedades estándar o personalizadas. En este ejemplo, vamos a seleccionar las propiedades “Name”, “Emails”, “Telephone” y “Address”.

-
Haz click en “Siguiente Paso”. En la vista “Parámetros manejados por Agente IA” debes seleccionar qué propiedades quieres que el agente de IA complete dinámicamente durante la conversación.
Cuando una propiedad está marcada como “manejada por Agente IA”, el agente intentará extraer ese valor del contexto del chat (por ejemplo, nombre, email o teléfono). Si no encuentra el dato con suficiente claridad, hará una pregunta al cliente para completarlo antes de ejecutar la herramienta.
Para obtener mejores resultados, define instrucciones explícitas en el prompt del agente sobre qué campos debe recopilar y cómo debe hacerlo. Ejemplo recomendado: “Cuando uses la herramienta Crear Contacto, intenta extraer
Name,EmailsyTelephonedel contexto de la conversación. Si falta alguno, solicítalo al cliente de forma breve y luego crea el Contacto.” En esta vista marca solo los campos variables. Los campos que quieras fijar con un valor predefinido (por ejemplo,Address = Calle 123, Ciudad) puedes dejarlos sin seleccionar aquí y configurarlos en la siguiente sección. En este caso vamos a seleccionar las propiedades “Name”, “Emails” y “Telephone”. (Dejamos sin seleccionar la propiedad “Address” para configurarla manualmente en la siguiente sección.)

- En la siguiente vista, vamos a configurar los campos donde el Contacto se debería crear con algunas propiedades predefinidas. Por ejemplo, si todos tus contactos operan en la misma ciudad y quieres registrar la dirección de forma manual, puedes escribir en el campo “Address” el valor fijo que corresponda, como
Calle 123, Ciudad. Esto lo puedes configurar con múltiples propiedades, es decir, puedes configurar varias propiedades con un valor predefinido, lo importante es no seleccionarlas dentro de la vista “Parámetros manejados por Agente IA”.

¡Felicitaciones! Ya has configurado la herramienta Crear Contacto.