DocuSign
Enviar e acompanhar documentos para assinatura eletrônica pelo DocuSign.
O que faz
Crie e envie envelopes para assinatura eletrônica, use modelos, acompanhe o status das assinaturas, baixe documentos assinados e gerencie destinatários com o DocuSign.
Quando usar: Use quando o seu fluxo precisar enviar e acompanhar documentos para assinatura eletrônica pelo DocuSign.
Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione DocuSign ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Enviar envelope | Envia envelope com o bloco DocuSign. |
| Enviar a partir de modelo | Envia a partir de modelo com o bloco DocuSign. |
| Buscar envelope | Busca envelope com o bloco DocuSign. |
| Listar envelopes | Lista envelopes com o bloco DocuSign. |
| Anular envelope | Anula envelope com o bloco DocuSign. |
| Baixar documento | Baixa documento com o bloco DocuSign. |
| Listar modelos | Lista modelos com o bloco DocuSign. |
| Listar destinatários | Lista destinatários com o bloco DocuSign. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Enviar envelope · Enviar a partir de modelo · Buscar envelope · Listar envelopes · Anular envelope · Baixar documento · Listar modelos · Listar destinatários
- Padrão:
- Enviar envelope
Conta do DocuSign
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do DocuSign
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
Assunto do e-mail
Obrigatório conforme a operaçãoPor favor, assine este documento.
- Aparece em:
- Enviar envelope, Enviar a partir de modelo
- Exemplo:
- cliente@exemplo.com
Corpo do e-mail
Em campos adicionaisMensagem opcional a incluir no e-mail.
- Aparece em:
- Enviar envelope, Enviar a partir de modelo
- Exemplo:
- cliente@exemplo.com
E-mail do signatário
Obrigatório conforme a operaçãoInforma o destinatário ou endereço de e-mail usado pela operação.
- Aparece em:
- Enviar envelope
- Exemplo:
- cliente@exemplo.com
Nome do signatário
Obrigatório conforme a operaçãoJoão da Silva.
- Aparece em:
- Enviar envelope
- Exemplo:
- Exemplo de atendimento
Documento
Envie o documento para assinatura.
- Aparece em:
- Enviar envelope
- Exemplo:
- (selecione um arquivo de teste)
Documento
Em campos adicionaisReferencie um arquivo de outro bloco.
- Aparece em:
- Enviar envelope
E-mail em cópia (Cc)
Em campos adicionaisInforma o destinatário ou endereço de e-mail usado pela operação.
- Aparece em:
- Enviar envelope
- Exemplo:
- cliente@exemplo.com
Nome em cópia (Cc)
Em campos adicionaisNome do destinatário em cópia.
- Aparece em:
- Enviar envelope
- Exemplo:
- Exemplo de atendimento
Status
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Enviar envelope, Enviar a partir de modelo
- Opções:
- Enviar agora · Salvar como rascunho
- Padrão:
- Enviar agora
ID do modelo
Obrigatório conforme a operaçãoID do modelo do DocuSign.
- Aparece em:
- Enviar a partir de modelo
- Exemplo:
- id-do-recurso
Papéis do modelo
Obrigatório conforme a operaçãoLista em JSON que liga cada papel do modelo do DocuSign a uma pessoa: roleName igual ao nome do papel no modelo, mais o nome e o e-mail de quem vai assinar.
- Aparece em:
- Enviar a partir de modelo
- Exemplo:
- .com"}]
ID do envelope
Obrigatório conforme a operaçãoID do envelope do DocuSign.
- Aparece em:
- Buscar envelope, Anular envelope, Baixar documento, Listar destinatários
- Exemplo:
- id-do-recurso
Motivo da anulação
Obrigatório conforme a operaçãoMotivo para anular este envelope.
- Aparece em:
- Anular envelope
- Exemplo:
- Motivo para anular este envelope
ID do documento
Em campos adicionaisInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Baixar documento
- Exemplo:
- id-do-recurso
Data inicial
Em campos adicionaisData ISO 8601 (padrão: 30 dias atrás).
- Aparece em:
- Listar envelopes
- Exemplo:
- cliente@exemplo.com
Data final
Em campos adicionaisData ISO 8601.
- Aparece em:
- Listar envelopes
- Exemplo:
- 2026-09-15
Filtro de status
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar envelopes
- Opções:
- Todos · Criado · Enviado · Entregue · Concluído · Recusado · Anulado
- Exemplo:
- Todos
Texto da busca
Em campos adicionaisBusque envelopes ou modelos.
- Aparece em:
- Listar envelopes, Listar modelos
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Máximo de resultados
Em campos adicionaisDefine um valor numérico, quantidade ou limite da operação.
- Aparece em:
- Listar envelopes, Listar modelos
- Exemplo:
- 10
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <docusign.envelopeId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<docusign.envelopeId> | string | ID do envelope. |
<docusign.status> | string | Status do envelope (created, sent, delivered, completed, declined, voided). |
<docusign.statusDateTime> | string | Data e hora (ISO 8601) da mudança de status. |
<docusign.uri> | string | Caminho URI do envelope. |
<docusign.emailSubject> | string | Assunto do e-mail do envelope. |
<docusign.sentDateTime> | string | Data e hora (ISO 8601) do envio do envelope. |
<docusign.completedDateTime> | string | Data e hora (ISO 8601) da conclusão da assinatura. |
<docusign.createdDateTime> | string | Data e hora (ISO 8601) da criação do envelope. |
<docusign.statusChangedDateTime> | string | Data e hora (ISO 8601) da última mudança de status. |
<docusign.voidedReason> | string | Motivo da anulação do envelope. |
<docusign.signerCount> | number | Número de signatários do envelope. |
<docusign.documentCount> | number | Número de documentos no envelope. |
<docusign.envelopes> | json | Lista de envelopes (envelopeId, status, emailSubject, sentDateTime, completedDateTime, createdDateTime, statusChangedDateTime). |
<docusign.templates> | json | Lista de modelos (templateId, name, description, shared, created, lastModified). |
<docusign.signers> | json | Lista de signatários (recipientId, name, email, status, signedDateTime, deliveredDateTime). |
<docusign.carbonCopies> | json | Lista de destinatários em cópia (recipientId, name, email, status). |
<docusign.file> | file | Arquivo do documento baixado (armazenado). |
<docusign.base64Content> | string | Conteúdo do documento em Base64. |
<docusign.mimeType> | string | Tipo MIME do documento. |
<docusign.fileName> | string | Nome do arquivo do documento. |
<docusign.totalSetSize> | number | Total de resultados encontrados. |
<docusign.resultSetSize> | number | Resultados retornados nesta resposta. |
Exemplo de uso
Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.
- Operação
- Enviar envelope
- Conta do DocuSign
- (escolha a conta conectada)
- Assunto do e-mail
- cliente@exemplo.com
- E-mail do signatário
- cliente@exemplo.com
- Nome do signatário
- Exemplo de atendimento
- Documento
- (selecione um arquivo de teste)
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <docusign.envelopeId>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Acrescentar dados · Google SheetsAcrescentar dados usando a conexão Google Sheets deste workspace.
- Adicionar pergunta de múltipla escolha · Google FormsGerencie formulários e respostas do Google Forms.
- Adicionar pergunta de texto · Google FormsGerencie formulários e respostas do Google Forms.
- Aplicar estilo de parágrafo · Google DocsAplicar estilo de parágrafo usando a conexão Google Docs deste workspace.
- Aplicar estilo de texto · Google DocsAplicar estilo de texto usando a conexão Google Docs deste workspace.
- Atualizar arquivo · Google DriveAtualizar arquivo usando a conexão Google Drive deste workspace.