Para integrar Fin con sistemas externos (por ejemplo, Stripe), necesitarás configurar un token de autenticación en tu espacio de trabajo Fin y asegurarte de que esté correctamente configurado. A continuación, los pasos detallados 👇
Crear un token de autenticación en Fin
Navega a Configuración > Autenticación.
Haz clic en Nuevo token.
Completa los campos del token con los siguientes valores:
Introduce un título del token.
Introduce una descripción.
Selecciona un tipo, por ejemplo, Texto, solicitud HTTP, usuario.
En el valor del token, introduce tu clave API. Esta puede ser tu clave secreta de prueba (por ejemplo,
sk_test_...) o tu clave en vivo (por ejemplo,sk_live_...).Establece el prefijo del token a Bearer.
Establece la clave para el encabezado de la solicitud a Authorization.
Después de 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>
Configura el token en el conector de datos
Navega a Configuración > Conectores de datos.
Selecciona un conector de datos existente o crea uno nuevo.
Ubica 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 clave API estará vinculada exitosamente a tu soporte Fin. Esta configuración asegura una comunicación fluida y segura entre sistemas externos y Fin, permitiéndote acceder a datos externos directamente dentro de tus workflows de Fin.
Soporte multi-token
Puedes adjuntar múltiples tokens a un solo conector de datos. Cada token adjunto debe configurarse con una clave de encabezado única (por ejemplo, Authorization, X-API-Key). Todos los tokens adjuntos se enviarán con la solicitud.
Esta configuración te permite activar conectores de datos usando ese token, ya sea a través de Workflows o Fin. El conector de datos seguirá funcionando incluso si el valor del token se actualiza, ya que se refrescará en tiempo real para asegurar una autenticación ininterrumpida.
Para usar un JWT por usuario con un conector de datos, crea un token de autenticación ‘Usuario’ y proporciona su valor actual vía auth_tokens (por ejemplo, Intercom('setAuthTokens')), en lugar de depender del Messenger intercom_user_jwt.
Crear un token API en Fin (tokens OAuth)
Los tokens API pueden ser creados por miembros individuales para permitir que aplicaciones externas accedan a datos de Fin a través de la API.
Haz clic en Crear token API.
Introduce un nombre para tu token API y haz clic en Crear.
Puedes usar tu token OAuth 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 igual que los tokens creados a través de App Packages. Fin crea automáticamente un App Package privado para tu espacio de trabajo.