POP — Fluxo de Assinatura Digital (DocuSeal)¶
Área: Contratos Responsável: Automático (servidor) Tempo estimado: Automático Ferramentas: DocuSeal, ClickUp (automação webhook) Slash command relacionado: —
Quando executar¶
Automaticamente quando um contrato é enviado e assinado no DocuSeal.
Pré-requisitos¶
- DocuSeal self-hosted configurado e acessível
- Webhook configurado apontando para o servidor da Gita
- Servidor webhook rodando com módulo de contratos ativo
- Templates de contrato cadastrados no DocuSeal
Passo a passo¶
1. Envio do contrato (manual)¶
- Operações acessa DocuSeal e seleciona template
- Preenche dados do cliente e campos variáveis
- Define signatários (email do cliente + email da Gita)
- Envia para assinatura
2. Assinatura (cliente)¶
- Cliente recebe email com link para assinar
- Assina digitalmente no navegador (sem necessidade de app)
- Sistema registra IP, data/hora e dados do dispositivo
3. Webhook pós-assinatura (automático)¶
- DocuSeal dispara webhook para o servidor quando ambos assinam
- Servidor recebe payload com dados do contrato e PDF
- Servidor executa ações automáticas:
- Salva PDF assinado no Google Drive (
01 - Contrato) - Atualiza status do card no ClickUp para "Contrato assinado"
- Cria estrutura de pastas no Drive (se novo cliente)
- Cria grupo WhatsApp via Uazapi (se configurado)
4. Verificação¶
- Confirmar que PDF foi salvo no Drive
- Confirmar que ClickUp foi atualizado
- Verificar logs do servidor em caso de falha
Output esperado¶
- Contrato assinado digitalmente com validade jurídica
- PDF salvo automaticamente no Google Drive
- Card no ClickUp atualizado
- Fluxos de onboarding disparados automaticamente
Erros comuns¶
- Cliente não encontra o email (verificar spam, reenviar)
- Webhook falha silenciosamente (monitorar logs do servidor)
- Token OAuth2 do Google Drive expirado
- Servidor fora do ar no momento da assinatura (webhook se perde)
Este POP será detalhado em breve. Estrutura preliminar.