Como configurar a integração entre Zeev e DocuSign
Configure a integração entre Zeev e DocuSign para solicitar assinaturas de documentos através do Zeev.
Visão geral
A configuração do integração entre Zeev e Docusign é um processo em duas principais etapas. A criação da integração no ambiente de Desenvolvedor da Docusign e o processo de Go-live para o Ambiente de produção.
Para a integração com a DocuSign funcionar corretamente, é necessário configurar um método de autenticação através de uma chave de integração e chave secreta. Esse método dispensa a necessidade de autenticação manual no site da DocuSign.
Requisitos
Para utilizar esse recurso, é necessário:
Possuir uma licença na DocuSign em um dos planos que suporta integrações via API;
Plano Zeev Enterprise;
Licença de add-on de integração;
Como criar a integração no ambiente de desenvolvimento DocuSign
Utilizando uma conta de desenvolvedor na plataforma da DocuSign, acesse a página "Apps and Keys" e clique no botão "Adicionar um novo aplicativo e chave". Informe um nome para o seu aplicativo, que será utilizado para você identificá-lo depois.
Logo em seguida, nas configurações desse aplicativo criado:
Copie e cole em um bloco de texto o conteúdo do campo "integration key" ;
Adicione uma nova "secret key" e copie/cole em um bloco de texto.
Informe a URL de redirecionamento da Zeev, que a DocuSign irá utilizar após autenticação das chaves: https://signaturehub.zeev.it/authorization/
Clique em "Salvar".
Agora, no Zeev, sendo um usuário Superadministrador, acesse o menu "Configurar" e cole cada chave em seu respectivo campo em "DocuSign Demo".
Integration key = Chave de integração;
Secret key = Chave secreta.
Clique em autorizar e aguarde o Zeev apresentar as mensagens em sequência:
"Aguardando autorização" 🔁
"Autorizado" ✅
Como realizar os testes obrigatórios da Integração
Após ser realizada a configuração da integração no Zeev em "DocuSign Demo", a DocuSign exige que sejam realizados um número mínimo de testes para utilizar a integração no ambiente de produção.
Para realizar os testes necessários:
Habilite a assinatura via DocuSign em um aplicativo de teste no Zeev;
Realize assinatura de documentos fictícios.
Realize os testes assinando documentos e acompanhe na página da DocuSign o status do aplicativo. Quando o número de "Requisições com sucesso" for superior a 20, você pode solicitar a análise da sua integração:
Clique em "Actions" e "Start Go-live review" para iniciar a análise dos seus testes por parte da DocuSign;
Selecione a data em que os testes foram feitos;
Clique em "Submit for Review".
Aguarde 10 minutos;
Clique em "Actions" e "Refresh status" para atualizar o status da revisão.
O status deve ser atualizado para "Review Passed", se os testes foram feitos com sucesso.
Como publicar a integração no ambiente de produção
Após a validação dos testes, você pode realizar o envio da sua integração para o ambiente de produção. Para isso:
Clique em "Actions" e "Select Go-live Account";
Aceite os termos e condições;
Realize login no ambiente de produção que deseja enviar a integração;
Selecione a conta, clicando em "Select".
A partir deste momento a sua integração terá o status alterado para "Pending approval" e pode levar até 48 horas para ser analisada pela equipe da DocuSign. Quando o processo de revisão finalizar, o seu aplicativo terá o status alterado para "App is live".
Com isso, sua integração pode ser configurada no ambiente de produção:
Clique em "View in production" para ver sua integração no ambiente de produção,
Clique em "Actions" e "Editar".
Repita o processo inicial de configuração da integração, agora no ambiente de produção;
Copie e cole em um bloco de texto o conteúdo do campo "integration key" ;
Adicione uma nova "secret key" e copie/cole em um bloco de texto.
Informe a URL de redirecionamento da Zeev, que a DocuSign irá utilizar após autenticação das chaves: https://signaturehub.zeev.it/authorization/
Clique em "Salvar".
Agora, no Zeev, sendo um usuário Superadministrador, acesse o menu "Configurar" e cole cada chave em seu respectivo campo em "DocuSign".
Integration key = Chave de integração;
Secret key = Chave secreta.
Clique em autorizar e aguarde o Zeev apresentar as mensagens em sequência:
"Aguardando autorização" 🔁
"Autorizado" ✅
Com isso, seu Zeev estará configurado para utilizar o HubSignature DocuSign para realizar assinatura de documentos.
Demonstração prática
Confira no vídeo a seguir a demonstração de como integrar o Zeev com a DocuSign.
Atualizado