Para integrar Fin con sistemas externos (p. ej., Stripe), deberás configurar un token de autenticación en tu espacio de trabajo Fin y asegurarte de que esté correctamente configurado. A continuación se detallan los pasos 👇
Crear un token de autenticación en Fin
Navega a Settings > Authentication.
Haz clic en New token.
Rellena los campos del token con los siguientes valores:
Introduce un token title.
Introduce una descripción.
Selecciona un tipo, p. ej., Text, HTTP request, user.
En el valor del token introduce tu API key. Este es tu secret test key (p. ej.,
sk_test_...) o tu live key (p. ej.,sk_live_...).Establece el prefijo del token a Bearer.
Establece la clave para el encabezado de la solicitud en Authorization.
Tras completar este paso, habrás creado un token de autorización que sigue este formato cuando se envía en las solicitudes. Por ejemplo:
Authorization: Bearer <your_stripe_api_key>
Configurar el token en el conector de datos
Navega a Settings > Data connectors.
Selecciona un conector de datos existente o crea uno nuevo.
Localiza la sección donde puedes seleccionar un token de autenticación.
Elige el token que acabas de crear en Fin.
Guarda o confirma la configuración para completar la integración.
En este punto, tu API key estará vinculada correctamente a tu soporte de Fin. Esta configuración garantiza una comunicación segura y fluida entre sistemas externos y Fin, permitiéndote acceder a datos externos directamente dentro de tus workflows de Fin.
Soporte de múltiples tokens
Puedes adjuntar varios tokens a un solo Data connector. Cada token adjunto debe estar configurado con una clave de encabezado única (p. ej., Authorization, X-API-Key). Todos los tokens adjuntos se enviarán con la solicitud.
Esta configuración te permite activar Data connectors usando ese token, ya sea a través de Workflows o Fin. El conector de datos seguirá funcionando incluso si se actualiza el valor del token, ya que se actualizará en tiempo real para garantizar una autenticación ininterrumpida.
Para usar un JWT por usuario con un Data connector, crea un token de autenticación de tipo «User» y proporciona su valor actual mediante auth_tokens (p. ej., Intercom('setAuthTokens')), en lugar de depender del Messenger intercom_user_jwt.
Crear un token API en Fin (tokens OAuth)
Los API tokens pueden ser creados por compañeros individuales para permitir que aplicaciones externas accedan a los datos de Fin a través de la API.
Haz clic en Create API token.
Introduce un name para tu API token y haz clic en Create.
Puedes usar tu OAuth token para autenticarte con la API de Fin, por ejemplo:
GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>
Nota:
Estos tokens funcionan de la misma manera que los tokens creados a través de App Packages. Fin crea automáticamente un App Package privado para tu espacio de trabajo.
El botón Create API token en la sección Personal solo es compatible con workspaces Fin for Platforms (Standalone). En Intercom Suite, el acceso a la API se gestiona mediante conexiones de integración de aplicaciones.