CORREÇÃO: "Confirmar documento" não envia nada — quem envia é o cadastro

CORREÇÃO DE UMA ORIENTAÇÃO ANTIGA

Circulava aqui a ideia de que "cadastrei o documento e não foi para ninguém" se resolvia com o Confirmar documento, porque Confirmar seria o envio e Adicionar seria só o cadastro. O código atual não sustenta isso. Se você repetir essa orientação, o cliente clica em Confirmar, recebe uma mensagem de sucesso e continua sem receber nada.

O QUE O CONFIRMAR FAZ HOJE

Confirmar faz uma coisa só: grava no documento a situação "andamento" e devolve a mensagem "Documento enviado com sucesso.". Não dispara e-mail, não dispara WhatsApp, não dispara SMS, não grava histórico e não mexe na situação de nenhum signatário. A mensagem de retorno fala em envio, mas envio não acontece ali.

Pior: o documento já nasce em "andamento" no momento em que é cadastrado. Não existe rascunho na Assinatura Digital, nem nenhuma outra situação inicial. E a edição do documento também regrava "andamento". Ou seja, Confirmar troca "andamento" por "andamento". Trate a ação como inofensiva: ela não conserta nem estraga envio.

QUEM ENVIA DE VERDADE

Quem envia é o cadastro do documento. Tudo acontece na hora em que o documento é salvo pela primeira vez.

O e-mail sai no fim do cadastro, para os signatários cujo tipo de envio é e-mail, e só quando o documento não foi criado como link compartilhado. Documento de link compartilhado não dispara e-mail no cadastro por desenho: ele existe para ser distribuído pelo link, e mandar esse link por e-mail é uma ação à parte, em que o endereço de destino é informado na hora.

O WhatsApp e o SMS saem dentro do próprio laço de signatários, um por signatário, e só depois de consumir saldo da carteira. Se o consumo do saldo não retorna movimentação, o bloco inteiro de envio daquele signatário é pulado em silêncio: nada é enviado, nada é registrado no histórico e o signatário fica em "não enviado".

Depois do cadastro ainda existe uma ação de reenvio do link de assinatura do documento. Ela redispara pelo meio de envio de cada signatário — e, em WhatsApp e SMS, consome saldo de novo. Não confunda com Confirmar: são coisas diferentes.

ORDEM DE DIAGNÓSTICO QUANDO NÃO FOI PARA NINGUÉM

Primeiro, o tipo de envio de cada signatário. Quando nada é informado, o sistema assume e-mail.

Segundo, o dado de contato. Aqui os dois meios se comportam de forma diferente. No e-mail, signatário sem e-mail preenchido nem deixa cadastrar: aparece "O assinante Fulano não possui e-mail!" e o documento não é criado. No WhatsApp e no SMS não existe essa checagem: telefone em branco ou errado passa, o saldo é consumido, o signatário é marcado como enviado e a mensagem não chega a lugar nenhum.

Terceiro, saldo, quando o envio for WhatsApp ou SMS. O cadastro pode ser barrado com "Saldo insuficiente na carteira.", e mesmo passando por essa checagem o consumo de cada signatário pode falhar na hora do disparo — e aí o envio é pulado sem mensagem nenhuma.

Quarto, se o documento foi criado como link compartilhado. Nesse caso a ausência de e-mail no cadastro é o comportamento correto.

Quinto, se nem o e-mail saiu para ninguém e os pontos acima estão certos, é configuração de ambiente. O envio depende de um endereço de assinatura configurado no domínio; sem ele a rotina de e-mail para no primeiro signatário e ninguém recebe. Isso não se resolve pela tela: encaminhe para o suporte técnico com o número do documento.

SITUAÇÕES DO DOCUMENTO

A lista é fechada: Em andamento, Assinado, Expirado, Cancelado e Recusado. Não existe "enviado" nem "aguardando envio" como situação do documento.

SITUAÇÕES DO SIGNATÁRIO

A lista também é fechada: não enviado, E-mail enviado, WhatsApp enviado, SMS enviado, E-mail visualizado, WhatsApp visualizado, Documento visualizado, Assinado e Recusado. Em "não enviado" o texto acompanha o meio escolhido, virando "SMS não enviado" ou "WhatsApp não enviado".

Use essa coluna, mas em uma direção só. Signatário em "não enviado" é sinal firme de que o disparo nem foi tentado, e aí você volta para a ordem de diagnóstico acima. Já "WhatsApp enviado" e "SMS enviado" não provam entrega: a situação e o histórico são gravados junto com o consumo do saldo, mesmo nos casos em que a mensagem não chegou a sair por falta do endereço de assinatura no domínio. Cliente com o signatário marcado como enviado e sem nada recebido cai no quinto ponto do diagnóstico.

O QUE COSTUMA DAR ERRADO

Achar que faltou confirmar. Como já explicado, não muda nada.

Mexer em permissão esperando destravar o envio. Permissão libera a ação, a ação não envia.

Cadastrar o signatário com WhatsApp ou SMS e conferir só a caixa de e-mail. São caminhos diferentes.

Editar o documento esperando reenviar. Editar regrava a situação, não redispara mensagem — para redisparar existe a ação de reenvio do link.