O SantoID é uma plataforma de processamento inteligente de documentos que utiliza Inteligência Artificial para automatizar a validação, classificação e extração de dados. Desenvolvido pela Santo Digital, substitui processos manuais por automação precisa, trazendo:

• Aumento de produtividade
• Redução de custos operacionais
• Melhoria na qualidade dos dados
• Soluções personalizadas para diversos setores

Um domínio é o ambiente principal disponibilizado ao cliente, onde é possível criar e gerenciar processos, usuários, webhooks, credenciais de acesso à API e outras configurações essenciais.

Subdomínios são ambientes adicionais disponibilizados ao cliente para testes e validações antes da entrada em produção. O SantoID permite que, além do ambiente de produção, o cliente também utilize os ambientes de staging (homologação) e dev (desenvolvimento) para realizar testes com segurança e organização.

Para alternar entre ambientes (produção, homologação e desenvolvimento), siga os passos abaixo:

No canto superior direito da tela, ao lado da sua foto de perfil, clique no botão com uma seta para baixo.

Um modal será aberto com a opção Selecionar ambiente.

Escolha o ambiente desejado: produção, homologação ou desenvolvimento.

Clique em OK.

A página será recarregada com o ambiente selecionado.

Exemplo visual:

Para transferir processos entre ambientes (produção, homologação e desenvolvimento), siga os passos abaixo:

1. Acesse a tela do processo que deseja transferir.
2. Ao lado do nome do processo, clique no ícone de transferência.
3. Um modal será exibido com as seguintes opções:
   • Copiar
   • Criar novo processo
   • Utilizar já existente

O que faz a opção Copiar?

Transfere o processo atual para o ambiente selecionado, com o mesmo identificador.
Exemplo: copiar o processo identificacao_pessoa_fisica do ambiente de homologação para produção.

• Se um processo com o mesmo identificador já existir no ambiente de destino, ele será atualizado.
• Caso não exista, um novo processo será criado automaticamente com o mesmo identificador.

O que faz a opção Criar novo processo?

Permite transferir o processo atual para um novo processo criado no ambiente de destino.
Exemplo: copiar identificacao_pessoa_juridica do ambiente de desenvolvimento para produção, criando um processo com identificador diferente, conforme definido pelo usuário.

O que faz a opção Utilizar já existente?

Permite transferir o processo atual para um processo já existente no ambiente de destino, selecionado manualmente.
Exemplo: ao transferir identificacao_pessoa_fisica de desenvolvimento para homologação, você pode escolher um processo existente para sobrescrever com os dados do processo de origem.

O que é transferido?

• Labels:

  • Todas as labels do processo de origem serão copiadas exatamente como estão.
  • Labels existentes no processo de destino que não estão presentes no processo de origem serão removidas.

• Templates:

  • Templates com o mesmo identificador serão atualizados.
  • Templates novos (não existentes no destino) serão criados.
  • Templates já existentes no destino, mas que não fazem parte do processo de origem, serão preservados.

Antes da finalização da transferência, será exibido um resumo detalhado com tudo o que será alterado, criado ou removido no ambiente de destino.

Exemplo visual:

Tracks são fluxos de trabalho completos onde você pode criar e gerenciar pipelines de processamento de documentos. Cada Track permite configurar:

• Tipificação (classificação de documentos)
• OCR (extração de dados)
• Face-Match (verificação facial)
• Liveness (prova de vida)
• Workflows personalizados

Exemplo: Uma Track para onboarding de clientes pode validar RG, CPF e comprovante de residência automaticamente.

O trackId é identificador único para cada fluxo de trabalho que você criar.

Você encontra esse identificador em:

1. Acessando Processos

Exemplo visual: (É esse identificador único que aparece destacado na imagem com retângulo vermelho)

O template é o "modelo" que usamos para extrair informações dos seus documentos. Cada tipo de documento (CNH, RG, contrato etc) tem um template específico.

Como encontrar:

1. Vá até seu processo
2. Acesse a aba 'OCR'
3. Selecione o template desejado
4. O ID aparecerá nos detalhes

Veja como identificar:

É esse identificador único que aparece destacado na imagem com retângulo vermelho

Dica: Anote esse código para usar nas suas integrações!

O requestId é o número de protocolo que o SantoID gera automaticamente para cada operação que você realiza conosco.

É útil quando você precisar:

• Acompanhar o status de uma solicitação
• Consultar resultados específicos
• Falar com nosso suporte técnico

Exemplo de uso: "Olá, minha solicitação XYZ123 falhou no OCR" (onde XYZ123 é o requestId)

O customerRequestId é o seu próprio identificador que pode incluir nas requisições. Funciona como uma "marcação" pessoal para você controlar melhor seus processos.

Use quando quiser:

• Vincular solicitações ao seu sistema interno
• Buscar resultados usando sua própria numeração
• Manter um histórico personalizado

Dica prática: Pode ser um ID do seu sistema, número de pedido, ou qualquer código que faça sentido para sua equipe.

O SantoID processa diversos tipos de documentos, incluindo:

• Documentos de identificação (RG, CNH, Passaporte, ...)
• Comprovantes (residência, bancários...)
• Contratos e documentos legais
• Notas fiscais e faturas
• Formulários médicos
• E qualquer outro documento

Suporta formatos: PDF, JPG, PNG, TIFF e outros.

O OCR (Reconhecimento Óptico de Caracteres) do SantoID oferece:

• 🔍 Extração precisa de textos em diversos formatos
• 📄 Captura estruturada de campos-chave
• ⚡ Processamento acelerado por IA
• 🔗 Integração com classificação de documentos

Benefícios:

• Até 90% de redução em erros manuais
• Processamento 10x mais rápido que métodos tradicionais
• Suporte a múltiplos idiomas e layouts complexos

A Tipificação classifica automaticamente os documentos recebidos:

• 🏷️ Identifica o tipo (RG, CNH, Contrato, etc.)
• 📂 Usa modelos pré-treinados e customizáveis
• 🔀 Processa em lote diversos documentos
• 🤖 Combina com OCR para extração simultânea

Caso de uso: No onboarding digital, classifica automaticamente quais documentos o cliente enviou.

O Face Match compara rostos em documentos com imagens vivas:

• 👤 Tecnologia de reconhecimento facial avançada
• 📸 Compatível com selfies e fotos de documentos
• ⚡ Resultados em tempo real
• 🔒 Segurança reforçada contra fraudes

Aplicações típicas:

• Onboarding digital
• Autenticação em transações
• Controle de acesso

A prova de vida (Liveness) verifica se a pessoa está presente durante a interação:

• ✅ Detecta tentativas de fraude com fotos ou vídeos
• 🎭 Realiza desafios de movimentação
• ⏱️ Processamento em tempo real
• 📱 Disponível via SDK para mobile

Workflows automatizam processos complexos:

• 🔄 Etapas múltiplas com regras condicionais
• 🎯 Seleção pelos resultados mais confiáveis
• 🤝 Integração nativa com outras funcionalidades

Exemplo: Um workflow pode validar RG, comprovar endereço e checar相似idade facial em uma única sequência.

O tempo varia conforme o tipo de processamento:

• Tipificação: 1-3 segundos
• OCR simples: 2-5 segundos
• OCR complexo: 5-10 segundos
• Face Match: 3-7 segundos
• Workflows completos: 10-30 segundos

Para lotes grandes, o sistema processa em paralelo, mantendo a eficiência.

Você pode integrar via:

1. API REST - para requisições diretas
2. SDK JavaScript - para aplicações web
3. Webhooks - para respostas assíncronas
4. Upload direto - via interface web

Documentação completa disponível em: SantoID Docs

Sim, o SantoID segue os mais altos padrões:

• Criptografia TLS 1.2+
• Dados armazenados de forma segura
• Compliance com LGPD
• Certificações de segurança em andamento
• Controles de acesso granular

Passos iniciais:

1. Entre em contato para criação de domínio app.santoid.com.br
2. Configure sua primeira Track
3. Faça upload de documentos de teste
4. Integre via API ou SDK
5. Receba os resultados de forma rápida

Oferecemos suporte técnico durante toda a implementação.

Webhooks permitem receber resultados de processamento de forma assíncrona diretamente em seus sistemas. Principais características:

• Recebimento imediato de resultados prontos
• Configuração de endpoints personalizados
• Suporte a HTTPS com TLS 1.2+
• Política de retentativa automática (5 tentativas)
• Armazenamento de mensagens por 7 dias

Fluxo básico:

1. Processamento é concluído no SantoID
2. Sistema verifica se webhook está disponível
3. Envia resultados imediatamente ou entra em fila de retentativas

Passos para configuração:

1. Cadastre seu endpoint HTTPS no SantoID
2. Garanta que retorne HTTP 200 para confirmação
3. Configure e-mail para monitoramento
4. Teste com ferramentas como webhook.site

Requisitos técnicos:

• Tempo de resposta < 5 segundos
• Capacidade de receber JSON
• Implementação de idempotência
• Logs de todas as requisições

Em caso de falha, o SantoID executa:

1. 5 tentativas de reenvio
2. Intervalos de 10 minutos entre tentativas
3. Notificação por e-mail após 3 horas sem sucesso
4. Armazenamento em fila de mensagens mortas por 7 dias

Política completa:

• Primeira falha: 1ª retentativa em 10min
• Falha persistente: notificação após 24h
• Tentativas esgotadas: mensagem movida para fila morta

As respostas seguem padrão JSON com campos comuns:

• domain: domínio de processamento
• track: ID do fluxo relacionado
• requestId: identificador único
• customerRequestId: seu ID opcional
• executionDatetime: timestamp UTC

Estruturas específicas por serviço:

• OCR/Tipificação: inclui array "documents"
• FaceMatch: campos "comparison_score" e "match"
• Workflow: lista "rejectedReasons"

Dois tipos principais de erros:

1. Falha na Entrega:

• Endpoint indisponível
• 5 tentativas de reenvio
• Backoff exponencial entre tentativas

2. Erro Interno:

• Falha no processamento
• Notificação imediata
• Mensagem enviada mesmo com erro

Melhores práticas:

• Implemente confirmação (HTTP 200)
• Monitore e-mails de notificação
• Mantenha logs detalhados

O SantoID oferece 4 tipos principais:

1. OCR:

• Extração de dados estruturados
• Suporte a múltiplos documentos

2. Tipificação:

• Classificação de documentos
• Identificação do tipo (RG, CNH, etc)

3. FaceMatch:

• Pontuação de similaridade
• Resultado booleano de match

4. Workflow:

• Resultados complexos multi-etapas
• Razões de rejeição quando aplicável

Fluxo completo de retentativa:

1. Tópico Principal: recebe requisições
2. Tópico de Retentativa: armazena falhas
3. Tópico de Mensagens Mortas: após 5 tentativas

Detalhes:

• Máximo 5 tentativas
• Intervalo de 10 minutos
• Armazenamento por 7 dias
• Exclusão automática após expiração

Sistema baseado em PubSub com:

1. Tópico Principal:

• Recebe todas as requisições
• Encaminha para processamento

2. Tópico de Retentativa:

• Backoff exponencial
• 5 tentativas máximas

3. Tópico de Mensagens Mortas:

• Período de recuperação
• Exclusão automática

Recomendações essenciais:

1. Implemente idempotência
2. Mantenha logs completos
3. Teste com webhook.site
4. Monitore notificações
5. Documente fluxos esperados
6. Configure alertas proativos
7. Valide requestId para evitar duplicados
8. Armazene timestamps em UTC

Campos específicos do FaceMatch:

• comparison_score: distância entre rostos (valores menores = mais similaridade)
• similarity_score: pontuação 0-1
• match: true/false indicando correspondência

Dica: Considere thresholds personalizados para decisões de negócio.

Além dos campos comuns, inclui:

• rejectedReasons: lista de razões de rejeição
• documents: array com objetos workflow

Importante: Verifique rejectedReasons mesmo em caso de status "sucesso", pois podem conter alertas ou observações relevantes.

Estratégias recomendadas:

1. Confirmação imediata (HTTP 200)
2. Monitoramento contínuo do endpoint
3. Tratamento de idempotência
4. Armazenamento local das mensagens
5. Verificação de requestId
6. Processamento assíncrono no seu lado
7. Plano de recuperação para falhas prolongadas

Para utilizar a extração em massa, siga os passos abaixo:

• 📂 1. Acesse a Área de processo:

  • Na tela de OCR, encontre o template que deseja usar e clique no ícone de .
  • Na tela seguinte, clique na aba "Extração em Massa".
  • Na tela seguinte, clique no botão "Nova Extração".

• 🚀 2. Configure e Envie seus Arquivos:

  • Na janela que surgir, adicione todos os documentos que deseja processar.
  • Após carregar os arquivos, clique em "INICIAR PROCESSAMENTO".
  • (Opcional) Receba os resultados por e-mail: Marque a caixa de seleção e escolha o formato do arquivo (CSV ou JSON).

• 📊 3. Verifique o Status e Obtenha os Resultados:

  • Você será direcionado ao painel de "Processamento em Lote".
  • O status do lote será atualizado automaticamente em sequência e receberar um e-mail avisando que foi concluído. Você não precisa aguardar nesta tela.
  • Quando a extração for concluída, você poderá baixar ou visualizar os resultados.
  • Importante: Os arquivos de resultado ficarão disponíveis para download por 7 dias. Após esse período, eles serão removidos.

Para utilizar a tipificação em massa, siga os passos abaixo:

• 📂 1. Acesse a Área de processo:

  • Na tela de tipificação, clique no botão TESTAR DOCUMENTOS.
  • Na tela seguinte, clique na aba "Tipificação em Massa".
  • Na tela seguinte, clique no botão "Nova Tipificação".

• 🚀 2. Configure e Envie seus Arquivos:

  • Na janela que surgir, adicione todos os documentos que deseja processar.
  • Após carregar os arquivos, clique em "INICIAR PROCESSAMENTO".
  • (Opcional) Receba os resultados por e-mail: Marque a caixa de seleção e escolha o formato do arquivo (CSV ou JSON).

• 📊 3. Verifique o Status e Obtenha os Resultados:

  • Você será direcionado ao painel de "Processamento em Lote".
  • O status do lote será atualizado automaticamente em sequência e receberar um e-mail avisando que foi concluído. Você não precisa aguardar nesta tela.
  • Quando a extração for concluída, você poderá baixar ou visualizar os resultados.
  • Importante: Os arquivos de resultado ficarão disponíveis para download por 7 dias. Após esse período, eles serão removidos.