Documentation Index
Fetch the complete documentation index at: https://docs.diga.io/llms.txt
Use this file to discover all available pages before exploring further.
¿Qué son las conexiones?
Una conexión es la credencial que permite a una pieza acceder a un servicio externo en tu nombre. Cuando añades una acción como Enviar correo (Gmail), Crear evento (Google Calendar) o Actualizar contacto (HubSpot) a un flujo, la pieza necesita autorización para actuar en ese servicio. Esa autorización se almacena como una conexión. Las conexiones tienen alcance de proyecto: una vez creadas, cualquier flujo del proyecto puede reutilizar la misma conexión.Las credenciales de las conexiones se cifran y almacenan en el motor de flujos. Diga nunca almacena tus claves de API, tokens de OAuth ni contraseñas.
Tipos de autenticación
Distintas piezas requieren distintos tipos de credenciales:| Tipo | Cómo funciona | Ejemplos |
|---|---|---|
| API Key | Pegas una clave secreta de los ajustes del servicio | Cal.com, Airtable, Notion |
| OAuth | Autorizas a Diga desde la pantalla de inicio de sesión del propio servicio | Gmail, Google Calendar, HubSpot, Slack |
| Autenticación básica | Usuario y contraseña | APIs personalizadas |
| Personalizada | Campos específicos del servicio | Varía |
Crear una conexión
Las conexiones se crean dentro del constructor de flujos al configurar una pieza que requiere autenticación.Añade una acción que requiera autenticación
Al añadir una acción de una pieza (por ejemplo, Gmail → Enviar correo), el panel de configuración mostrará un campo Conexión en la parte superior.
Haz clic en 'Crear conexión'
Si aún no existe ninguna conexión para esta pieza, haz clic en Crear conexión en el desplegable. Se abrirá un diálogo para configurar las credenciales.
Asigna un nombre
Dale a la conexión un nombre descriptivo para identificarla más adelante (por ejemplo, “Gmail - Cuenta de soporte” o “HubSpot - Producción”).
Autoriza el servicio
Según el tipo de autenticación:Para API Key, autenticación básica o personalizada: introduce las credenciales directamente en los campos proporcionados.Para OAuth: haz clic en el botón Conectar. Se abrirá una ventana emergente con la pantalla de autorización del servicio (por ejemplo, el selector de cuentas de Google). Inicia sesión y concede los permisos solicitados. Una vez que autorices, la ventana se cierra automáticamente y la conexión estará lista.
Cómo funciona OAuth
Cuando autorizas una conexión OAuth, el proceso es el siguiente:- Diga abre una ventana emergente con la pantalla de consentimiento del servicio (Google, Slack, HubSpot, etc.)
- Inicias sesión y apruebas los permisos solicitados
- El servicio redirige de vuelta con un código de autorización temporal
- La ventana se cierra y el motor de flujos intercambia ese código por un token de acceso y un token de refresco
- Los tokens se cifran y almacenan. No necesitas gestionarlos manualmente
Reutilizar conexiones
Después de crear una conexión, aparece en el desplegable Conexión de cualquier acción de la misma pieza. Puedes usar la misma conexión de Gmail en múltiples flujos sin volver a autorizar.Gestionar conexiones
Puedes ver y gestionar todas las conexiones de tu proyecto en Ajustes > Proyecto > Conexiones. Desde allí puedes:- Ver qué flujos usan cada conexión
- Filtrar por estado Activa o Inactiva
- Reconectar una conexión cuyas credenciales hayan expirado
- Renombrar conexiones
Siguientes pasos
Crear flujos
Aprende a construir flujos paso a paso.
Plantillas de flujos
Usa flujos pre-configurados como punto de partida.