Base de conocimiento
Conectores
Conecta las aplicaciones con las que trabajas para que el asistente pueda consultarlas y actuar en ellas.
Detalles
- Un conector enlaza una aplicación externa con el asistente, para que pueda consultar datos en ella y actuar allí. Se pueden conectar Slack, Notion, Google Drive, HubSpot y unas mil más. «Busca la propuesta en Drive y dime qué dice sobre los precios.» «Publica esta novedad en el canal de ventas.» Los conectores están en Conectores, en la barra lateral.
- Para conectar una aplicación, elígela en la lista, elige para quién es y qué puede hacer el asistente, y termina en la página de inicio de sesión de la propia aplicación, o pega allí una clave de la aplicación. La contraseña o la clave nunca pasa por el chat de OpenEmail, por su API ni por el asistente. El conector queda pendiente hasta que termines, y activo después.
- Un conector es solo para ti o para todo el espacio de trabajo, y el asistente puede solo consultar a través de él o también hacer cambios. Puedes cambiarlo más adelante, y pausar un conector y reanudarlo. Al desconectar, el acceso también se retira en la aplicación externa. Si la aplicación deja de aceptar la conexión, el conector pide que lo vuelvas a conectar, y un enlace nuevo lo recupera como el mismo conector.
- En un chat, el asistente ve lo que está conectado, encuentra la acción adecuada en la aplicación y lee de inmediato. Para todo lo que cambia algo en la aplicación, como enviar un mensaje, crear o actualizar un registro o eliminar, muestra antes una tarjeta para que la apruebes, incluso cuando se lo pediste directamente. Un conector que solo consulta rechaza los cambios, y lo que devuelve una aplicación se trata como información, nunca como instrucciones.
- Una tarea solo usa conectores cuando Conectores está activado en sus Herramientas extra, y solo los conectados para el espacio de trabajo, nunca uno que pertenece a una sola persona. Lee por su cuenta. Cada cambio en una aplicación espera en Pendientes de ti, al margen de lo que la tarea pueda hacer por su cuenta en lo demás, y una tarea que usa conectores nunca responde al correo por su cuenta: cada respuesta espera tu aprobación.
- Cada llamada hecha a través de un conector queda registrada durante 90 días: cuándo, qué aplicación y qué acción, si leyó o cambió algo, si funcionó, y si vino de un chat, una tarea, la API o un agente. OpenEmail nunca guarda lo que se envió a la aplicación ni lo que esta devolvió.
- Tres permisos deciden quién hace qué: uno para ver los conectores y lo que se hizo a través de ellos, uno para hacer que el asistente los use, y uno para conectar, pausar y desconectar aplicaciones y definir lo que el asistente puede hacer. Los propietarios y los administradores tienen los tres, Member tiene los dos primeros y Viewer el primero. Quien puede conectar una aplicación puede conectarla para sí mismo o para el espacio de trabajo.
- Un plan admite 2 conectores en Free, 10 en Starter y 50 en Business para una cuenta, y otros tantos para un espacio de trabajo. Enterprise no fija un límite propio, y nada admite más de 200. Cuando un espacio de trabajo pasa a un plan menor, los conectores más recientes que superan el límite se pausan, no se eliminan.
- Las conexiones las mantiene un proveedor externo, que además guarda un registro de lo que el asistente envía a una aplicación y de lo que la aplicación responde, hasta un año. La página Política de privacidad lo nombra.
- Los conectores están en la API REST bajo /connectors, /connector-apps, /connector-categories y /connector-calls, en cada SDK como connectors, en la línea de comandos como openemail connectors y en el servidor MCP. Por la API un cambio se ejecuta de inmediato sin preguntar a nadie, así que decide quien llama. Tres eventos de webhook avisan a tus sistemas cuando un conector del espacio de trabajo se conecta, se desconecta o hay que volver a conectarlo.
Conectar una aplicación
Conectar lleva un minuto, y el inicio de sesión se hace en la página de la propia aplicación.
- Abre Conectores en la barra lateral y busca la aplicación en Explorar, por su nombre o por una categoría.
- Elige para quién es el conector: solo para ti o para todo el espacio de trabajo.
- Elige qué puede hacer el asistente a través de él: solo consultar, o también hacer cambios.
- Termina en la página de inicio de sesión de la aplicación, o pega allí una clave de la aplicación. El conector queda pendiente hasta que termines, y activo después.
- Tu contraseña o tu clave de la aplicación nunca pasa por el chat de OpenEmail, por su API ni por el asistente.
- Cuando una aplicación deja de aceptar la conexión, el conector indica que hay que volver a conectarlo. Un enlace nuevo lo recupera como el mismo conector, así que las tareas que lo usan siguen funcionando.
- Pausa un conector para que el asistente deje de usarlo, y reanúdalo cuando quieras recuperarlo.
- Desconectar elimina el conector y también retira el acceso que tenía en la aplicación externa.
- Los conectores se pueden desactivar para todo el servicio. En ese caso la página se oculta.
Quién puede hacer qué
| Permiso | Qué permite |
|---|---|
| connectors:read | Ver los conectores y lo que se hizo a través de ellos |
| connectors:use | Hacer que el asistente consulte y haga cambios a través de ellos |
| connectors:write | Conectar, pausar y desconectar aplicaciones, y definir lo que el asistente puede hacer en ellas |
- Los propietarios y los administradores tienen los tres. El rol integrado Member tiene
connectors:readyconnectors:use, y Viewer tieneconnectors:read. - El mismo permiso cubre los dos tipos de conector: quien puede conectar una aplicación puede conectarla para sí mismo o para el espacio de trabajo.
Desde código, la terminal y agentes
Los conectores están en la API REST bajo /connectors, /connector-apps, /connector-categories y /connector-calls, en cada SDK y en la CLI bajo connectors, y en las herramientas MCP, que el asistente también usa.