Ghosty
Conectores

Conectores

Cuentas externas a las que el agente accede en tu nombre — Google, Canva, Spotify, Odoo, GitHub — y cómo se conectan.

Actualizado 2026-09-16

Un conector es una cuenta externa que el agente puede usar en tu nombre. Se conecta una vez por persona y lo usan todos tus agentes.

Cómo funciona

  • Son de la cuenta, no del agente. La llave se guarda cifrada bajo (tu usuario, proveedor). Un agente no tiene conectores propios; tiene acceso a los tuyos cuando actúa por ti.
  • Actúa por quien invoca. En Teams, si @handle manda un correo desde un canal, lo manda con la cuenta de la persona que lo mencionó, no con una cuenta compartida. En un canal público (WhatsApp) los conectores personales no están disponibles.
  • Desconectar revoca. Quitar un conector borra la llave y revoca el permiso en el proveedor.

Dónde se conectan

  • Studio: Ajustes → Conectores. Aquí viven los OAuth de Google, Canva y Spotify, y los de credenciales como Odoo.
  • Teams: Ajustes → Integraciones del espacio, para lo que el agente usa dentro del espacio (GitHub, Calendly, Deník…).
  • App móvil: Ajustes → Integraciones con la misma lista, vía la .
ConectorTipoQué puede hacer el agente
GoogleOAuth2Gmail, Calendar y Drive: leer, buscar, crear eventos, enviar.
CanvaOAuth2Diseños y exportaciones.
SpotifyOAuth2Control de reproducción y listas.
OdooCredenciales (URL, usuario, llave API)Leer y crear registros del ERP.
GitHubOAuth2 (Teams)Issues, PRs y código de los repos del espacio.
CalendlyOAuth2 (Teams)Agenda y disponibilidad.
EasyBitsOAuth2Los servicios de la plataforma hermana (archivos, sandboxes).
Deník, Kommo, MailmaskEn camino.

Odoo y otros conectores por credenciales

Los que no son OAuth se dan de alta con sus credenciales (URL de la instancia, usuario, llave). La URL pasa por un guard de red: sólo hosts públicos, sin IPs privadas ni localhost, para que un conector no sirva para alcanzar tu red interna desde la máquina del agente.

API

Para clientes propios (la app móvil los usa):

RutaQué hace
GET /api/v2/me/connectorsCatálogo con conectado: true/false por conector.
POST /api/v2/me/connectors/:id/startDevuelve la url de autorización para abrir en el navegador.
DELETE /api/v2/me/connectors/:idDesconecta y revoca.

Requieren bearer OAuth2; ver .