Pedir ao cliente que conecte o banco
Quando o cliente não está com você, ele mesmo conecta o banco pelo canal que usa. A conexão cai na estrutura dele e aparece no seu Hub, como se tivesse sido feita no Estúdio. Você orienta o cliente e acompanha o resultado pelo Hub.
No Estúdio não há botão para gerar um link e enviar ao cliente. O link sai do canal do próprio cliente.
O que precisa existir
- O Histórico do Open Finance ajustado antes da conexão, se você quer mais de 3 meses de lançamentos.
- A pessoa com conta de acesso ativa na Rica. Se ainda não tiver, abra a pessoa em Estúdio → Estrutura → Pessoas e use Ativar conta. Veja acesso, plano e WhatsApp da pessoa.
- Para pedir pelo WhatsApp, o número da pessoa cadastrado com o país certo.
- Um projeto da pessoa que vai conectar. A conversa oferece só os projetos dela.
Onde o cliente inicia a conexão
| Canal | Como o cliente começa |
|---|---|
| iPhone | Finanças → Integrações → Open Finance e o botão de adicionar. |
| Web | Home → Rica, na conversa. Ele escreve: “Quero conectar meu banco pelo Open Finance”. |
| O mesmo pedido na conversa com a Rica, pelo número cadastrado. | |
| Claude ou ChatGPT via MCP | Com a Rica conectada, ele pede o link de conexão e escolhe o projeto. |
Envie ao cliente o tutorial da base dele: Conectar seu banco pelo Open Finance. Para quem usa o WhatsApp, há o passo a passo em Conectar Open Finance pelo WhatsApp.
Na conversa, a Rica pergunta “Onde você quer conectar essa conta?” e lista os projetos da pessoa que pediu. Com um único projeto, ela escolhe sozinha. Depois responde “Use este link para conectar sua conta. Ele é válido por 30 minutos:” seguido do link.
Como funciona o link
- Vale por 30 minutos.
- Serve para uma única conexão. Para o segundo banco, o cliente pede outro link.
- Leva a uma página da Rica que abre o ambiente seguro do banco. Ali o cliente escolhe a instituição e autoriza.
- No app do iPhone, o titular conecta em qualquer projeto da estrutura. As outras pessoas da família, com acesso próprio, conectam só nos próprios projetos.
Ao terminar, a página mostra Conexão finalizada e “Sua conexão Open Finance foi concluída com sucesso. Você já pode fechar esta página.”
Exemplo
Rafael queria conectar o cartão Itaú, mas não estava na reunião. Ana pediu que ele escrevesse para a Rica no WhatsApp: “Quero conectar meu banco no projeto Casa”. Rafael recebeu o link, abriu no celular, escolheu Itaú e autorizou no app do banco. Ana recebeu no WhatsApp “Rafael Costa concluiu a conexão Open Finance com Itaú.” e conferiu o cartão em Hub → Cartões. Esse aviso só chega se você conversou com a Rica nas últimas 24 horas ou se Mensagens cobradas por WhatsApp estiver ligado nas Notificações do cliente. Sem ele, acompanhe pelo Hub.
Acompanhar pelo Hub
- Abra Estúdio → Hub → Open Finance.
- Clique em Conexões em processo para ver tentativas que ainda não terminaram. A pílula mostra a Última interação.
- Quando o cliente concluir, a conexão passa para Conexões realizadas.
- Clique na pílula e leia o resumo da conexão.
Se o cliente fechar a página antes do fim, a Rica ainda confirma a conexão quando o banco avisa a Pluggy. A conexão pode aparecer em realizadas alguns minutos depois.
Se o cliente tiver problema
| O que o cliente vê | Causa | O que orientar |
|---|---|---|
| “Este link Open Finance expirou. Solicite um novo link.” | Passaram os 30 minutos. | Pedir um link novo no mesmo canal. |
| Este link já foi utilizado | O link já conectou um banco. | Pedir outro link para a nova instituição. |
| Conexão já existente | A pessoa já tem uma conexão com esse banco. | Renovar a conexão existente. Veja iniciar a atualização da conexão. |
| “Link Open Finance inválido ou indisponível.” | O endereço aberto não corresponde a um link gerado pela Rica. | Abrir o link direto da mensagem ou pedir um novo. |
| “Seu cadastro ainda precisa concluir a ativação. Peça a quem cuida da sua estrutura para revisar o cadastro e ativar sua conta.” | A pessoa ainda não tem conta de acesso ativa. | Abra a pessoa em Estúdio → Estrutura → Pessoas e use Ativar conta. Veja acesso, plano e WhatsApp da pessoa. |
| “Não encontrei uma parte do planejamento disponível para conectar essa conta.” | A pessoa não tem projeto. | Criar um projeto em Estrutura → Projetos. |
| Não foi possível concluir | O banco recusou ou a autorização foi interrompida. | Tentar de novo. Se repetir, abra o histórico da tentativa e copie o diagnóstico para o suporte. |
O cliente nunca deve mandar senha ou código do banco pela conversa. Esses dados são digitados só no ambiente do banco.