Com o nosso fluxo App2App, você pode oferecer aos seus clientes uma experiência de aplicativo mais nativa usando o Hosted Widget da Belvo, melhorando a experiência do usuário e reduzindo a fricção. Nesta página, vamos guiá-lo pelo novo fluxo e fornecer diretrizes sobre como implementá-lo.
Com o fluxo App2App, a principal diferença para o usuário é que, após conceder seu consentimento para compartilhar dados:
- Eles são redirecionados para um navegador seguro para completar a solicitação.
- Eles são redirecionados diretamente para o seu aplicativo.
- O widget Belvo é aberto em uma webview dentro do seu aplicativo.
No fluxo usual, quando você implementa o Hosted Widget usando deep links, o usuário completa todo o processo de conexão no navegador e, em seguida, é solicitado a ser redirecionado para o seu aplicativo, o que leva a atritos e uma experiência de usuário subótima. Com este novo fluxo, o usuário é transferido de forma contínua através das diferentes redireções.
Para usar o fluxo App2App, você precisará fazer as seguintes alterações na sua implementação atual:
- Crie um link para o seu aplicativo.
- Use o link ao gerar o token de acesso.
- Abra o Webview Widget ao ser redirecionado para o seu aplicativo.
Antes de configurar a experiência do aplicativo nativo, você precisa preparar um link universal (iOS) ou um link de aplicativo (Android). Este link é usado para redirecionar seu usuário de volta ao seu aplicativo após ele ter concedido seu consentimento em sua instituição.
Ao usar um deep link para o seu aplicativo, os usuários recebem uma mensagem pop-up que precisam confirmar antes de serem redirecionados para o seu aplicativo, o que pode levar a uma experiência de usuário ruim e fricção. Ao usar o application_link
, os usuários são automaticamente redirecionados para o seu aplicativo sem precisar confirmar o redirecionamento.
Ao gerar seu access_token
, você precisa fornecer os seguintes parâmetros no objeto callback_urls
:
application_link
: O link para sua aplicação para o qual os usuários serão redirecionados após concederem consentimento em sua instituição.success
: A URL para a qual os usuários são redirecionados quando completam com sucesso o fluxo do widget.exit
: A URL para a qual os usuários são redirecionados quando saem do widget antes de completar o fluxo.event
: A URL para a qual os usuários são redirecionados quando ocorre um erro.
{
"callback_urls": {
"application_link": "https://your.company_name.br/belvo-widget",
"success": "https://your.company_name.br/success",
"exit": "https://your.company_name.br/exit",
"event": "https://your.company_name.br/error"
}
}
Para instruções completas sobre como gerar o access_token
, por favor veja nosso guia de Hosted Widget (OFDA) dedicado.
Assim que os usuários concedem consentimento em sua instituição, eles são redirecionados para sua aplicação usando o application_link
, junto com uma query string que você precisará usar para abrir o widget Belvo como um webview dentro de sua aplicação.
https://mobile.seu-nome-app.br/belvo-widget/ ## Seu application_link
?access_token={someAccessToken}&consent_id={someConsentId}&locale=pt... ## Query string com detalhes para abrir o widget Belvo
Assim que os usuários são redirecionados para sua aplicação, você precisa abrir um webview dentro de sua aplicação e lançar o widget da Belvo:
https://widget.belvo.io/ ## A URL do Belvo Hosted Widget
?access_token={someAccessToken}&consent_id={someConsentId}&locale=pt... ## A query string que você recebeu
✅ Feito! Com esses pequenos ajustes na sua implementação, os usuários irão se mover sem problemas da sua aplicação para o widget, conceder seu consentimento e, em seguida, retornar ao widget dentro da sua aplicação.