Marca Dinâmica e UX: Personalizando o iFrame da Didit com JavaScript (PT-BR)
Aprenda a usar JavaScript para personalizar dinamicamente o iFrame de verificação incorporado da Didit, garantindo uma experiência de usuário perfeita e alinhada à sua marca.

Integração PerfeitaIntegre a robusta verificação de identidade da Didit diretamente em sua aplicação web usando o método iFrame InContext, oferecendo uma configuração rápida e experiência incorporada.
Personalização DinâmicaUtilize a API
postMessagedo JavaScript para se comunicar e estilizar dinamicamente o iFrame incorporado, garantindo que a identidade visual da sua marca seja consistentemente mantida durante todo o processo de verificação.Experiência do Usuário AprimoradaLide com eventos em tempo real do iFrame, como conclusão ou cancelamento da verificação, para fornecer feedback imediato e guiar os usuários por uma jornada suave e personalizada.
Arquitetura Flexível da DiditA abordagem modular e focada no desenvolvedor da Didit, incluindo o iFrame InContext e o SDK JavaScript, capacita os desenvolvedores a construir fluxos de verificação de identidade altamente personalizados e eficientes com KYC Core Gratuito.
Integrando o iFrame InContext da Didit para Verificação de Identidade
No cenário digital atual, a verificação robusta de identidade é primordial para segurança, conformidade e prevenção de fraudes. A Didit oferece uma gama de métodos de integração e, para empresas que buscam uma configuração rápida com uma experiência incorporada, o iFrame InContext se destaca. Este método permite que você incorpore as poderosas capacidades de Verificação de Identidade da Didit diretamente em sua aplicação web, mantendo os usuários em seu domínio. Embora simples de implementar, o verdadeiro poder do iFrame reside em sua capacidade de ser dinamicamente personalizado usando JavaScript, transformando um fluxo de verificação padrão em uma jornada de usuário perfeitamente integrada à marca.
O iFrame InContext é ideal para cenários onde você deseja um processo de verificação contido sem redirecionar os usuários. Ele suporta tanto UniLink (sem necessidade de backend para configuração rápida) quanto API Session (para personalização completa com um backend). Ao incorporar o iFrame, você pode aproveitar os recursos avançados da Didit, incluindo OCR, análise de MRZ e decodificação de código de barras para verificação de documentos, mantendo o controle sobre a interface do usuário circundante.
Personalização Dinâmica com a API postMessage do JavaScript
Embora um iFrame forneça uma experiência incorporada, manter a consistência da marca em toda a jornada do usuário é crucial. É aqui que a API postMessage do JavaScript se torna inestimável. Como o iFrame carrega conteúdo de uma origem diferente (o serviço de verificação da Didit), a manipulação direta do DOM é bloqueada pela política de mesma origem. No entanto, postMessage permite a comunicação segura entre origens diferentes entre sua página pai e o iFrame da Didit incorporado.
Ao escutar eventos ou mensagens específicas do iFrame e enviar mensagens para ele, você pode ajustar dinamicamente sua aparência ou comportamento. Por exemplo, você pode querer:
- Alterar a altura ou largura do iFrame com base no conteúdo carregado dentro.
- Acionar ações específicas em sua página pai quando uma etapa de verificação é concluída dentro do iFrame.
- Passar parâmetros de estilo para o iFrame para corresponder ao tema da sua aplicação, se suportado pela configuração do iFrame da Didit.
Uma configuração típica envolve:
- Incorporar o iFrame da Didit com seu atributo
srcapontando para a URL de verificação (por exemplo,https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64). - Adicionar um ouvinte de eventos à sua janela pai para capturar mensagens do iFrame:
window.addEventListener('message', (event) => {
// Garanta que a mensagem seja de uma origem confiável (domínio da Didit)
if (event.origin !== 'https://verify.didit.me') return;
const data = event.data;
if (data.type === 'didit-verification-event') {
console.log('Evento do iFrame da Didit:', data.payload);
// Lidar com eventos como 'verification_completed', 'verification_failed', etc.
}
});
Isso permite que sua aplicação reaja de forma inteligente ao status do iFrame, guiando a experiência do usuário de forma mais eficaz.
Aprimorando a Experiência do Usuário e o Tratamento de Eventos
Uma experiência de usuário verdadeiramente perfeita vai além da simples incorporação. Ela envolve fornecer feedback claro, gerenciar estados e lidar graciosamente com diferentes resultados do processo de verificação. A integração do iFrame da Didit, especialmente quando combinada com JavaScript, permite um tratamento sofisticado de eventos que pode melhorar significativamente a UX.
Por exemplo, após uma verificação bem-sucedida (que seu backend confirmaria via webhooks), você pode fechar programaticamente o modal contendo o iFrame, exibir uma mensagem de sucesso e integrar o usuário. Se uma verificação falhar ou for cancelada, você pode fornecer opções para tentar novamente ou entrar em contato com o suporte.
Considere um cenário em que você está usando a Verificação de Identidade da Didit para integrar novos usuários. Depois que o usuário conclui a captura e o envio de documentos dentro do iFrame, a Didit processa os dados, incluindo a realização de verificações de vivacidade passiva e ativa para prevenir fraudes de deepfake. Seu backend recebe um webhook com os resultados da verificação. Você pode então usar JavaScript para:
- Ocultar um spinner de carregamento assim que o iFrame enviar um evento 'verification_submitted'.
- Atualizar a UI para mostrar 'Verificação Pendente' enquanto seu backend processa o webhook.
- Exibir 'Verificação Aprovada' ou 'Verificação Recusada' com base no status final recebido por seu backend e comunicado de volta ao frontend.
Esse nível de interação dinâmica garante que os usuários estejam sempre informados e engajados, reduzindo as taxas de abandono e construindo confiança em sua plataforma.
Escolhendo a Integração Certa: iFrame vs. SDK JavaScript
Enquanto o iFrame InContext oferece configuração rápida e conveniência incorporada, a Didit também fornece um poderoso SDK JavaScript para aqueles que exigem controle programático máximo. O SDK, recomendado para aplicações de produção, oferece gerenciamento de sessão, callbacks de eventos e suporte completo a TypeScript, tornando-o ideal para aplicações complexas construídas com React, Vue, Angular ou JS puro.
O iFrame é excelente para um tempo mínimo de configuração, muitas vezes menos de 1 minuto, e para cenários onde você precisa de um fluxo de verificação contido e pronto para uso. No entanto, para callbacks de eventos em tempo real e controle programático completo sobre o fluxo do usuário, o SDK JavaScript oferece flexibilidade superior. Ambos os métodos suportam verificação entre dispositivos e white-labeling, garantindo a consistência da marca.
O compromisso da Didit com uma abordagem focada no desenvolvedor significa que você tem opções para integrar a verificação de identidade de uma forma que melhor se adapte à sua pilha tecnológica e aos seus objetivos de experiência do usuário. Seja pela simplicidade do iFrame ou pelo poder do SDK, você pode aproveitar a plataforma nativa de IA da Didit para construir fluxos de trabalho de identidade seguros e eficientes.
Como a Didit Ajuda
A Didit fornece os blocos de construção fundamentais para criar experiências de verificação de identidade altamente personalizáveis e seguras. Nossa arquitetura modular permite que você "plug-and-play" verificações de identidade como Verificação de ID, Vivacidade Passiva e Ativa, e Correspondência Facial 1:1 e Pesquisa Facial, tudo alimentado por IA de ponta. Para soluções incorporadas, o iFrame InContext oferece uma configuração incrivelmente rápida, permitindo que você implemente uma verificação robusta com o mínimo de esforço. Para aqueles que exigem integração mais profunda e controle dinâmico, nosso SDK JavaScript fornece as ferramentas para construir jornadas de usuário personalizadas, lidando com eventos em tempo real e mantendo a continuidade completa da marca.
A plataforma da Didit é projetada para ser focada no desenvolvedor, oferecendo um sandbox instantâneo, documentação pública abrangente e APIs limpas. Eliminamos taxas de configuração e oferecemos um nível de KYC Core Gratuito, tornando a verificação de identidade de nível empresarial acessível. Nossa abordagem nativa de IA garante alta precisão e automação, reduzindo a necessidade de revisões manuais e otimizando suas operações. Com a Didit, você pode orquestrar riscos e automatizar a confiança globalmente, garantindo uma experiência segura e amigável para seus clientes, ao mesmo tempo em que atende aos requisitos de conformidade.
Pronto para Começar?
Pronto para ver a Didit em ação? Obtenha uma demonstração gratuita hoje.
Comece a verificar identidades gratuitamente com o plano gratuito da Didit.