Para abrir uma nova conta virtual (Baas) na Woovi, é preciso completar o KYC do cliente. Hoje você tem **duas formas** de fazer isso pela plataforma: * **KYC na plataforma** — o cliente preenche o KYC dentro do seu próprio painel da Woovi (em iframe). Útil quando você quer manter o cliente dentro do ambiente da sua empresa. * **Gerar link de integração** — você gera um link único e compartilha com o cliente (e-mail, WhatsApp, ticket de atendimento). O cliente abre o link em qualquer dispositivo e completa o KYC por conta própria. Os dois caminhos terminam no mesmo formulário de KYC e geram o mesmo `AccountRegister` no backend — a diferença é onde o cliente vai preencher. ## Onde fica o botão O botão **Nova Conta Baas** fica na página **Contas → Lista de contas**, no canto superior direito: ![Tela "Lista de contas" com o botão "Nova conta Baas" destacado em vermelho no canto superior direito](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2Q3IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--79ce55600be2785e1b0e879f3cb9acb38f1249e6/onboarding-link-button-location.png) ## Pré-requisitos: features necessárias Para o botão aparecer **e** abrir o fluxo de duas etapas (com escolha entre embed e link), sua empresa precisa ter estas features ativadas: | Feature | Para que serve |\ |---|---|\ | **`BAAS`** | Habilita o botão **Nova Conta Baas** na página de Contas. Sem essa feature, o botão não aparece. | **Não vê o botão ou só vê o fluxo antigo?** Fale com o seu gerente de contas Woovi, ou abra um ticket em [suporte@woovi.com](mailto:suporte@woovi.com) pedindo a ativação das features acima. ## Onde criar uma nova conta virtual 1. No menu lateral, acesse **Contas** → **Lista de contas** 2. Clique em **Nova Conta Baas** no canto superior direito 3. Um modal de duas etapas abre ## Etapa 1 — Informe o CNPJ ![Modal "Criar uma nova conta virtual" com campo de CNPJ vazio e botões Cancelar / Continuar](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa043IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d638b1ed0a3ac820440511ada2d969dd4934855f/onboarding-link-step1-cnpj.png) Informe o **CNPJ da empresa** que vai abrir a conta virtual. O botão **Continuar** só fica ativo depois de digitar um CNPJ válido. > 💡 O link gerado é **idempotente por CNPJ**: se você já criou um link para esse CNPJ antes, gerar de novo retorna o link existente — o cliente continua de onde parou. ## Etapa 2 — Escolha como o KYC vai ser feito ![Modal "Como você deseja iniciar o KYC?" com duas opções: KYC na plataforma (botão preenchido) e Gerar link de integração (botão contornado)](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa1I3IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fbe4b3b23f8a0627fb88b4e08fab19c93a696028/onboarding-link-step2-choice.png) Duas opções aparecem: | Opção | Quando usar |\ |---|---|\ | **KYC na plataforma** | Você quer que o cliente preencha o KYC sem sair da sua plataforma. Abre o KYC em iframe dentro do seu painel. |\ | **Gerar link de integração** | Você quer enviar o link por outro canal (e-mail, WhatsApp, ticket) para o cliente preencher quando puder. | ## Opção A — KYC na plataforma Ao clicar em **KYC na plataforma**, a plataforma redireciona automaticamente para a tela de embed, com o KYC já carregado dentro do seu painel: ![Tela de embed do KYC dentro do painel da Woovi: sidebar à esquerda, KYC iframe no centro mostrando o passo "Dados da Empresa"](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2w3IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f001d9bd3f0282bc10a9539d09ba85e467a2bc9a/onboarding-link-step3-embed-fullpage.png) O cliente preenche todas as etapas do KYC sem sair da sua plataforma. No topo direito, o botão **Abrir em nova aba** permite expandir a visualização — útil quando o cliente vai preencher o KYC ele mesmo, sem você ao lado. ## Opção B — Gerar link de integração Ao clicar em **Gerar link de integração**, o sistema cria/recupera o link e exibe na próxima etapa do modal: ![Modal "Link de integração gerado" mostrando a URL gerada, botão Copiar link e botão Concluído](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2g3IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7c680a6da9261b013bb1360d66504ca20eb1906a/onboarding-link-step3-link.png) Você pode: * **Copiar o link** com um clique no botão **Copiar link** * **Compartilhar** com o cliente pelo canal que preferir (e-mail, WhatsApp, sistema de tickets, intranet, etc.) * **Reutilizar**: o mesmo link pode ser enviado várias vezes — não expira a cada uso, e o cliente continua de onde parou se reabrir O formato da URL é: `https://app.woovi.com/kyc/onboarding/` (na produção; em ambientes de teste, o domínio pode variar). ## Como o cliente preenche o KYC Independente do fluxo escolhido, o cliente passa pelas mesmas 7 etapas: 1. **Início** — boas-vindas 2. **Dados da Empresa** — confirmar CNPJ e descrição do negócio 3. **Endereço** — endereço da empresa 4. **Contrato Social** — upload do contrato 5. **Sócios e Documentos** — dados, selfie, documentos, autenticação Pix e [verificação BC PROTEGE+](https://chat.woovi.io/hc/duvidas-frequentes/articles/271) de cada sócio 6. **Termos** — aceite dos termos 7. **Revisão** — confirmação final e envio ## Idempotência e reuso * O link é **idempotente por CNPJ**: gerar duas vezes para o mesmo CNPJ retorna o mesmo `AccountRegister`. Não cria duplicatas. * O link é **reutilizável**: pode ser aberto várias vezes pelo cliente (no mesmo dispositivo ou em outro). O progresso é salvo a cada etapa. * Cada acesso é registrado (data e contagem) — você pode acompanhar se o cliente já abriu o link. * O link **não expira** automaticamente. A conta só fecha após o KYC ser concluído e aprovado. ## Quando usar cada opção | Situação | Recomendado |\ |---|---|\ | Cliente está com você (presencial, ligação, vídeo) | KYC na plataforma |\ | Cliente vai preencher quando tiver tempo | Gerar link de integração |\ | Cliente está em outro dispositivo (celular) | Gerar link de integração |\ | Você quer monitorar o cliente preenchendo | KYC na plataforma |\ | Você gerencia muitos onboardings simultâneos | Gerar link de integração | ## Em caso de dúvidas Se o cliente reportar problemas para abrir o link, ou alguma etapa do KYC ficar travada (especialmente a verificação **BC PROTEGE+**), consulte: * [Quanto tempo esperar para refazer a verificação do BC PROTEGE+ no onboarding?](https://chat.woovi.io/hc/duvidas-frequentes/articles/271) * [Como ativar e desativar o BC PROTEGE+](https://chat.woovi.io/hc/duvidas-frequentes/articles/269-como-ativar-e-desativar-o-bc-protege) Para outros casos, escreva para [suporte@woovi.com](mailto:suporte@woovi.com).