Assinatura eletrônica (DocuSign)
Envie propostas para assinatura eletrônica usando a sua própria conta DocuSign (modelo BYO).
A integração de Assinatura eletrônica usa a SUA conta DocuSign (modelo BYO, "traga a sua própria conta"). Os envelopes são criados e cobrados na sua conta DocuSign: não há custo, margem nem intermediação nossa. Nós só programamos os campos e o botão para enviar a proposta para assinatura.
A integração nasce inerte: nada acontece até você preencher os campos e ativar. O access token fica cifrado no CRM e nunca é exibido de volta.
Pré-requisitos
- Uma conta DocuSign (ambiente de teste/demo ou produção) com permissão para enviar envelopes.
- Acesso ao painel do DocuSign para ver Apps and Keys (Account ID e Base URI), gerar um access token OAuth e configurar o DocuSign Connect (Admin → Connect).
- No Sellio, ser administrador para salvar as credenciais e ativar a integração em Configurações → Integrações.
O que você precisa preencher
- Account ID (API Account ID): o identificador da sua conta DocuSign, encontrado em Configurações → Apps e chaves (Apps and Keys) no painel do DocuSign.
- Base URI da conta: o endereço base da sua conta: https://demo.docusign.net no ambiente de teste, ou algo como https://na3.docusign.net em produção (o subdomínio varia conforme a sua conta; ele aparece na mesma tela de Apps e chaves).
- Access token (OAuth): um token de acesso que você gera no DocuSign para autorizar as chamadas. Ele fica cifrado no CRM.
- Chave HMAC do Connect (obrigatória para receber webhooks): a chave secreta que o DocuSign usa para assinar cada webhook. Ative o HMAC em Admin → Connect e copie a chave gerada. Sem ela, os webhooks são recusados (o status da assinatura não avança sozinho).
Como configurar
- Abra Configurações → Integrações e localize o cartão "Assinatura eletrônica (DocuSign)".
- Cole o Account ID, o Base URI, o Access token e a Chave HMAC do Connect e clique em "Salvar credenciais".
- Copie a "URL do webhook (DocuSign Connect)" que aparece e, no DocuSign Admin → Connect, crie uma configuração personalizada apontando para essa URL, marcando os eventos de envelope (enviado, entregue, concluído, recusado, anulado).
- Na mesma configuração do Connect, ATIVE o HMAC (Include HMAC signature) e use a mesma chave que você colou no CRM: o DocuSign passa a assinar cada evento no header X-DocuSign-Signature-1 e o CRM verifica a assinatura.
- Volte ao CRM e clique em "Ativar".
Como enviar uma proposta para assinatura
- Abra uma oportunidade e vá até a seção de Propostas.
- Na versão desejada, clique em "Assinatura", informe o e-mail (e, opcionalmente, o nome) do signatário e confirme.
- O CRM cria um envelope no DocuSign com o documento da proposta e envia o e-mail de assinatura ao signatário.
- Conforme o signatário avança, o status aparece na lista "Assinaturas" da proposta (Enviado → Entregue → Assinado).
💡 Quando a assinatura é concluída e a solicitação está ligada a uma proposta, a proposta é marcada como aceita automaticamente. Se você tentar enviar sem ter configurado o DocuSign, o CRM avisa de forma clara: a funcionalidade fica inerte até as credenciais estarem no lugar.
Hoje a autenticação usa um access token que você cola (caminho mais simples). Uma evolução futura é o JWT grant (integration key + chave privada), que renova o token automaticamente sem colagem manual.
Como testar
- Use o ambiente de demo (Base URI https://demo.docusign.net) com um access token de teste.
- Em uma proposta, clique em "Assinatura", informe o seu próprio e-mail como signatário e confirme.
- Verifique que você recebeu o e-mail do DocuSign e que a lista "Assinaturas" da proposta mostra "Enviado".
- Assine o documento; confirme que o status avança (Entregue → Assinado) e que a proposta é marcada como aceita: sinal de que o DocuSign Connect chegou ao CRM.
Solução de problemas
- 401 ao enviar: o access token expirou (tokens OAuth do DocuSign têm validade curta) ou está errado. Gere um novo token e recole. O Account ID e o Base URI precisam ser os da MESMA conta.
- Erro de conta/URL: confirme o Base URI correto (demo.docusign.net no teste; naX.docusign.net em produção; o subdomínio aparece em Apps and Keys) e o API Account ID.
- O status não atualiza na proposta: o DocuSign Connect não está chegando OU a assinatura HMAC não bate. Em Admin → Connect, confirme a configuração apontando para a "URL do webhook (DocuSign Connect)", com os eventos de envelope e com o HMAC ativado usando a MESMA chave colada no CRM.
- Webhook recusado (assinatura inválida / sem chave HMAC): por segurança, o CRM só aceita webhooks assinados. Se a Chave HMAC do Connect não estiver preenchida no CRM, ou diferir da usada pelo DocuSign, os eventos são rejeitados. Alinhe a mesma chave dos dois lados e reative o HMAC no Connect.
- Não aparece o botão / nada acontece: a integração está inerte por falta de credenciais ou não foi ativada. Preencha os campos e clique em Ativar.
- 404 na URL do Connect: a integração foi desativada ou o token da URL mudou: reative e reconfigure a URL no DocuSign.