Integração com DocuSign

Neste capítulo, falaremos sobre como configurar a integração com a empresa DocuSign para permitir a assinatura digital de termos de acordo com validade jurídica.

DocuSign

DocuSign, Inc. é uma empresa americana com sede em San Francisco, Califórnia, que permite que as organizações gerenciem contratos eletrônicos. Como parte do DocuSign Agreement Cloud, a DocuSign oferece eSignature, uma forma de assinar eletronicamente em diferentes dispositivos.

É possível contratar um plano de assinaturas digitais por meio do site da empresa: https://www.docusign.com. O plano escolhido deverá ser um plano de API, para permitir a integração com sistemas de terceiros, que é o caso do Recuperador CRM. No momento da escrita dessa documentação, o site https://www.docusign.com/products-and-pricing/api-plans apresenta planos de API compatíveis com o Recuperador CRM.

Dica: pode-se criar uma conta de desenvolvedor grátis no DocuSign para configurar a integração, fazer os testes em ambiente de homologação e depois contratar um plano real para entrar em produção.

Configuração inicial

Para utilizar o módulo de integração com DocuSign, deve-se ativar o parâmetro HABILITA INTEGRAÇÃO COM DOCUSIGN no perfil do administrador. Para isso, acesse o menu User > Perfil > aba DocuSign, modifique o campo HABILITA INTEGRAÇÃO COM DOCUSIGN para Sim e clique em Salvar.

Após isso, acesse sua área no DocuSign, entre em Settings > Apps and Keys e obtenha os dados para completar os demais campos da integração. É necessário iniciar em ambiente de Homologação, fazer pelo menos 15 assinaturas de teste para depois migrar para o ambiente de produção. Não esqueça de clicar em Salvar após o término do preenchimento.

Tela de configuração da integração com DocuSign no perfil do administrador

Dica: homologação significa testes. Ou seja, todas as assinaturas colhidas em homologação não possuem validade jurídica e servem apenas para configurar a integração e avaliar o produto.

Habilitando o acesso em ambiente de homologação

Após preencher os campos da integração com DocuSign em ambiente de homologação e salvar, é necessário acessar o link abaixo para autorizar a autenticação da conta:

https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id=INFORMAR_AQUI_O_INTEGRATION_KEY&state=a39fh23hnf23&redirect_uri=http://localhost:8080/ds/callback

Note que no link há um código escrito INFORMAR_AQUI_O_INTEGRATION_KEY. Substitua esse código pelo Integration Key da sua conta do DocuSign antes de acessar o link. Ao acessar o link, o sistema do DocuSign pedirá uma confirmação e solicitará seu login e senha para autorizar o acesso à API.

Chave RSA

Além da segurança pela autenticação, o Docusign também exige uma chave RSA. Dentro da área do desenvolvedor no site do DocuSign, clique em Settings > Apps and Keys > Edit em frente ao aplicativo criado. Clique em Upload RSA e informe a chave RSA a ser obtida com o suporte do Recuperdor CRM por meio do e-mail contato@recuperador.com.br.