Assinatura eletrônica (Clicksign)
Envie propostas para assinatura eletrônica usando a sua própria conta Clicksign (modelo BYO).
A integração de Assinatura eletrônica com o Clicksign usa a SUA conta Clicksign (modelo BYO, "traga a sua própria conta"). Os documentos são criados e cobrados na sua conta Clicksign: 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 e o secret do webhook ficam cifrados no CRM e nunca são exibidos de volta.
Pré-requisitos
- Uma conta Clicksign (Sandbox para testes ou Produção) com permissão de API.
- Acesso ao painel do Clicksign para gerar o access token (Configurações → API) e criar um webhook com um secret HMAC.
- No Sellio, ser administrador para salvar as credenciais e ativar a integração em Configurações → Integrações.
O que você precisa preencher
- Ambiente: Sandbox (para testes, em sandbox.clicksign.com) ou Produção (para valer, em app.clicksign.com). Cada ambiente tem o seu próprio access token.
- Access token: o token de acesso da API, gerado no painel do Clicksign em Configurações → API. Ele autentica as chamadas (via ?access_token=). Fica cifrado no CRM.
- Secret do webhook (HMAC): um segredo que você define ao criar o webhook no Clicksign. Serve para verificar a assinatura HMAC-SHA256 dos eventos que o Clicksign nos envia. Fica cifrado no CRM.
Como configurar
- Abra Configurações → Integrações e localize o cartão "Assinatura eletrônica (Clicksign)".
- Escolha o ambiente, cole o Access token e o Secret do webhook, e clique em "Salvar credenciais".
- Copie a "URL do webhook (Clicksign)" que aparece e, no Clicksign → Configurações → API/Webhooks, crie um webhook apontando para essa URL usando exatamente o mesmo secret.
- 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.
- Se você tiver DocuSign e Clicksign ativos ao mesmo tempo, aparecem dois botões ("Enviar via DocuSign" e "Enviar via Clicksign"): escolha o Clicksign. Se só o Clicksign estiver ativo, um único botão já o usa.
- O CRM cria o documento no Clicksign, adiciona o signatário e solicita a assinatura; o Clicksign 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 o documento é assinado por completo (evento de fechamento do Clicksign) e a solicitação está ligada a uma proposta, a proposta é marcada como aceita automaticamente. Os webhooks são verificados por assinatura HMAC-SHA256 (header Content-Hmac): se o secret não bater, o evento é rejeitado. Se você tentar enviar sem ter configurado o Clicksign, o CRM avisa de forma clara: a funcionalidade fica inerte até as credenciais estarem no lugar.
Como testar
- Use o ambiente Sandbox com o access token de sandbox.
- Em uma proposta, clique em "Assinatura", informe o seu próprio e-mail como signatário e confirme.
- Confirme que você recebeu o e-mail do Clicksign e que a lista "Assinaturas" mostra "Enviado".
- Assine o documento e verifique que o status avança para "Assinado" e a proposta é marcada como aceita: sinal de que o webhook (com HMAC válido) chegou.
Solução de problemas
- 401 ao enviar: o access token está errado ou é de outro ambiente (token de sandbox usado em produção, ou vice-versa). Confirme o ambiente e recole o token daquele ambiente.
- O status não atualiza na proposta: o webhook não está chegando ou a assinatura falha. Confirme que o webhook no Clicksign aponta para a "URL do webhook (Clicksign)" e usa EXATAMENTE o mesmo secret salvo no CRM (header Content-Hmac, HMAC-SHA256).
- Evento rejeitado (assinatura inválida): o secret do webhook difere entre o Clicksign e o CRM. Salve o mesmo valor nos dois lados.
- Nada acontece ao enviar: a integração está inerte por falta de credenciais ou não foi ativada. Preencha ambiente + token + secret e clique em Ativar.