HubSpot

Conecte HubSpot con su propia aplicación OAuth para que un agente pueda guardar clientes potenciales, añadir notas y consultar un contacto durante una llamada.

Qué conseguirá

Un agente podrá crear un contacto en HubSpot, añadirle una nota y leer el historial de un contacto mientras quien llama está en línea.

Descripción general y casos de uso

Guardar a cada nuevo interlocutor como contacto de HubSpot con nombre, correo, teléfono y empresa.
Añadir una nota de la llamada al contacto correcto tras la conversación.
Saludar a quien vuelve a llamar con lo que HubSpot ya sabe de él.

Requisitos previos

Una cuenta de HubSpot y una cuenta de desarrollador de HubSpot para crear la aplicación OAuth. HubSpot ya no ofrece claves de API (retiradas en noviembre de 2022), así que OAuth es la única vía.
El rol de owner o admin en Phynxa.

Configuración de la cuenta externa (en HubSpot)

HubSpot controla estas pantallas; la redacción puede cambiar. La guía de HubSpot: HubSpot CRM API.

En su cuenta de desarrollador de HubSpot, cree una aplicación para Phynxa.
En los ajustes de autenticación de la aplicación, añada la URL de redireccionamiento que muestra el cuadro Connect de Phynxa (cópiela exactamente).
Añada los ámbitos (scopes) que figuran más abajo.
Copie el Client ID y el Client secret de la aplicación.

Conéctelo en Phynxa

Abra Integrations y elija Connect en HubSpot.
Pegue el Client ID y el Client secret.
Continúe hasta HubSpot, elija su cuenta y apruebe.
Vuelve a Phynxa y la tarjeta muestra Connected.

Permisos y ajustes

Scope	Para qué
`crm.objects.contacts.read` y `crm.objects.contacts.write`	Buscar, crear y actualizar contactos
`crm.objects.deals.read` y `crm.objects.deals.write`	Negocios (reservado para uso futuro; todavía no se ofrece como herramienta de agente)
`tickets`	Tickets (los usa Create ticket)

Úselo en una llamada

En la pestaña Tools de un agente, Add tool, Integration, HubSpot:

Acción	Qué hace	Se ejecuta
Create lead	Crea un contacto a partir del nombre, los apellidos, el correo, el teléfono y la empresa.	En segundo plano
Add note	Añade una nota. Dele el id del contacto para que quede asociada a él; sin él, la nota no queda vinculada a ningún contacto.	En segundo plano
Fetch customer history	Lee un contacto (por correo o id) con sus notas, tareas, negocios y tickets.	Espera la respuesta
Update contact	Cambia el nombre, el correo, el teléfono o la empresa de un contacto; solo se cambia lo que indique. Necesita el id del contacto de una consulta de historial.	En segundo plano
Create task	Crea una tarea de seguimiento para su equipo (subject, y opcionales body y due_date como `2026-11-02`), vinculada a un contacto si indica su id.	En segundo plano
Create ticket	Abre un caso de soporte con un subject y un body opcional, vinculado a un contacto si indica su id.	En segundo plano

Pruébelo

En el menú ⋯ de la tarjeta, elija Test connection. Debe aparecer «HubSpot is responding.»
Asocie Create lead a un agente, abra Chat, diga «My name is Sam Lee, email sam@example.com, phone +14155550100» y busque el nuevo contacto en HubSpot.

Resultado esperado

El contacto aparece en HubSpot en pocos segundos y la página Integrations cuenta una solicitud correcta.

Solución de problemas

HubSpot dice que la URL de redireccionamiento no coincide. La URL de su aplicación de HubSpot debe ser exactamente la que mostró Phynxa.
403 o «missing scopes». Añada a la aplicación los ámbitos de arriba y después use Reconnect.
Add note crea una nota que nadie ve. No tenía id de contacto; use antes Fetch customer history o haga que el prompt pase el id.
La tarjeta muestra Error. Elija Reconnect; la tarjeta muestra el motivo de HubSpot.

Su Client secret se almacena cifrado y no se vuelve a mostrar. El acceso que obtiene Phynxa se limita a los ámbitos de arriba en la cuenta que usted aprobó. Remove elimina la conexión y las credenciales guardadas; revoque además la aplicación en HubSpot si deja de usarla.

Guías relacionadas

¿Algo de esto no coincide con lo que ve en el panel? Avísenos.