Para integrar Fin com sistemas externos (por exemplo, Stripe), você precisará configurar um token de autenticação no seu workspace Fin e garantir que ele esteja configurado corretamente. Abaixo estão os passos detalhados 👇
Crie um token de autenticação no Fin
Navegue até Configurações > Autenticação.
Clique em Novo token.
Preencha os campos do token com os seguintes valores:
Digite um título do token.
Digite uma descrição.
Selecione um tipo, por exemplo, Texto, requisição HTTP, usuário.
No valor do token, insira sua chave API. Esta pode ser sua chave secreta de teste (por exemplo,
sk_test_...) ou sua chave ativa (por exemplo,sk_live_...).Defina o prefixo do token como Bearer.
Defina a chave para o cabeçalho da requisição como Authorization.
Após completar esta etapa, você terá criado um token de autorização que segue este formato quando enviado em requisições. Por exemplo:
Authorization: Bearer <your_stripe_api_key>
Configure o token no conector de dados
Navegue até Configurações > Conectores de dados.
Selecione um conector de dados existente ou crie um novo.
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 completar a integração.
Neste ponto, sua chave API estará vinculada com sucesso ao seu suporte Fin. Esta configuração garante uma comunicação segura e contínua entre sistemas externos e Fin, permitindo que você acesse dados externos diretamente dentro dos seus workflows Fin.
Suporte a múltiplos tokens
Você pode anexar múltiplos tokens a um único conector de dados. Cada token anexado deve ser configurado com uma chave de cabeçalho única (por exemplo, Authorization, X-API-Key). Todos os tokens anexados serão enviados com a requisição.
Esta configuração permite que você acione conectores de dados 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 conector de dados, crie um token de autenticação ‘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 API no Fin (tokens OAuth)
Tokens API podem ser criados por membros individuais da equipe para permitir que apps externos acessem dados Fin via API.
Vá para Configurações > Pessoal > Tokens API.
Clique em Criar token API.
Digite um nome para seu token API e clique em Criar.
Você pode usar seu token OAuth para autenticar com a API Fin, por exemplo:
GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>
Nota: Esses tokens funcionam da mesma forma que tokens criados através de Pacotes de App. Fin cria automaticamente um Pacote de App privado para seu workspace.