Para integrar o Fin com sistemas externos (por exemplo, Stripe), você precisará configurar um token de autenticação no seu workspace do Fin e garantir que ele esteja corretamente configurado. Abaixo estão os passos detalhados 👇
Crie um token de autenticação no Fin
Navegue para Settings > Authentication.
Clique em New token.
Preencha os campos do token com os seguintes valores:
Insira um token title.
Insira uma descrição.
Selecione um tipo, por exemplo Text, HTTP request, user.
Na seção do valor do token, insira sua chave API. Esta é ou sua chave secreta de teste (por exemplo,
sk_test_...) ou sua chave de produção (por exemplo,sk_live_...).Defina o prefixo do token para Bearer.
Defina a chave para o cabeçalho da requisição como Authorization.
Depois de concluir esta etapa, você terá criado um token de autorização que segue este formato quando enviado nas requisições. Por exemplo:
Authorization: Bearer <your_stripe_api_key>
Configure o token no conector de dados
Navegue para Settings > Data connectors.
Selecione um conector de dados existente ou create a new one.
Localize a seção onde você pode selecionar um token de autenticação.
Escolha o token que você acabou de criar no Fin.
Salve ou confirme as configurações para concluir a integração.
A partir deste ponto, sua chave API estará vinculada com sucesso ao seu suporte Fin. Essa configuração garante comunicação segura e contínua entre sistemas externos e o Fin, permitindo acessar dados externos diretamente dentro dos workflows do Fin.
Suporte a múltiplos tokens
Você pode anexar múltiplos tokens a um único Data connector. Cada token anexado deve ser configurado com uma unique header key (por exemplo, Authorization, X-API-Key). Todos os tokens anexados serão enviados com a requisição.
Essa configuração permite disparar Data connectors usando esse token - seja através de Workflows ou Fin. O conector de dados continuará funcionando mesmo se o valor do token for atualizado, pois será atualizado em tempo real para garantir autenticação ininterrupta.
Para usar um JWT por usuário com um Data connector, crie um token de autenticação do tipo ‘User’ e forneça seu valor atual via auth_tokens (por exemplo, Intercom('setAuthTokens')), em vez de depender do Messenger intercom_user_jwt.
Crie um token de API no Fin (tokens OAuth)
Tokens de API podem ser criados por colegas individualmente para permitir que apps externos acessem dados do Fin pela API.
Vá para Settings > Personal > API tokens.
Clique em Create API token.
Insira um name para seu API token e clique em Create.
Você pode usar seu token OAuth para autenticar com a API do Fin, por exemplo:
GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>
Note:
Esses tokens funcionam da mesma forma que tokens criados por App Packages. O Fin cria um App Package privado para seu workspace automaticamente.
O botão Create API token na seção Personal é suportado apenas em workspaces Fin for Platforms (Standalone). No Intercom Suite, o acesso à API é gerenciado via conexões de integração de apps.