Assinatura Digital: resumo do documento e mensagem do convite geradas por IA
SÃO DOIS USOS DIFERENTES, E É AQUI QUE A CONVERSA TRAVA
O aplicativo usa IA para ler o documento em dois momentos distintos, e o cliente costuma chamar os dois de "o resumo". Antes de investigar qualquer coisa, descubra qual dos dois ele usou. O sintoma é o mesmo, a causa não é. Os dois passam pelo mesmo endereço interno, então as mensagens de "não veio arquivo" e de "método não permitido" valem para ambos — o resto não.
USO 1 — A MENSAGEM DO CONVITE
Acontece com o arquivo em mãos, na hora de compor o e-mail de solicitação. A IA lê o arquivo que acabou de ser anexado e escreve um texto curto para o corpo da mensagem. O pedido feito ao modelo é objetivamente por uma mensagem de até 40 palavras, só o texto, sem cumprimento e sem explicação. Por isso ela sai curta: é assim que foi pedida.
Isso é sugestão de texto. Não é o resumo do contrato e não deve ser lido como tal. Cliente que reclama que "o resumo veio pequeno demais" quase sempre está falando deste uso.
USO 2 — O RESUMO DO DOCUMENTO JÁ CADASTRADO
Acontece depois, com o documento já salvo no sistema. Aqui o sistema busca o arquivo guardado no armazenamento, manda ler e devolve um resumo estruturado do conteúdo: uma lista de tópicos, cada um com um título curto e um resumo do assunto daquele tópico — o pedido ao modelo é por até 30 palavras por tópico, então tópico curto é o esperado, não corte de informação. O modelo também é instruído a identificar todos os assuntos relevantes e a usar somente o que está no documento, sem deduzir nem completar o que falta.
É este o resumo que responde "do que trata este documento". O do uso 1, não.
POR QUE PDF ESCANEADO DÁ RESUMO RUIM (RESUMO DO DOCUMENTO CADASTRADO)
Esta é a causa real da maior parte dos chamados, e ela não aparece em nenhuma mensagem de erro. Vale para o uso 2 — o caminho descrito aqui é o do documento já cadastrado.
O sistema primeiro tenta extrair a camada de texto do PDF. PDF gerado por computador (impresso em PDF pelo Word, pelo próprio ERP, por um editor) tem essa camada: o texto está lá dentro, dá para selecionar e copiar. Nesse caminho a leitura é limpa e o resumo sai bom.
PDF escaneado é outra coisa. Cópia passada no scanner, foto do contrato, print de tela: não existe camada de texto, existe uma imagem da página. Quando a leitura volta sem texto nenhum, o sistema não desiste — cai automaticamente para leitura por reconhecimento óptico (OCR), que tenta ler as letras da imagem.
O OCR funciona, mas tem duas consequências que o cliente sente: demora mais, e a qualidade depende inteiramente da nitidez do escaneamento. Página torta, contraste fraco, carimbo por cima, assinatura à mão, resolução baixa e letra pequena degradam a leitura. O resultado é resumo vazio, truncado ou com trechos sem sentido.
Isso é comportamento esperado, não defeito do documento nem falha da conta. A saída prática é uma só: reenviar um PDF com texto de verdade, gerado do arquivo original em vez de escaneado.
Uma ressalva importante: o desvio para OCR só acontece quando a etapa de leitura responde e diz que não achou texto. Se essa etapa em si falhar ou demorar demais, o pedido volta com erro genérico, sem passar pelo OCR. Erro que aparece logo, sem espera longa, costuma ser esse caso — vale repetir uma vez antes de tratar como problema.
POR QUE DEMORA E A TELA FICA PARADA
O processamento de IA tem folga de até 5 minutos no servidor. Foi feito assim de propósito, porque ler um documento inteiro leva tempo. Documento grande, ou documento escaneado que precisou de OCR, chega perto dessa folga.
Então tela parada por um tempo longo é normal nesses casos. Oriente esperar antes de repetir. Repetir a chamada no meio do processamento só faz o cliente esperar duas vezes. A etapa de extração do texto, porém, tem um limite próprio bem menor — nem toda espera longa vai até os 5 minutos.
DOCUMENTO LONGO PODE SER RESUMIDO SÓ PELO COMEÇO
Quando o sistema consegue extrair a camada de texto, ele envia para o resumo os primeiros 6.000 caracteres desse texto. Documento longo, portanto, pode gerar um resumo que cobre bem o início e ignora o final, sem nenhum aviso na tela.
Se o cliente disser que o resumo "não fala do reajuste, que está na última página", esta é a explicação. Não é a IA escondendo informação. Esse corte é do caminho com texto extraído; quando a leitura foi por OCR, ele não se aplica.
AS MENSAGENS PRÓPRIAS DESTE RECURSO
Estas são as mensagens que o próprio recurso monta. Elas não são a lista completa do que pode aparecer: quando o serviço de IA responde com erro, a mensagem que ele devolveu aparece na tela no lugar de "Erro ao processar o documento.". Frase estranha, em inglês ou com jargão técnico, normalmente é isso — anote o texto exato e reporte.
"Não foi possível baixar o arquivo do documento." — o sistema não conseguiu buscar o arquivo guardado. É problema de acesso ao arquivo, não de leitura. Confirme se o documento tem arquivo e se ele abre normalmente na tela do documento.
"Erro ao processar o documento." — o serviço de IA não respondeu como esperado. Orientar repetir mais tarde; se persistir, é caso de reportar.
"Erro ao decodificar a resposta da API." — mesmo grupo do anterior: a resposta veio, mas ilegível. Mesma conduta.
"Nenhum arquivo enviado!" — a chamada chegou sem arquivo e sem documento indicado. Normalmente é tentativa feita antes de anexar o arquivo, ou fora do fluxo da tela.
"Método não permitido. Use POST." — o endereço só aceita chamada por POST. Quem vê isso está acessando o endereço direto pelo navegador ou por integração própria, não pela tela.
O QUE COSTUMA DAR ERRADO
"O resumo veio vazio" — quase sempre PDF escaneado. Peça para o cliente tentar selecionar o texto dentro do PDF. Se não seleciona, é imagem, e o OCR foi o que respondeu.
"O resumo veio com palavras erradas" — mesma causa. OCR lendo escaneamento ruim.
"Pedi o resumo e veio uma frase curta" — ele usou o texto do convite (uso 1), que é feito para caber num e-mail.
"Ficou carregando eternamente" — documento grande e/ou OCR, dentro da folga de 5 minutos.
"O resumo não fala da parte final do contrato" — o corte dos primeiros 6.000 caracteres.
"Deu erro na hora, quase instantâneo" — a etapa de leitura do arquivo falhou antes de chegar ao OCR. Repetir; se repetir sempre, reportar.
O QUE ESTE RECURSO NÃO É
O resumo é apoio de leitura. Ele não substitui ler o contrato. Não afirme que a IA confere cláusulas, valores ou prazos, que ela valida o documento ou que o resumo tem qualquer valor jurídico. Ela lê e resume, e é instruída a não inventar o que não está escrito — o que não elimina erro de leitura, ainda mais em documento escaneado.
Também não confunda com a conferência da foto do documento e da selfie do signatário, que é outro recurso do aplicativo, com outra finalidade e outras mensagens.
O CONTEÚDO DO DOCUMENTO NÃO É ASSUNTO DO SUPORTE
Se o cliente perguntar o que a cláusula quer dizer, se o valor está correto, se o prazo é válido ou se ele deve assinar, isso está fora do suporte do sistema. O suporte responde por o recurso funcionar, pelas mensagens que ele devolve e pela qualidade da leitura do arquivo — não pelo que está escrito no contrato.