Conectar una integración

Conectar una integración vincula tu cuenta de un servicio externo, como Slack o GitHub, a tu app de Kliv, para que tu app pueda trabajar con él. Esto lo haces tú desde la configuración de Kliv; una vez conectada, Kliv mantiene las credenciales seguras y tu app puede empezar a usarla.

Esta página recorre el flujo de conexión y qué almacena Kliv por ti.

El flujo de conexión

  1. Ve a Settings → Integrations.
  2. Elige la integración que quieres desde el catálogo.
  3. Elige Connect (Conectar). Lo que ocurre después depende del servicio:
    • Iniciar sesión en el servicio. La mayoría de las integraciones (Slack, Notion, HubSpot y otras) te envían a ese servicio para iniciar sesión y aprobar el acceso, y luego te devuelven a Kliv. Estás aprobando que Kliv actúe en tu nombre; no copias ninguna clave por tu cuenta.
    • Instalar una app. Algunas, como GitHub, te piden instalar la app de Kliv en tu cuenta u organización y elegir a qué puede acceder.
    • Pegar una clave. Algunos servicios se conectan pegando una clave de acceso desde la configuración de ese servicio. Kliv la almacena por ti en la bóveda.
  4. Cuando vuelves a Kliv, la integración aparece como conectada y lista para usar.

Puedes conectar más de una cuenta para el mismo servicio, por ejemplo dos espacios de trabajo de Slack, y elegir cuál usa una parte específica de tu app.

Qué almacena Kliv por ti

Cuando conectas, Kliv guarda las credenciales de ese servicio en una bóveda segura. Algunas cosas que debes saber:

  • Las credenciales viven en la bóveda de Kliv, nunca en el código de tu app. Los visitantes de tu app no pueden verlas, y nunca tienes que administrar tokens tú mismo.
  • Kliv proporciona la credencial en segundo plano. Cuando tu app hace una llamada, Kliv adjunta la credencial correcta del lado del servidor. El código de tu app solo describe qué hacer, nunca cómo autenticarse.
  • Algunas conexiones se actualizan automáticamente. Para servicios donde el acceso expira, Kliv lo renueva por ti. Si un servicio revoca alguna vez el acceso, por ejemplo porque quitaste la app de Kliv de su lado, la integración te pedirá reconectar.

Administrar o desconectar

Desde la misma área de Integrations puedes revisar una integración conectada, definir quién tiene permiso para usarla, configurar disparadores de eventos o desconectarla. Desconectar elimina las credenciales almacenadas y detiene el uso de ese servicio por parte de tu app.

Si algo sale mal

  • "Not connected" (No conectada): la integración aún no se conectó o se eliminó su acceso. Conéctala (o reconéctala) desde Settings → Integrations.
  • "Reconnect required" (Requiere reconexión): el servicio externo revocó el acceso de Kliv. Abre la integración y conéctala otra vez.
  • Más de una conexión: si tu app tiene varias cuentas conectadas para el mismo servicio, quizás debas indicarle cuál usar; la página de cada conexión muestra un selector de conexión, una etiqueta corta que tu app usa para elegir entre ellas.

Relacionado