Integración · CRM
Conectar Twenty CRM a Igniten
Conecte la instancia de Twenty de su empresa para que Igniten pueda contestar sobre personas, empresas, oportunidades, notas y tareas, y escribir en ellas cuando se lo pida. Como Twenty se instala en un servidor propio, acá hacen falta dos datos y no uno: la dirección de su instancia y una clave de API creada en ella.
Qué lee Igniten, y qué no
Lee
- Personas, empresas y oportunidades con su etapa y su monto
- Notas y tareas de esos registros
No lee
- Nada que el rol asignado a la clave no pueda ver en Twenty
- Los registros no se copian a un índice: se leen en el momento
Cómo se conecta
2 pasos · ≈ 3 min
-
Pegar la clave de API
Una única clave de workspace para toda la organización.
- En su Twenty: Settings → API & Webhooks → Create key.
- Asígnele un rol restringido (Settings → Members → Roles) y una fecha de vencimiento: la clave ve exactamente lo que ese rol vea.
- La dirección de su instancia es la que usa para entrar a Twenty, con https y sin barra final.
Salió bien si La consola del proveedor le muestra la clave una sola vez: si ya la copió, este paso está hecho.
-
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 |
|---|---|---|
Clave de API con rol restringido | Leer y escribir solamente lo que ese rol permita | Siempre |
Fecha de vencimiento de la clave | Que la clave caduque sola si alguien se olvida de rotarla | Siempre |
Dirección de su instancia | Saber a qué servidor preguntarle: Twenty no tiene una dirección única | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- El CRM figura conectado pero no responde nada
-
Por qué Falta la dirección de la instancia: con la clave sola no alcanza.
Qué hacer Cargue la dirección completa de su Twenty, con https, en el mismo formulario.
- Las búsquedas por texto encuentran menos de lo esperado
-
Por qué Esa versión de Twenty no expone la búsqueda global y se usa el camino alternativo, que busca objeto por objeto.
Qué hacer Funciona igual. Si quiere la búsqueda completa, actualice Twenty a una versión que la exponga.
- Una etapa de oportunidad que nombro no existe
-
Por qué Las etapas son propias de cada espacio de trabajo y las suyas son otras.
Qué hacer La respuesta enumera las etapas válidas de su instancia. Use una de esas o cree la que falte en Twenty.
Los límites, dichos
- Los montos viajan en la unidad de Twenty y se convierten al mostrarlos.
- Las etapas de oportunidad se leen de su instancia en cada consulta.
Preguntas frecuentes
¿Por qué me pide una dirección si HubSpot no la pide?
Porque Twenty se instala en un servidor de su empresa y cada instalación tiene su propia dirección. HubSpot es un servicio único y su dirección es siempre la misma, así que no hay nada que preguntar.
¿Igniten puede borrar registros de Twenty?
No. En Twenty el borrado por API es definitivo y no hay papelera, así que no expusimos ninguna acción de borrado. Lo que sí hace es crear y editar, siempre con confirmación.
¿Qué permisos le doy a la clave?
Los mínimos que le sirvan: la clave toma el rol que le asignes en Twenty, así que si le da un rol restringido, Igniten ve exactamente eso y nada más. Conviene además ponerle vencimiento.