O que acontece depois do envio

Quando o seu sistema cria um envelope com send=1, quem assina não precisa de conta, senha nem aplicativo: recebe um convite com um link pessoal e assina pelo navegador, no computador ou no celular. Este guia mostra, etapa por etapa, o que a pessoa vê, o que muda nos estados do envelope e quais eventos chegam ao seu sistema, para você desenhar a integração (e o atendimento) sem surpresas.

Visão geral

A qualquer momento antes de assinar, a pessoa pode recusar (estado declined, eventos recipient.declined e envelope.declined, e o envelope é encerrado para todos).

1. O convite

O convite sai pela forma de envio de cada destinatário (channel):

WhatsApp e SMS saem pelo número da plataforma e contam nas cotas mensais do plano (veja Cotas mensais de WhatsApp e SMS). Na API, o email é obrigatório para todos os destinatários, mesmo para quem recebe pelo celular.

Com signing_order=1, só a primeira ordem recebe o convite; a próxima recebe quando todos da ordem anterior concluírem (você recebe um recipient.sent para cada novo convite). Sem ordem, todos recebem ao mesmo tempo.

O link pessoal vale como a credencial da pessoa: não o compartilhe nem o grave em lugares públicos. Ele vale até o fim da validade do envelope e é trocado a cada reenvio e lembrete (o anterior deixa de funcionar). Se a pessoa disser que o link "não abre", reenvie o convite com POST /envelopes/{id}/resend.

2 e 3. Abertura e termo

Ao abrir o link, a pessoa vê quem enviou, o assunto e o Termo de uso de assinatura eletrônica: ao concordar, aceita receber e assinar o documento em formato eletrônico e é informada de quais dados ficam registrados (e-mail ou celular, IP, navegador, data e hora de cada ação e o hash do documento) e de como vai confirmar a assinatura. O aceite fica na trilha de auditoria.

Se o destinatário tiver código de acesso (definido no app) ou a opção antiga de código para abrir (whatsapp_auth, sms_auth), ele é pedido antes do documento.

4 e 5. Leitura e confirmação

A pessoa lê o documento na tela (todas as páginas, com zoom) e clica em Assinar. A confirmação depende da forma de autenticação (auth_method):

Escolha a forma conforme o risco do documento: link e signature para o dia a dia; os tokens quando você quer uma prova a mais de que a pessoa controla o e-mail ou o celular; document quando quer a imagem do documento de identidade junto da assinatura. Os tokens por SMS e WhatsApp e o documento pessoal dependem do plano e das cotas (veja Escolher a forma de autenticação).

Sem auth_method, o destinatário assina pelos campos posicionados no documento (fields), adotando uma assinatura (estilo, desenho ou imagem). Nesse caso, cada signatário precisa de ao menos um campo signature.

Quem é viewer só precisa abrir e concluir; quem é cc não age: recebe uma cópia na conclusão.

6. Conclusão

Quando todos que precisam agir concluem, o ODSign gera o documento assinado: os documentos com a trilha de assinaturas no fim (quem assinou, como foi autenticado, IP, data e hora e o log completo do envelope). O hash SHA-256 desse arquivo vai para final_sha256, e o documento recebe o selo eletrônico ICP-Brasil da plataforma quando ele está ativo. Em seguida, em segundo plano, vem o carimbo do tempo (RFC 3161).

• Todos os participantes recebem o aviso de conclusão com o link para baixar o documento assinado (quem recebeu só pelo celular recebe o aviso por WhatsApp ou SMS).
• O seu sistema recebe envelope.completed e pode baixar o documento assinado (signed), o original (original) ou a trilha completa em ZIP (package, com as provas).
• Qualquer pessoa pode conferir a autenticidade do documento pela verificação pública (veja Verificação pública por código).

Recusa, anulação e expiração

Lembretes automáticos e o aviso de "expira em breve" seguem os padrões da conta, não geram eventos e trocam o link pessoal de quem ainda não assinou.

Dicas para a sua integração

• Mostre no seu sistema o estado de cada destinatário (recipients[].status), atualizado pelos webhooks recipient.*: o seu atendimento sabe na hora quem falta assinar.
• Para destinatários que costumam perder e-mails, use channel=whatsapp ou sms (com phone).
• Não reenvie automaticamente em sequência: cada reenvio troca o link e gera nova mensagem. Prefira os lembretes da conta.
• Guarde o id do envelope e o final_sha256 junto do registro do seu sistema: eles identificam o documento assinado para sempre.