Conectar credenciales en n8n: Google, Slack, OAuth

Qué son las credenciales

En n8n, una credencial es un acceso guardado y cifrado a una app. La crea una vez y la reutiliza en todos los workflows. Las credenciales se guardan cifradas con la clave de cifrado de su instancia y, en los planes de pago, se pueden compartir con compañeros sin revelar el secreto.

Hay tres tipos habituales:

• Clave de API / token: pegue una clave de la configuración de la app (OpenAI, personal access token de Airtable, clave secreta de Stripe).
• OAuth2: hace clic en «Iniciar sesión con…» y aprueba el acceso (Google, Slack, Microsoft, HubSpot).
• Basic auth / header auth: para webhooks y API sencillas.

Antes de empezar: la URL de redirección de OAuth

Cada credencial OAuth2 de n8n muestra una OAuth Redirect URL, como https://n8n.yourcompany.com/rest/oauth2-credential/callback. Debe pegarla en la consola de desarrolladores de la app. Tiene que coincidir exactamente, incluido https.

En n8n Cloud, muchas apps (Google, Slack, Microsoft) ofrecen un botón Sign in de un clic sin configuración de desarrollador. En n8n autoalojado, normalmente crea antes su propia app OAuth.

Google (Sheets, Gmail, Drive, Calendar)

En n8n autoalojado:

1. Abra Google Cloud Console y cree un proyecto.
2. Vaya a APIs & Services → Library y active las API que necesite, como Google Sheets API, Gmail API y Google Drive API.
3. Configure la OAuth consent screen. Elija Internal si usa Google Workspace y solo se conectará su organización; si no, External, y añádase como usuario de prueba.
4. Vaya a Credentials → Create credentials → OAuth client ID, tipo Web application.
5. Pegue la URL de redirección OAuth de n8n en Authorized redirect URIs.
6. Copie el Client ID y el Client Secret en la credencial de n8n (Google OAuth2 API o la específica de la app) y haga clic en Sign in with Google.

Consejo: una app External en estado «Testing» emite tokens que caducan a los 7 días. Publique la app (o use Internal) para workflows que funcionen de forma continua.

Slack

1. Vaya a api.slack.com/apps y haga clic en Create New App → From scratch.
2. En OAuth & Permissions, añada la URL de redirección de n8n.
3. Añada los scopes que necesite. Para publicar mensajes: chat:write; para leer canales: channels:read, channels:history.
4. Copie el Client ID y el Client Secret en la credencial Slack OAuth2 de n8n y conéctela.
5. Invite a la app a cada canal en el que deba publicar (/invite @YourApp).

Para un solo espacio de trabajo, un token de bot (empieza por xoxb-) con la credencial Slack API es más sencillo que OAuth.

Microsoft (Outlook, Teams, OneDrive)

1. En el portal de Azure, abra App registrations → New registration.
2. Añada la URL de redirección de n8n como redirect URI de tipo Web.
3. En Certificates & secrets, cree un client secret.
4. En API permissions, añada permisos delegados de Microsoft Graph como Mail.ReadWrite, Mail.Send y offline_access.
5. Pegue el Application (client) ID y el secret en la credencial Microsoft OAuth2 de n8n.

OAuth2 genérico para cualquier app

Si n8n no tiene una credencial específica, use OAuth2 API con el nodo HTTP Request. Necesitará la URL de autorización, la URL del token de acceso, el client ID, el client secret y los scopes de la documentación para desarrolladores de la app.

Checklist de seguridad

• Dé a cada credencial solo los scopes mínimos que necesite.
• Use una cuenta de servicio o un usuario bot dedicado, no la cuenta de una persona, para los workflows críticos.
• Guarde N8N_ENCRYPTION_KEY en un lugar seguro; si la pierde, tendrá que volver a crear todas las credenciales.
• Renueve los secretos cuando alguien deje el equipo.

Por qué importa en una migración

Al dejar Zapier o Make, los workflows se pueden reconstruir a partir de las exportaciones, pero las credenciales no se pueden transferir. Volver a crearlas suele ser la parte más lenta de una migración, así que configúrelas primero. Consulte la guía de migración de Zapier a n8n.