Conectar a conta do ODSign
Conecte a conta ODSign do escritório com o botão Conectar com ODSign, veja o plano que o Orvya passa a seguir e reconecte, troque de conta ou desconecte quando precisar.
O Orvya envia documentos para assinatura pelo ODSign, a plataforma de assinatura eletrônica parceira. A integração usa a conta ODSign do próprio escritório: um administrador clica em Conectar com ODSign, entra na conta ODSign e autoriza o Orvya. A partir daí, toda a equipe envia e acompanha envelopes pelo item Assinaturas eletrônicas do menu lateral, e cada envio, assinatura, recusa ou conclusão aparece no Orvya na hora. Não há token para criar nem webhook para cadastrar.
Onde fica
- No menu lateral, Assinaturas eletrônicas (logo abaixo da Área de trabalho) › ícone de engrenagem Configurações do ODSign. Sem conta conectada, a página mostra "Conecte a conta ODSign do escritório" e o botão Conectar com ODSign.
- Ou Configurações › aba Integrações › ODSign.

Conectar
- Clique em Conectar com ODSign. Uma janela do ODSign abre sobre o Orvya, e o Orvya mostra "Conclua a conexão na janela do ODSign".
- Na janela, entre no ODSign com o e-mail e a senha, com o Google ou com o código por SMS.
- Confira a tela Conectar o Orvya: a conta e o usuário com que você entrou, o plano atual e o que o Orvya poderá fazer (Ver a conta e o plano, Ver os envelopes, Criar e enviar envelopes e Baixar os documentos). Se o usuário não for o certo, clique em Entrar com outra conta.
- Clique em Permitir. A janela fecha sozinha e o aviso confirma a conta e o plano, por exemplo "ODSign conectado: Frutuoso e Luconi Advogados (plano Corporate)".
- Os envelopes da conta são importados em segundo plano. Na lista do ODSign aparece o aviso Importando os envelopes da conta ODSign até a importação terminar.
Cancelar, na janela do ODSign, não conecta nada. No Orvya, o Cancelar do aviso de espera desiste da tentativa.
Ainda não tem conta no ODSign
Clique em Criar conta, logo abaixo do botão. A mesma janela abre o cadastro do ODSign. Depois do cadastro, a janela volta à tela de autorização: siga do passo 3.
O que aparece com a conta conectada
O cartão Conta ODSign mostra a Conta, Conectada como (o usuário do ODSign e o perfil dele), Conectada por (quem conectou no Orvya e quando) e a Última conferência, com a situação no canto.
O cartão Plano no ODSign mostra o plano da conta, o uso do mês (envelopes, envios por WhatsApp e envios por SMS) e as formas de envio e de autenticação, com o motivo das que estão fora do plano. O Orvya segue esse plano: no Configurar envelope, o uso do mês aparece acima dos documentos e as formas fora do plano aparecem como "(indisponível no plano ... do ODSign)". Para mudar de plano, clique em Mudar de plano no ODSign.
Situações da conexão
| Situação | O que aconteceu | O que fazer |
|---|---|---|
| Conectada | Envios, downloads e eventos funcionando | Nada |
| Reconexão necessária | O ODSign deixou de aceitar a autorização, ou a conexão era a antiga, por token da API | Um administrador clica em Conectar com ODSign, no aviso da lista ou nas configurações |
| Conta parada no ODSign | A conta está suspensa ou aguardando um plano no ODSign | Regularize a conta no ODSign. Envios e downloads voltam sozinhos |
| Desconectada pelo ODSign | Um administrador do ODSign desconectou o Orvya em Aplicativos conectados, ou quem autorizou deixou de ser administrador lá | Conecte de novo com Conectar com ODSign |
Enquanto a conexão está parada, os envelopes já espelhados, os vínculos com contatos e processos e as preferências continuam no Orvya.
Manter a conexão
- Atualizar dados: lê de novo no ODSign a conta, o plano e o uso do mês.
- Trocar de conta: abre a janela do ODSign pedindo o login de novo, para conectar outra conta ou outro usuário. Se a conta for outra, o Orvya pergunta antes de gravar, no aviso "A conta ODSign é outra": os envelopes antigos podem não abrir mais pela conta nova, mas continuam na lista do Orvya, com os vínculos.
- Sincronizar agora: no cartão Documentos assinados e sincronização, confere a lista com o ODSign na hora.
- Desconectar: desfaz a conexão no Orvya e no ODSign. Os envelopes já espelhados, os vínculos e as preferências continuam no Orvya.
No ODSign, a conexão aparece em Configurações › API, aba Aplicativos conectados. Um administrador da conta ODSign também pode desconectar o Orvya por lá.
O cartão Documentos assinados e sincronização guarda a opção de salvar o PDF assinado nos documentos do Orvya. Veja Salvar o documento assinado nos documentos do Orvya.
Quem usava o token da API
A conexão antiga, com o token ods_ colado no Orvya e o webhook cadastrado à mão, saiu do Orvya. O escritório que usava o token vê Reconexão necessária: um administrador clica em Conectar com ODSign uma vez, com a mesma conta ODSign, e tudo volta a funcionar, com os envelopes e os vínculos de antes. Depois, no ODSign, revogue o token antigo em Configurações › API, aba Tokens, e apague o webhook antigo do Orvya na aba Webhooks.
Se algo der errado
- O botão Conectar com ODSign está desabilitado, com "A conexão com o ODSign ainda não está disponível. Fale com o suporte do Orvya."
O aplicativo Orvya ainda não foi configurado na plataforma. Fale com o suporte.
- "Só um administrador pode conectar"
, na janela do ODSign. O seu perfil no ODSign é Remetente ou Visualizador. Peça a um administrador da conta ODSign para conectar, ou entre com outro usuário em Entrar com outra conta.
- "A conta está aguardando um plano"
, na janela do ODSign. Contrate um plano no ODSign pelo botão Ir para Plano e cobrança e conecte de novo.
- "A tentativa de conexão venceu. Comece de novo pelo botão Conectar com ODSign."
A janela ficou aberta por mais de 10 minutos. Clique de novo no botão.
- "A conexão começou em outra sessão do Orvya. Comece de novo pela tela do Orvya."
A janela voltou para outro navegador ou outra sessão. Comece pelo botão no mesmo navegador em que você está no Orvya.
- "A resposta não veio do ODSign. Por segurança, a conexão não foi feita."
O endereço de volta não foi emitido pelo ODSign. Comece de novo pelo botão.
- "ODSign desconectado no Orvya. O ODSign não respondeu: confira em Configurações › API › Aplicativos conectados, no ODSign."
O Orvya parou de usar a conta, mas não conseguiu avisar o ODSign. Desconecte o Orvya por lá também.
- "O ODSign recusou o acesso da integração. Um administrador do escritório precisa conectar de novo com o botão Conectar com ODSign."
A autorização foi desfeita no ODSign. Conecte de novo.
- "A integração com o ODSign está desativada para o seu escritório."
O módulo não está disponível no plano atual. Veja Limites do plano.
- "O ODSign limitou as requisições da conta por alguns instantes. Tente de novo em 30 s."
(o tempo varia) Aguarde o tempo indicado e repita.
- Sou usuário e vejo "Só administradores do escritório configuram a integração".
Peça a um administrador para conectar a conta.
Continue em Assinatura eletrônica (ODSign)
Ainda com dúvida?
Conte o que aconteceu e, se puder, o endereço da tela. A equipe responde por suporte@orvya.net.