Conectar HubSpot
Tus clientes y cotizaciones de Cord, al día en HubSpot, sin capturarlos dos veces.
Qué hace la integración
- Cada cliente de Cord se crea en HubSpot como Empresa y, si tiene correo o nombre de contacto, también como Contacto asociado a esa Empresa.
- Cada cotización enviada se crea como Deal con su monto y su divisa, asociado a la Empresa y al Contacto del cliente.
- El Deal avanza solo: Cord mueve su etapa cuando el cliente abre la cotización, la aprueba, la rechaza, vence, la paga o se factura.
- Las correcciones de contacto regresan a Cord: si corriges en HubSpot el nombre de la Empresa, o el nombre, correo o teléfono del Contacto, también cambian en Cord.
El detalle completo de qué campo va a dónde está en Qué se sincroniza.
Cord manda sobre el estado de la venta. Mover un Deal de etapa en HubSpot no cambia la cotización en Cord: su estado lo deciden la aprobación y el pago del cliente.
Qué viaja y en qué dirección
| Dirección | Qué viaja | Cuándo |
|---|---|---|
| De Cord a HubSpot | Cada cliente como Empresa y Contacto; cada cotización enviada como Deal, con su monto, su divisa y su etapa. | Al crear o cambiar el cliente, y cada vez que la cotización avanza. |
| De HubSpot a Cord | Correcciones del nombre de la Empresa, y del nombre, correo y teléfono del Contacto, solo en registros ya ligados a Cord. | Al guardarlas en HubSpot. |
| De HubSpot a Cord | Nada más: mover un Deal de etapa, crear Empresas o Deals nuevos en HubSpot no cambia nada en Cord. | — |
| Desde un workflow | Una nota en el Deal o en la Empresa, con la acción Agregar una nota en HubSpot. | Cuando corre el workflow. |
El detalle campo por campo está en Qué se sincroniza.
Antes de conectar
- En Cord: necesitas el permiso de Ajustes.
- En HubSpot: necesitas un usuario que pueda instalar apps en la cuenta. Si no lo tienes, pide a un Super Admin de HubSpot que haga la conexión.
- Una cuenta por organización: una cuenta de HubSpot solo puede estar conectada a una organización de Cord, y cada organización de Cord se conecta a una sola cuenta de HubSpot.
- Divisas: si cotizas en varias divisas, actívalas en la configuración de divisas de tu cuenta de HubSpot. Un Deal en una divisa que HubSpot no tiene activada no se puede crear.
Conectar paso a paso
- Abre la app. Ve a Ajustes › Integraciones y toca HubSpot.
- Pulsa Conectar HubSpot. Cord te lleva a HubSpot.
- Elige la cuenta de HubSpot, si tienes varias, y acepta los permisos. Tienes 10 minutos para completar este paso; si tardas más, vuelve a pulsar Conectar.
- Regresa a Cord. Verás “HubSpot quedó conectado.” y el estado Conectado, con el nombre de la cuenta.
- Revisa las etapas. En Etapa de HubSpot para cada estado de la cotización, confirma el pipeline y la etapa de cada estado y pulsa Guardar etapas. Si usas el pipeline predeterminado de HubSpot, Cord ya propone una etapa para cada estado. Ver Pipeline y etapas.
- Envía lo que ya tenías (opcional). En Datos que ya tenías, pulsa Enviar datos existentes para mandar tus clientes y cotizaciones anteriores. Ver Qué se sincroniza.
Desde ese momento, cada cliente nuevo o actualizado y cada cotización que avance se envían solos.
Si el botón no te lleva a HubSpot o regresas a un error, vuelve a pulsar Conectar HubSpot desde Cord. No reutilices un enlace de autorización viejo guardado en el navegador: cada intento genera un enlace de un solo uso.
Permisos que pide Cord
Al autorizar, HubSpot te muestra los permisos que Cord solicita. Son solo los necesarios para esta integración:
| Permiso | Para qué |
|---|---|
| Leer y escribir Empresas | Crear la Empresa de cada cliente y leer las correcciones de nombre. |
| Leer y escribir Contactos | Crear el Contacto de cada cliente, buscar si ya existe por correo y leer correcciones. |
| Leer y escribir Deals | Crear el Deal de cada cotización, mover su etapa y leer tus pipelines. |
Cord no lee tus correos, llamadas, tickets, listas, formularios ni ningún otro objeto de HubSpot.
Mensajes al conectar
| Mensaje | Qué pasó | Qué hacer |
|---|---|---|
| HubSpot quedó conectado. | Todo bien. | Revisa las etapas. |
| Cancelaste la conexión con HubSpot. | Cerraste o rechazaste la autorización en HubSpot. | Vuelve a pulsar Conectar HubSpot cuando quieras. |
| La solicitud de conexión expiró o no es válida. Intenta de nuevo. | Pasaron más de 10 minutos, se usó un enlace viejo o se abrió desde otra sesión. | Pulsa Conectar HubSpot otra vez desde Cord. |
| Esa cuenta de HubSpot ya está conectada a otra organización de Cord. | La cuenta ya está en uso en otra organización. | Desconéctala en esa organización o elige otra cuenta. |
| No se pudo conectar HubSpot. Intenta de nuevo. | HubSpot no completó la autorización. | Intenta de nuevo; si persiste, escríbenos a contacto@cordhq.app. |
| Necesitas permiso de Ajustes para conectar integraciones. | Tu rol no tiene permiso de Ajustes. | Pide al dueño de la cuenta que conecte o te dé el permiso. |
El panel de la conexión
Una vez conectado, la página de HubSpot muestra:
| Dato | Qué es |
|---|---|
| Cuenta de HubSpot | El número y dominio de la cuenta conectada. |
| Última sincronización | Cuándo se envió o recibió algo por última vez. “Todavía no” si aún no pasa nada. |
| En cola | Envíos pendientes. |
| Errores (7 días) | Envíos que fallaron en la última semana. |
| Último error | El mensaje del error más reciente, si hay. |
Qué hacer con cada error: Problemas con HubSpot.
La tarjeta de Cord dentro de HubSpot
Esta función es nueva y puede no estar habilitada todavía en tu cuenta. Si no la ves, escríbenos.
Con HubSpot conectado, cada Deal, Empresa y Contacto muestra en su barra lateral la tarjeta de Cord:
| Registro | Qué muestra |
|---|---|
| Deal | La cotización de Cord ligada a ese Deal. |
| Empresa o Contacto | El cliente de Cord ligado y sus últimas 8 cotizaciones. |
Cada cotización trae folio, estado, importe con su divisa, fecha y el link del cliente, para copiarlo o abrirlo sin salir de HubSpot. El botón Crear cotización en Cord abre el editor de Cord con ese cliente ya elegido.
La tarjeta solo lee: crear, editar o enviar siempre ocurre en Cord, con tu sesión. Cord verifica que cada consulta venga firmada por HubSpot y responde solo con los datos de la organización conectada a esa cuenta.
Si la tarjeta no aparece, en HubSpot abre un Deal, pulsa Personalizar en la barra lateral y agrega la tarjeta Cord desde Apps.
Cambiar a otra cuenta de HubSpot
Desconecta la cuenta actual y conecta la nueva. Al conectar una cuenta distinta, Cord olvida los vínculos con la cuenta anterior y restablece la configuración de etapas, porque los pipelines de la otra cuenta no existen en la nueva. Después usa Enviar datos existentes para poblar la cuenta nueva.
Si vuelves a conectar la misma cuenta, Cord conserva los vínculos y tu configuración de etapas: no se duplican Empresas ni Deals. Los cambios que hiciste en Cord mientras estaba desconectado no se enviaron; usa Enviar datos existentes para ponerlos al día.
Desconectar
- En Ajustes › Integraciones › HubSpot, pulsa Desconectar.
- Confirma en ¿Desconectar HubSpot?.
- Verás “HubSpot desconectado”.
Al desconectar:
- Cord deja de sincronizar y descarta los envíos que estaban en cola.
- Cord revoca su acceso a tu cuenta de HubSpot.
- Lo que ya está en HubSpot no se borra: Empresas, Contactos, Deals y notas se quedan como están.
- Los workflows con la acción Agregar una nota en HubSpot empiezan a fallar con “Conecta HubSpot en Ajustes › Integraciones para usar esta acción.”
Límites
| Límite | Valor |
|---|---|
| Cuentas de HubSpot por organización | Una, y cada cuenta de HubSpot solo puede estar en una organización de Cord |
| Tiempo para autorizar en HubSpot | 10 minutos desde que pulsas Conectar HubSpot |
| Enviar datos existentes | Hasta 500 clientes y 500 cotizaciones enviadas por vez, hasta 3 veces por hora |
| Tarjeta de Cord en una Empresa o Contacto | Sus últimas 8 cotizaciones |
| Notas desde workflows | 120 por hora por organización, de hasta 2,000 caracteres |
| Cotizaciones sin divisa o en un estado sin etapa | No se envían como Deal: Cord nunca manda un importe sin su divisa |
Relacionadas
- Qué se sincroniza
- Pipeline y etapas
- Problemas con HubSpot
- La factura sale sola cuando te pagan, una idea lista para usar que, con HubSpot conectado, deja la nota en el Deal