> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/assinatura-digital-e-eletronica/como-assinar-documentos-via-docusign/como-configurar-a-integracao-entre-zeev-e-docusign.md).

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

{% 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;

![](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FVUE4ndndjyBgLehpX1fF%2FGravar_2022_07_13_13_50_43_609.gif?alt=media\&token=e04f03c0-ea68-4bcd-a0be-9ef210877f34)

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".

![](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FcODTuVl1C2BdrgANQoph%2FGravar_2022_07_13_18_27_03_392.gif?alt=media\&token=d7c018c1-8a8c-45b6-bf2b-75ad5d0f9de6)

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="https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FYZCQSClmvcs4tyeHlYoE%2Fkbdcsn.gif?alt=media&amp;token=61a1adaa-71e7-4ebd-b843-83ca97554ac8" 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="https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FcTJDT4UoWg6XUg9fHdSV%2Fkbdcsn1.gif?alt=media&amp;token=24cecab3-8664-4bed-8d91-ddd27a0949d4" 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="https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FM2qe9sYmWhqyvMr7fmrc%2Fkbdcsn2.gif?alt=media&amp;token=d03f6608-3c5f-4f0f-9ee0-d897a4bfdcf9" 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="https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FomvSIoOOM3WzsF4AGMxg%2FGravar_2022_07_13_18_27_03_392.gif?alt=media&amp;token=44d928b9-8a07-4c32-aab6-682eb0705d8a" 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="https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2FDyYeShXNXeS6Pjmg33gb%2Fkbdcsn3.gif?alt=media&amp;token=20e5bb2d-1a8a-475f-bb1f-f080e7bd1355" 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.