Armazenamento de documentos e automação de fotos
Colete fotos de visto e digitalizações de passaporte dos seus clientes pelo link de admissão, valide-os à medida que são enviados e deixe o agente enviar a foto ao portal oficial do DS-160 automaticamente.
Cada formulário DS-160 tem dois espaços de documentos — uma foto da solicitação e uma digitalização do passaporte. Você e seus clientes podem gerenciá-los pelo painel ou pelo link de admissão do cliente, e quando um envio é executado, o agente envia a foto ao Sistema de Envio de Fotos do Departamento de Estado automaticamente.
1. Espaços de documentos
| Espaço | Nome técnico | Formato | Limite de tamanho | Usado por |
|---|---|---|---|---|
| Foto da solicitação | applicationPhoto | JPEG | 240 KB | O agente a envia ao DS-160 |
| Digitalização do passaporte | passportScan | JPEG, PNG ou PDF | 10 MB | Fica guardada em arquivo para seus registros |
Cada formulário admite no máximo um documento ativo por espaço. Enviar um novo exclui (soft-delete) a versão anterior — o arquivo é removido do armazenamento de objetos, mas os metadados permanecem para a trilha de auditoria.
O limite de 240 KB / apenas JPEG da foto da solicitação é a especificação estrita do DS-160. Se você ativar o envio flexível de fotos (consulte «Permitir qualquer foto», seção 3), o espaço aceita os mesmos formatos e o limite de 30 MB que a digitalização do passaporte.
2. Onde os clientes enviam
Quando você gera um link de admissão para um cliente, ele verá uma etapa de Documentos ao lado do questionário. Eles podem:
- Arrastar ou selecionar um arquivo para cada espaço
- Ver os resultados de validação em linha (tamanho, formato, verificações biométricas básicas para a foto)
- Substituir ou excluir o que tiverem enviado
- Continuar preenchendo o questionário mesmo que faltem documentos — os envios são independentes do restante do formulário
O cliente nunca vê uma URL de armazenamento nem credenciais da agência. A autenticação está limitada ao token de admissão dele; os envios de um link de cliente não podem tocar nos documentos de outro formulário.
3. Foto da solicitação — o que verificamos
A foto passa pelo mesmo validador que alimenta o verificador público de fotos de visto dos EUA. Por padrão, estas são rejeições rígidas — o envio falha (para aceitar qualquer foto e convertê-las em avisos, consulte «Permitir qualquer foto» mais abaixo):
- O arquivo não é JPEG, ou está fora do intervalo 10 KB – 240 KB
- As dimensões em pixels estão fora de 600×600 – 1200×1200, ou a proporção não é quadrada
- A imagem não está em sRGB / 24 bits de cor
- A compressão JPEG ultrapassa 20:1 (supercomprimida)
- O fundo não é majoritariamente branco / branco off-white
- Nenhum rosto detectado, vários rostos, a cabeça fica fora de 50–69% da altura da imagem, os olhos estão fechados ou é uma foto de perfil (quando a detecção facial está ativada)
Avisos informativos (o envio é concluído, mas o cliente vê um alerta):
- A imagem não está a 300 DPI — só é necessário para fotos impressas (visto de imigrante DS-260, entrevista presencial); não é exigido para envios digitais do DS-160
- A imagem seria impressa em um tamanho diferente de 2×2 inches — mesmo contexto que o DPI
- Os metadados EXIF sugerem que a foto pode ter mais de seis meses
- A imagem foi salva como JPEG progressivo
- A foto parece subexposta ou superexposta, ou tem um contraste extraordinariamente baixo
- O rosto não está centralizado no enquadramento
O texto do aviso é traduzido para o idioma selecionado pelo cliente; você verá o mesmo texto no idioma dele no log de auditoria.
Permitir qualquer foto (envio flexível)
As verificações estritas acima impedem que um cliente envie algo que não cumpra exatamente a especificação de foto do DS-160. É o padrão adequado para o autoatendimento, mas frustra os clientes cujas fotos de celular não são quadradas, são grandes demais ou têm um fundo carregado — e eles acabam enviando a foto para você por e-mail. Se você preferir coletar qualquer foto e corrigi-la você mesmo antes do envio, ative o envio flexível de fotos:
- Por workspace — Workspace → Configurações → Admissão de clientes → Permitir qualquer foto. Isso passa a ser o padrão de cada novo link de cliente.
- Por link de cliente — o mesmo seletor aparece ao gerar um link, já preenchido com o padrão do workspace, de modo que você pode substituí-lo para um cliente específico.
Com o envio flexível ativado, a foto da solicitação é controlada como a digitalização do passaporte — aceita-se qualquer JPEG, PNG ou PDF de até 30 MB — e todas as verificações de forma/biométricas acima são rebaixadas a aviso informativo. O cliente (e você, no registro de auditoria) continuam vendo exatamente o que está errado, mas o envio é bem-sucedido e ele pode continuar.
O modo flexível só altera o que o link de admissão do cliente aceita. Nunca é exigida uma foto para enviar, então nada posterior depende dela — e o próprio sistema de fotos do Departamento de Estado continua validando a imagem quando o agente a envia (consulte a seção 6), de modo que uma foto não conforme ainda pode ser rejeitada lá. Use o modo flexível quando tiver a intenção de revisar ou substituir a foto você mesmo antes que o agente seja executado.
4. Digitalização do passaporte — o que verificamos
O validador só olha para a forma do arquivo:
- O tipo MIME detectado (por meio de impressão de bytes mágicos, não apenas a extensão) é JPEG, PNG ou PDF
- O tamanho é igual ou inferior a 10 MB
- O arquivo não está vazio
Sem OCR, sem verificações biométricas. A digitalização do passaporte é para seus registros — não lemos nem analisamos seu conteúdo.
5. Armazenamento
Os documentos são criptografados em repouso.
Excluir um documento — ou substituí-lo por um novo envio — remove o arquivo do armazenamento imediatamente. Mantemos uma linha de metadados para o registro de auditoria, mas o arquivo em si desaparece no momento em que você confirma a exclusão.
6. Envio automático de fotos
Quando o agente executa um envio com uma foto da solicitação anexada, ele agora gerencia o Sistema de Envio de Fotos do Departamento de Estado de ponta a ponta. Você verá duas novas etapas na visualização de progresso do envio:
- Enviar foto — o agente abre o sistema de fotos do Departamento de Estado, envia o JPEG e aguarda o resultado da verificação de qualidade.
- Confirmar foto — o agente retorna ao formulário DS-160 e avança além da tela Confirmar foto.
Ambas aparecem na lista de etapas depois das etapas das seções do formulário e antes da fase de Revisão/Assinatura. Elas se comportam como qualquer outra etapa: status de sucesso / falha, marcas de tempo e o fluxo padrão de nova tentativa em caso de falha.
Quando as etapas são executadas
As etapas da foto são adicionadas à lista de etapas ativa somente se o formulário tiver um documento applicationPhoto anexado no momento em que o agente obtém seus parâmetros de trabalho. Os formulários sem foto pulam ambas as etapas — o agente envia o restante do formulário e depois para na fase da Foto como antes.
Se você anexar uma foto depois que um envio já tiver começado, o agente que já está em execução não a recolherá; cancele e reenvie para obter os parâmetros novamente.
Quando o Departamento de Estado rejeita a foto
Se o sistema de fotos do Departamento de Estado rejeitar o envio (seu mecanismo de qualidade ocasionalmente rejeita fotos que passam pela nossa pré-validação — somos mais estritos quanto à forma do arquivo e mais flexíveis quanto a casos-limite biométricos), o agente falha na etapa Enviar foto com a mensagem de rejeição do Departamento de Estado anexada. Você verá a falha na visualização de progresso do envio com a redação exata do Departamento de Estado, para saber se deve pedir ao cliente uma nova foto ou se há um problema de pixels no validador.
7. Trilha de auditoria
Cada envio, substituição e exclusão é registrado no log de auditoria de campos com:
- O espaço afetado (
applicationPhoto/passportScan) - A origem (
client_linkcom o JTI do link, ouauthenticated_usercom o ID e e-mail do usuário) - Uma marca de tempo
- O nome e o tamanho do novo documento
Abra Resumo do formulário → Log de auditoria para ver a sequência completa de edições — os campos do questionário e os documentos compartilham a mesma linha do tempo.