Pular para o conteúdo principal
Esta página é a fonte da verdade atualizada dos códigos de idioma aceitos pela API da Didit. Ela é referenciada nas especificações OpenAPI, tanto para o campo language no nível da sessão quanto para o campo contact_details.email_lang em Criar sessão.

​
Onde esses códigos se aplicam

O mesmo conjunto de códigos é aceito em todos os lugares em que um idioma pode ser configurado: Se o idioma do navegador do usuário for compatível, a interface de verificação o detecta automaticamente; caso contrário, usa inglês (en) como alternativa. Se você não informar email_lang, os e-mails usam en. Todos os valores diferenciam maiúsculas de minúsculas - use exatamente os códigos da tabela abaixo.

​
Todos os idiomas compatíveis

O conjunto abaixo espelha as chaves de EMAIL_TRANSLATIONS no serviço - tanto a interface de verificação quanto a camada de localização dos e-mails leem o mesmo dicionário, então qualquer código desta tabela funciona tanto para language quanto para email_lang. Três idiomas são exibidos da direita para a esquerda, tanto na interface de verificação quanto nos e-mails: árabe (ar), hebraico (he) e persa / farsi (fa).
Os validadores que aceitam esses códigos são BaseSessionSerializer.validate_language e ContactDetailsSerializer.validate_email_lang. Ambos retornam 400 com a mensagem "Invalid language. Supported languages are: ..." (ou "Invalid email language...") para qualquer valor fora da tabela acima.

​
Como escolher o idioma de uma sessão

A interface de verificação detecta automaticamente o idioma do navegador do usuário. Quando o idioma do navegador é um dos códigos acima, a interface e os e-mails são exibidos nesse idioma. Caso contrário, a interface usa inglês como alternativa. Você também pode definir o idioma explicitamente ao criar uma sessão:
Se você definir apenas language, os e-mails continuam em inglês por padrão, a menos que você também informe email_lang. Da mesma forma, definir email_lang não altera o idioma da interface no navegador - os dois campos são independentes.

​
Variantes por país

Três códigos são variantes regionais que você deve preferir quando conhece o seu público:
  • pt-BR - português do Brasil (use em vez do genérico pt para usuários brasileiros).
  • zh-CN - chinês simplificado (China continental, Singapura).
  • zh-TW - chinês tradicional (Taiwan, Hong Kong, Macau).
Os códigos genéricos pt e zh também são aceitos; a variante escolhida afeta apenas o vocabulário e os caracteres, não a lógica de verificação subjacente.

​
Como solicitar um novo idioma

Se você precisa de um idioma que não está listado acima, fale com nossa equipe de suporte. Em geral, conseguimos adicionar um novo idioma a EMAIL_TRANSLATIONS e à interface de verificação em até 24 horas após a sua solicitação - depois de adicionado, esta página é atualizada e o novo código passa a ser aceito imediatamente pela API. Fale conosco pelo WhatsApp ou pelo seu canal de suporte habitual para solicitar suporte a idiomas adicionais.

​
Referências relacionadas

API Criar sessão

Onde language e email_lang são informados ao iniciar uma verificação.

Atualizar status da sessão

Define email_language para o e-mail de notificação de mudança de status.

Webhooks

Receba os resultados da verificação - os payloads incluem o language escolhido.

Modelos de dados

Esquema canônico de sessões, dados de contato e status.