Integración · CRM

Conectar HubSpot a Igniten

Conecte su portal de HubSpot para que Igniten pueda contestar sobre el estado real del CRM y, si lo habilita, escribir en él: crear una nota, dejar una tarea, mover una oportunidad de etapa. Nada del CRM se copia a un índice aparte: cada pregunta se responde leyendo HubSpot en el momento, así que una etapa que cambió hace un minuto ya sale con el valor nuevo.

Qué lee Igniten, y qué no

Lee

Contactos, empresas y negocios, con sus campos y su etapa
Notas y tareas asociadas a esos registros
Los usuarios del portal, para poder asignar una tarea a alguien

No lee

Los objetos personalizados que haya creado en su portal
Nada para lo que no haya marcado el alcance al crear la clave
Los registros no se copian ni se guardan: se leen cuando alguien pregunta

Cómo se conecta

2 pasos · ≈ 3 min

1
Pegar la clave de API

Un único service key de HubSpot para toda la organización. No hace falta ninguna URL.
- En HubSpot: Development → Keys → Service keys → Create service key.
- Marque los alcances de contactos, empresas, negocios, notas y tareas; los de escritura sólo si quiere que Igniten escriba en el CRM.
- La clave empieza con «pat-» y se muestra una sola vez.
- Las apps privadas legadas siguen funcionando, pero HubSpot dejó de ofrecer su creación a las cuentas nuevas desde el 28 de septiembre de 2026.
Salió bien si La consola del proveedor le muestra la clave una sola vez: si ya la copió, este paso está hecho.
2
Queda guardada y en uso

Desde que la guarda, lo que se le pregunte a su CRM sale con esa clave. Acá no se comprueba contra el proveedor: si la clave está equivocada, se ve en la primera consulta.
- No hay botón de probar en este recorrido, y eso es a propósito: lo único que sabríamos contestar es si la fila quedó guardada, no si la clave abre algo.
- Si la clave está equivocada, se ve en la primera consulta y la respuesta lo dice.
- Para cambiarla se carga una nueva: la anterior no se puede volver a ver.
Salió bien si La integración figura conectada y muestra los últimos cuatro caracteres de la clave.

Qué permisos pide

Permiso	Para qué	Cuándo hace falta
`crm.objects.contacts.read`	Responder sobre contactos	Siempre
`crm.schemas.contacts.read`	Entender qué campos tiene un contacto en su portal	Siempre
`crm.objects.contacts.write`	Crear o editar un contacto cuando se lo pide	quiere que Igniten escriba en el CRM
`crm.objects.companies.read`	Responder sobre empresas	Siempre
`crm.schemas.companies.read`	Entender qué campos tiene una empresa en su portal	Siempre
`crm.objects.companies.write`	Crear o editar una empresa cuando se lo pide	quiere que Igniten escriba en el CRM
`crm.objects.deals.read`	Responder sobre negocios y su etapa	Siempre
`crm.schemas.deals.read`	Conocer las etapas del embudo de su portal	Siempre
`crm.objects.deals.write`	Mover un negocio de etapa cuando se lo pide	quiere que Igniten escriba en el CRM
`crm.objects.notes.read`	Responder sobre lo que quedó anotado en un registro	Siempre
`crm.objects.notes.write`	Dejar una nota en un registro cuando se lo pide	quiere que Igniten escriba en el CRM
`crm.objects.tasks.read`	Responder sobre tareas pendientes	Siempre
`crm.objects.tasks.write`	Crear una tarea cuando se lo pide	quiere que Igniten escriba en el CRM
`crm.objects.owners.read`	Saber a quién asignarle una tarea	Siempre

Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.

Qué puede salir mal

La respuesta dice que las notas no están disponibles y el resto contesta bien

Por qué A la clave de servicio le falta el alcance de notas.

Qué hacer Edite la clave en HubSpot y marque el alcance que falte. El resto sigue funcionando mientras tanto: falta un objeto, no la conexión.

Los enlaces a HubSpot no abren el registro

Por qué No se pudo resolver el identificador del portal, que es de donde sale el enlace.

Qué hacer Suele ser un alcance de menos en la clave. Vuelva a crearla con los alcances de la lista.

Nada del CRM responde

Por qué La clave está vencida, revocada o mal pegada.

Qué hacer Cree una clave nueva en HubSpot y cárguela de nuevo acá.

Una búsqueda devuelve cien resultados y avisa que hay más

Por qué Es un tope nuestro, para no vaciar su cuota de HubSpot en una sola pregunta.

Qué hacer Acote la pregunta: por empresa, por etapa o por fecha.

Los límites, dichos

HubSpot admite alrededor de cinco búsquedas por segundo con una misma clave.
Un listado devuelve como máximo cien registros por pregunta.

Preguntas frecuentes

¿Uso una app privada o una clave de servicio?

Una clave de servicio. Las apps privadas siguen funcionando si ya tiene una, pero HubSpot dejó de ofrecer su creación a las cuentas nuevas desde el 28 de septiembre de 2026.

¿Tengo que cargar alguna dirección o identificador de portal?

No. La API de HubSpot es siempre la misma y el identificador de su portal se resuelve solo a partir de la clave. Lo único que se pega acá es la clave, que empieza con «pat-».

¿Puedo conectar HubSpot si ya tengo Twenty?

Puede tener los dos cargados, pero se consulta Twenty y la respuesta lo aclara. Para pasar a HubSpot, quite la clave de Twenty desde esta misma pantalla.

¿Igniten puede borrar algo de mi CRM?

No. No hay ninguna acción de borrado, ni siquiera con los alcances de escritura otorgados. Lo que escribe se confirma antes de salir.