# Como configurar a integração entre Zeev e DocuSign

{% hint style="info" %}
:unlock: Esse recurso é disponível como um complemento opcional, contratado à parte, ao Zeev. Consulte <https://help.zeev.it/items/docusign> para mais detalhes.
{% endhint %}

## 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 ](https://help.zeev.it/items/docusign)na DocuSign em um dos planos que suporta integrações via API;
* Plano Zeev Enterprise;
* Licença de [add-on](https://help.zeev.it/items/docusign) de integração;

## Como criar a integração no ambiente de desenvolvimento DocuSign

Utilizando uma [conta de desenvolvedor](https://developers.docusign.com/platform/account/) 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.&#x20;

![](/files/rXAo4RFfEdcx9PpENfZ4)

Logo em seguida, nas configurações desse aplicativo criado:

1. Copie e cole em um bloco de texto o conteúdo do campo "*integration key*" ;
2. Adicione uma nova "*secret key*" e copie/cole em um bloco de texto.
3. Informe a URL de redirecionamento da Zeev, que a DocuSign irá utilizar após autenticação das chaves: <https://signaturehub.zeev.it/authorization/>
4. Clique em "Salvar".

![](/files/asqOMmGG3tZ2VnDpTCpo)

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.

<figure><img src="/files/AePLfXFim0i6K8KlgTtl" alt=""><figcaption></figcaption></figure>

Clique em autorizar e aguarde o Zeev apresentar as mensagens em sequência:

1. &#x20;"Aguardando autorização" :repeat:
2. "Autorizado" :white\_check\_mark:

## 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:

1. Habilite a assinatura via DocuSign em um aplicativo de teste no Zeev;
2. Realize assinatura de documentos fictícios.

<figure><img src="/files/bQMPHUaB5IsXDKGhX9Tu" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Para saber mais sobre como habilitar a assinatura de Documentos via DocuSign em tarefas, [consulte esta página.](/zeev/assinatura-digital-e-eletronica/como-assinar-documentos-via-docusign/como-habilitar-a-assinatura-via-docusign-em-tarefas-humanas.md)
{% endhint %}

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:

1. Clique em "Actions" e "Start Go-live review" para iniciar a análise dos seus testes por parte da DocuSign;
2. Selecione a data em que os testes foram feitos;
3. Clique em "Submit for Review".&#x20;
4. Aguarde 10 minutos;
5. Clique em "Actions" e "Refresh status" para atualizar o status da revisão.&#x20;

O status deve ser atualizado para "Review Passed", se os testes foram feitos com sucesso.&#x20;

## 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:&#x20;

1. Clique em "Actions" e "Select Go-live Account";
2. Aceite os termos e condições;
3. Realize login no ambiente de produção que deseja enviar a integração;
4. Selecione a conta, clicando em "Select".

<figure><img src="/files/AMMYLCXhSamOA42tmPIg" alt=""><figcaption></figcaption></figure>

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".&#x20;

Com isso, sua integração pode ser configurada no ambiente de produção:

1. Clique em "View in production" para ver sua integração no ambiente de produção,&#x20;
2. Clique em "Actions" e "Editar".

Repita o processo inicial de configuração da integração, agora no ambiente de produção;

1. Copie e cole em um bloco de texto o conteúdo do campo "*integration key*" ;
2. Adicione uma nova "*secret key*" e copie/cole em um bloco de texto.
3. Informe a URL de redirecionamento da Zeev, que a DocuSign irá utilizar após autenticação das chaves: <https://signaturehub.zeev.it/authorization/>
4. Clique em "Salvar".

<figure><img src="/files/mmN0tf0OlP54MpV8evru" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/cKvAAHyOtDliOamPKlXm" alt=""><figcaption></figcaption></figure>

Clique em autorizar e aguarde o Zeev apresentar as mensagens em sequência:

1. &#x20;"Aguardando autorização" :repeat:
2. "Autorizado" :white\_check\_mark:

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.

{% embed url="<https://youtu.be/4KfW19Ubkvw>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeev/assinatura-digital-e-eletronica/como-assinar-documentos-via-docusign/como-configurar-a-integracao-entre-zeev-e-docusign.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
