> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/captura-inteligente-de-documentos/personalizacao-de-texto.md).

# Personalização de texto

As strings que o fluxo do Smart Capture renderiza — instruções, botões, mensagens de erro e rótulos de acessibilidade — podem ser substituídas por sua própria redação, sem precisar fazer um fork do SDK.

{% hint style="warning" %}
No React Native, a configuração do fluxo é TypeScript, mas o texto é personalizado por plataforma:

* Android: substitua os recursos de string em `android/app/src/main/res/`. `customLocalization` é ignorado.
* iOS: passe `customLocalization` (seu `.strings` nome da tabela) em `CerttaSmartCaptureConfiguration`.
  {% endhint %}

{% tabs %}
{% tab title="Android" %}

## Visão geral

Todo texto exibido no fluxo Smart Capture é um recurso normal de string do Android com um ID de recurso fixo. Você envia sua própria redação declarando uma string com o mesmo nome no módulo do app Android do React Native. Você inclui apenas as chaves que realmente quer alterar; todo o resto mantém a tradução do próprio SDK.

Isso funciona por causa de como o Android mescla os recursos: quando seu app e a biblioteca Smart Capture declaram uma string com o mesmo nome, o recurso do seu app prevalece na compilação. Nenhuma API em tempo de execução — `customLocalization` na configuração TypeScript não faz nada no Android.

Os IDs dos recursos são internos à versão atual do SDK nativo e podem mudar entre as versões. Verifique novamente esta lista após atualizar.

### API

O Android não usa um campo TypeScript para strings. A personalização é o nome do recurso:

| Mecanismo                         | Onde                                                                  | Descrição                                                         |
| --------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Substituição de recurso de string | `android/app/src/main/res/values/strings.xml` (ou `values-<locale>/`) | Declare um `<string>` (ou `<plurals>`) com o mesmo `nome` do SDK. |

Quando você não declara um determinado nome, o SDK usa sua própria string.

```xml
<!-- android/app/src/main/res/values/strings.xml -->
<resources>
    <string name="certta_smart_capture_instructions_title">Prepare seu documento de identidade</string>
    <string name="certta_smart_capture_select_validation_type_capture_title">Abrir câmera</string>
</resources>
```

Todo o restante nessas telas mantém a redação do próprio SDK.

### Adicionando suas strings

1. Crie ou reutilize `strings.xml` no módulo do app Android — `android/app/src/main/res/values/` e, para cada localidade, `values-<locale>/`.
2. Adicione apenas as chaves que você quer substituir. As chaves omitidas não são um erro e não exibem uma chave bruta na tela.
3. Recompile o app. Seus recursos substituem automaticamente os padrões do SDK.

```xml
<!-- android/app/src/main/res/values-pt/strings.xml -->
<resources>
    <string name="certta_smart_capture_camera_intro_hint">Escaneie seu documento agora</string>
</resources>
```

### Ordem de resolução

Para cada chave, o Android resolve nesta ordem:

1. A string do seu app com esse ID de recurso, na pasta de localidade que corresponde ao idioma do dispositivo.
2. A string do seu app com esse ID na pasta padrão `values/` pasta (se você a tiver substituído lá).
3. A tabela própria do SDK para o idioma do dispositivo.
4. O padrão do SDK, que é inglês.

Substituições parciais são suportadas e recomendadas. Declarar um nome que o SDK não usa é ignorado.

O SDK oferece inglês, espanhol e português. Em um dispositivo cujo idioma não seja nenhum desses, o texto do SDK é exibido em inglês.

### Localização

O idioma exibido acompanha a localidade do dispositivo em relação às pastas de recursos que seu app empacota. O Smart Capture não expõe um alternador de idioma próprio.

| Localidade               | Pasta de recursos |
| ------------------------ | ----------------- |
| Inglês (padrão/fallback) | `values/`         |
| Espanhol                 | `values-es/`      |
| Português                | `values-pt/`      |

#### Adicionando um idioma que o SDK não oferece

Crie `values-<locale>/strings.xml` no módulo do app Android e substitua as chaves que o usuário verá. As chaves que você omitir voltam para o inglês, então traduza todas as chaves que devem aparecer nesse idioma.

```xml
<!-- android/app/src/main/res/values-fr/strings.xml -->
<resources>
    <string name="certta_smart_capture_instructions_title">Prepare seu documento</string>
    <!-- chaves certta_smart_capture_* restantes -->
</resources>
```

{% hint style="info" %}
Consulte o [Guia de localização do Android — Criando recursos alternativos](https://developer.android.com/guide/topics/resources/localization#creating-alternatives).
{% endhint %}

### Especificadores de formato

{% hint style="warning" %}
Alguns valores contêm marcadores de formato — `%s`, `%1$d`, `{doc}` — ou blocos ICU plurals / select (gênero), por exemplo&#x20;
{% endhint %}

`certta_smart_capture_camera_wrong_document_back_expected_hint`. Sua substituição deve manter os mesmos marcadores e a mesma estrutura. Eliminá-los, ou alterar o plural `<item>` quantidades, gera saída incorreta em tempo de execução.

### Referência de chaves

Todas as chaves têm o prefixo `certta_smart_capture_` para evitar conflitos. Os valores mostrados são os padrões em inglês.

#### Instruções de captura

```xml
<string name="certta_smart_capture_camera_intro_hint">Escaneie seu documento</string>
<string name="certta_smart_capture_camera_center_document_hint">Centralize o documento</string>
<string name="certta_smart_capture_camera_come_closer_hint">Aproxime-se</string>
<string name="certta_smart_capture_camera_step_back_hint">Afaste-se um pouco</string>
<string name="certta_smart_capture_camera_ask_to_frozen_hint">Capturando… Fique imóvel</string>
<string name="certta_smart_capture_camera_manual_capture_announcement">A captura automática terminou. Você pode tirar a foto manualmente.</string>
<string name="certta_smart_capture_camera_turn_document_hint">Vire o documento</string>
<string name="certta_smart_capture_camera_uploading_document">Enviando o documento…</string>
<string name="certta_smart_capture_camera_captured_with_success">Documento validado com sucesso.</string>
<string name="certta_smart_capture_camera_generic_error_message">Não foi possível validar. Tente novamente.</string>
<string name="certta_smart_capture_camera_photo_content_description">Capturar foto</string>
<string name="certta_smart_capture_camera_or_last_param">" ou "</string>
<string name="certta_smart_capture_camera_error_prefix">Alerta: </string>
```

#### Mensagens de documento inválido

```xml
<string name="certta_smart_capture_camera_doc_not_accepted_alert_error">Use %s</string>
<string name="certta_smart_capture_camera_wrong_document_back_expected_hint">Capture o verso do {doc}</string>
<string name="certta_smart_capture_camera_wrong_document_front_expected_hint">Capture a frente do {doc}</string>
```

#### Nomes dos tipos de documento

```xml
<string name="certta_smart_capture_cnh">CNH</string>
<string name="certta_smart_capture_rg">RG</string>
<string name="certta_smart_capture_cin">CIN</string>
<string name="certta_smart_capture_rnm">RNM</string>
<string name="certta_smart_capture_rne">RNE</string>
<string name="certta_smart_capture_ctps">CTPS</string>
<string name="certta_smart_capture_crlv">CRLV</string>
<string name="certta_smart_capture_passport">Passaporte</string>
<string name="certta_smart_capture_any_document">Qualquer documento</string>
```

#### Rótulos de acessibilidade dos documentos

```xml
<string name="certta_smart_capture_doc_cnh_content_description">Carteira Nacional de Habilitação (CNH)</string>
<string name="certta_smart_capture_doc_cin_content_description">Carteira de Identidade Nacional (CIN)</string>
<string name="certta_smart_capture_doc_rg_content_description">Carteira de Identidade do Registro Geral (RG)</string>
<string name="certta_smart_capture_doc_rnm_content_description">Registro Nacional Migratório (RNM)</string>
<string name="certta_smart_capture_doc_ctps_content_description">Carteira de Trabalho e Previdência Social (CTPS)</string>
<string name="certta_smart_capture_doc_crlv_content_description">Certificado de Registro e Licenciamento de Veículo (CRLV)</string>
<string name="certta_smart_capture_doc_rne_content_description">Registro Nacional de Estrangeiro (RNE)</string>
```

#### Pré-visualização da captura

```xml
<string name="certta_smart_capture_preview_title">Confira sua foto</string>
<string name="certta_smart_capture_preview_hint">"Verifique se está nítida e sem reflexos. "</string>
<string name="certta_smart_capture_preview_take_picture_again">Fotografar novamente</string>
<string name="certta_smart_capture_preview_send_picture">Enviar captura</string>
```

#### Carrossel de instruções — compartilhado

```xml
<string name="certta_smart_capture_instructions_title">Prepare seu documento</string>
<string name="certta_smart_capture_instructions_description">Leva menos de 1 minuto.</string>
<string name="certta_smart_capture_instructions_skip_tips">Pular dicas</string>
<string name="certta_smart_capture_instructions_next_tips">Próxima dica</string>
<string name="certta_smart_capture_instructions_tab_content_description">Dica %1$d de %2$d</string>
<plurals name="certta_smart_capture_instructions_accepted_documents_format">
    <item quantity="one">%2$s é aceito</item>
    <item quantity="other">%s e %s são aceitos</item>
</plurals>
```

#### Carrossel de instruções — modo de captura

```xml
<string name="certta_smart_capture_instructions_capture_1_title">Comece por qualquer lado</string>
<string name="certta_smart_capture_instructions_capture_1_description">Frente, verso ou documento aberto. Identificamos o lado automaticamente.</string>
<string name="certta_smart_capture_instructions_capture_2_title">Mantenha as bordas visíveis</string>
<string name="certta_smart_capture_instructions_capture_2_description">Enquadre os quatro cantos do documento e evite inclinar o telefone.</string>
<string name="certta_smart_capture_instructions_capture_3_title">Garanta nitidez</string>
<string name="certta_smart_capture_instructions_capture_3_description">Evite reflexos e sombras. Dados legíveis aceleram sua aprovação.</string>
```

#### Carrossel de instruções — modo de upload

```xml
<string name="certta_smart_capture_instructions_upload_1_title">Envie imagem ou PDF</string>
<string name="certta_smart_capture_instructions_upload_1_description">Envie fotos da sua galeria ou arquivos digitais salvos no seu dispositivo.</string>
<string name="certta_smart_capture_instructions_upload_2_title">Envie um ou dois arquivos</string>
<string name="certta_smart_capture_instructions_upload_2_description">Envie o documento completo ou selecione a frente e o verso de uma vez.</string>
```

#### Seleção do método de validação

```xml
<string name="certta_smart_capture_select_validation_type_title">Escolha como validar seu documento</string>
<string name="certta_smart_capture_select_validation_type_upload_title">Anexar documento</string>
<string name="certta_smart_capture_select_validation_type_upload_description">Envie os arquivos do documento que você tem no seu dispositivo</string>
<string name="certta_smart_capture_select_validation_type_capture_title">Tirar foto</string>
<string name="certta_smart_capture_select_validation_type_capture_description">Fotografe seu documento agora</string>
<string name="certta_smart_capture_validation_type_toolbar_navigate_up">Navegar para cima</string>
```

#### Folha de ajuda da câmera

```xml
<string name="certta_smart_capture_camera_help_title">Precisa de ajuda?</string>
<string name="certta_smart_capture_camera_help_instruction_title_1">Enquadre as bordas</string>
<string name="certta_smart_capture_camera_help_instruction_description_1">Não deixe o documento sair da tela.</string>
<string name="certta_smart_capture_camera_help_instruction_title_2">Evite reflexos</string>
<string name="certta_smart_capture_camera_help_instruction_description_2">Procure um local com luz indireta.</string>
<string name="certta_smart_capture_camera_help_instruction_title_3">Dados legíveis</string>
<string name="certta_smart_capture_camera_help_instruction_description_3">Certifique-se de que os dados estejam legíveis.</string>
<string name="certta_smart_capture_camera_help_instruction_hint">Ou, se preferir, anexe o arquivo do documento.</string>
<string name="certta_smart_capture_camera_help_confirm_button">Continue tirando fotos</string>
```

#### Tela de permissão negada

```xml
<string name="certta_smart_capture_permission_denied_title">É necessário acesso à câmera.</string>
<string name="certta_smart_capture_permission_denied_description">Para continuar, você precisa permitir o acesso manualmente nas configurações do seu telefone.</string>
<string name="certta_smart_capture_permission_denied_instructions"><![CDATA[1. Toque no botão <b>Abrir configurações</b> abaixo para abrir as Configurações.<br>2. Na tela que abrir, toque em <b>Permissões</b>.<br>3. Selecione <b>Câmera</b>, escolha <b>Permitir somente enquanto usa o app</b> e volte para o app.]]></string>
<string name="certta_smart_capture_permission_denied_instructions_title">Passo a passo</string>
<string name="certta_smart_capture_permission_denied_instructions_config_button">Abrir configurações</string>
```

#### Tela de revisão do upload

```xml
<string name="certta_smart_capture_upload_title">Confira seu documento</string>
<string name="certta_smart_capture_upload_first_file_title">Primeiro arquivo</string>
<string name="certta_smart_capture_upload_second_file_title">Segundo arquivo (opcional)</string>
<string name="certta_smart_capture_upload_attach">Anexar documento</string>
<string name="certta_smart_capture_upload_none_document_attached">Nenhum documento anexado</string>
<string name="certta_smart_capture_upload_document_hint">Anexe um arquivo com o documento completo ou dois arquivos com a frente e o verso.</string>
<string name="certta_smart_capture_upload_document_send_doc">Enviar documento</string>
<string name="certta_smart_capture_upload_add_back_to_complete"><![CDATA[Adicione o <b>verso do {doc}</b> para concluir o upload.]]></string>
<string name="certta_smart_capture_upload_add_front_to_complete"><![CDATA[Adicione a <b>frente do {doc}</b> para concluir o upload.]]></string>
<string name="certta_smart_capture_upload_eye_content_description">Visualizar %s</string>
<string name="certta_smart_capture_upload_remove_content_description">Excluir %s</string>
```

#### Folha de exclusão de arquivo

```xml
<string name="certta_smart_capture_upload_remove_confirmation_title">Deseja excluir o arquivo?</string>
<string name="certta_smart_capture_upload_remove_confirmation_message">Se você confirmar a exclusão, precisará adicionar um arquivo novamente. Tem certeza?</string>
<string name="certta_smart_capture_upload_remove_confirmation_delete">Excluir arquivo</string>
<string name="certta_smart_capture_upload_remove_confirmation_keep">Manter arquivo</string>
```

#### Alertas de validação do upload

```xml
<string name="certta_smart_capture_upload_files_limit_error_title">Limite de arquivos</string>
<string name="certta_smart_capture_upload_files_limit_error_message">Selecione no máximo 2 arquivos.</string>
<string name="certta_smart_capture_upload_files_limit_error_confirm_button">Entendi</string>
<string name="certta_smart_capture_upload_file_size_error">Use arquivos com no máximo 10 MB.</string>
<string name="certta_smart_capture_upload_preview_error">Não foi possível abrir a pré-visualização do arquivo. Tente novamente.</string>
<string name="certta_smart_capture_upload_generic_error">Não foi possível validar seu documento. Tente novamente.</string>
<string name="certta_smart_capture_upload_first_file_format_error"><![CDATA[<b>Primeiro arquivo</b>: ]]></string>
<string name="certta_smart_capture_upload_second_file_format_error"><![CDATA[<b>Segundo arquivo</b>: ]]></string>
```

#### Tela de sucesso

```xml
<string name="certta_smart_capture_success_title">Tudo pronto!</string>
<string name="certta_smart_capture_success_description_text">"Você concluiu todas as etapas com sucesso!"</string>
```

#### Compartilhado / genérico

```xml
<string name="certta_smart_capture_close_button">Fechar</string>
<string name="certta_smart_capture_continue_text">Continuar</string
```

{% endtab %}

{% tab title="iOS" %}

## Visão geral

As strings que o fluxo Smart Capture renderiza — instruções, botões, mensagens de erro e a maioria dos rótulos do VoiceOver — podem ser substituídas pela sua própria redação, sem fazer fork do SDK.

Você fornece uma `.strings` tabela no target do app iOS e informa ao SDK o nome dela via TypeScript. Você inclui apenas as chaves que realmente quer alterar; todo o resto mantém a tradução do próprio SDK.

Dois trechos de texto ficam fora dessa tabela: as abreviações dos tipos de documento (RG, CNH, RNE, CTPS, CRLV) e a tela de permissão negada da câmera, que é compartilhada com outros produtos CAF. Nenhum dos dois pode ser alterado por meio de `customLocalization`.

### API

O React Native expõe um único campo opcional em `CerttaSmartCaptureConfiguration`:

| Parâmetro            | Tipo     | Padrão | Descrição                                                                                                               |
| -------------------- | -------- | ------ | ----------------------------------------------------------------------------------------------------------------------- |
| `customLocalization` | `string` | `null` | Nome da sua `.strings` tabela — o nome do arquivo sem a extensão. Carregada do bundle principal do app (`Bundle.main`). |

Quando `customLocalization` é omitido, o SDK usa suas próprias strings.

```typescript
import {
  CerttaAcceptedDocumentType,
  type CerttaSmartCaptureConfiguration,
} from '@caf.io/react-native-sdk';

const config: CerttaSmartCaptureConfiguration = {
  acceptedDocuments: [
    CerttaAcceptedDocumentType.IDENTITY_CARD,
    CerttaAcceptedDocumentType.DRIVER_LICENSE,
  ],
  customLocalization: 'MySmartCapture',
};

await open(config);
```

### Adicionando sua tabela de strings

1. Crie um `.strings` arquivo no target do app iOS — por exemplo `MySmartCapture.strings` — e coloque-o no `<language>.lproj/` diretório de cada localidade que você oferece suporte (`ios/<App>/en.lproj/`, `ios/<App>/pt-BR.lproj/`, …).
2. Adicione apenas as chaves que você quer substituir. As chaves omitidas não são um erro e não exibem uma chave bruta na tela.
3. Passe o nome do arquivo sem a extensão como `customLocalization`.

```
/* ios/<App>/en.lproj/MySmartCapture.strings */
"smart_capture.instructions.title" = "Deixe seu documento de identidade pronto";
"smart_capture.instructions.capture.cta" = "Abrir câmera";
```

Todo o restante na tela de instruções mantém a redação do próprio SDK.

### Ordem de resolução

Para cada chave, o SDK resolve nesta ordem:

1. Sua `customLocalization` tabela no bundle principal do app.
2. A tabela própria do SDK para o idioma do dispositivo.
3. O valor padrão compilado no SDK, que é o português brasileiro.

Tabelas parciais são suportadas e recomendadas. Informar um nome de tabela que não exista também é seguro — cada chave volta para o texto do próprio SDK.

O SDK oferece inglês, espanhol e português brasileiro. Em um dispositivo cujos idiomas preferidos não incluam nenhum desses, o texto do SDK é exibido em português brasileiro.

### Localização

O SDK resolve strings por meio da busca padrão do iOS, então o idioma exibido segue os idiomas preferidos do usuário conforme negociado com as localizações declaradas pelo seu app — o Smart Capture não expõe um alternador de idioma próprio.

Sua tabela personalizada é resolvida por localidade exatamente da mesma forma: uma chave é lida do `<language>.lproj/` diretório que corresponde ao idioma resolvido, com fallback para a região de desenvolvimento da sua tabela e, depois, para o texto do próprio SDK.

#### Adicionando um idioma que o SDK não oferece

Crie o `.lproj` diretório para esse idioma no app iOS, adicione sua tabela ali e garanta que o idioma esteja listado nas localizações do app. As chaves omitidas voltam para o português brasileiro, então traduza todas as chaves que o usuário verá.

```
/* ios/<App>/fr.lproj/MySmartCapture.strings */
"smart_capture.instructions.title" = "Prepare seu documento";
```

#### Substituindo um idioma que o SDK já oferece

Não há como remover uma tradução embutida. Para alterar a redação de um idioma já incluído, substitua as chaves dessa localidade na sua própria tabela.

### Especificadores de formato

Alguns valores contêm especificadores de formato como `%@`, `%d`, ou `%1$d`. Sua substituição deve manter os mesmos especificadores. Eliminá-los ou reordená-los sem sintaxe posicional produz saída incorreta.

`.stringsdict` as regras de plural não são consultadas. As variações de plural devem ser tratadas pelas chaves listadas abaixo.

### Mensagens de tipo de arquivo para upload

| Chave                                                        | Usado quando                                                                      |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| `smart_capture.upload.file_invalid_extension.message`        | `allowedUploadTypes` não está definido, vazio ou lista todos os cinco formatos.   |
| `smart_capture.upload.file_invalid_extension.message_format` | `allowedUploadTypes` restringe o conjunto; `%@` recebe a lista de extensões.      |
| `smart_capture.list.or`                                      | Conectivo disjuntivo usado para unir a lista (e as listas de tipos de documento). |

### Referência de chaves

Todas as chaves têm o prefixo `smart_capture.` para evitar conflitos. Os valores mostrados são os padrões em inglês.

Um arquivo pronto para copiar `.strings` é publicado junto com o SDK nativo: [SmartCapture/SmartCaptureLocalizable.strings](https://github.com/combateafraude/caf-ios-sdk/blob/main/SmartCapture/SmartCaptureLocalizable.strings)Comece a partir dele e depois apague as chaves que você não pretende substituir.

####

#### Instruções de captura

```
"smart_capture.instruction.center_document" = "Centralize o documento";
"smart_capture.instruction.scan_document" = "Escaneie seu documento";
"smart_capture.instruction.move_closer" = "Aproxime-se";
"smart_capture.instruction.move_away" = "Afaste-se um pouco";
"smart_capture.instruction.keep_phone_still" = "Capturando... Fique imóvel";
"smart_capture.instruction.manual_capture_available" = "Ou toque no botão para capturar";
"smart_capture.instruction.turn_document_back" = "Vire o documento";
"smart_capture.instruction.capture_retry" = "Não foi possível capturar. Tente novamente.";
"smart_capture.instruction.uploading_document" = "Enviando documento...";
"smart_capture.instruction.document_validated_success" = "Documento validado com sucesso";
```

#### Mensagens de documento inválido

```
"smart_capture.invalid_document.generic" = "Documento não aceito. Tente novamente.";
"smart_capture.invalid_document.single_allowed" = "Use %@";
"smart_capture.invalid_document.multiple_allowed" = "Use %@";
"smart_capture.invalid_document.recapture_expected_back" = "Capture o verso do %@.";
"smart_capture.invalid_document.recapture_expected_front" = "Capture a frente do %@.";
```

#### Nomes dos tipos de documento

```
"smart_capture.document.any" = "Qualquer documento";
"smart_capture.document.passport" = "Passaporte";
```

Os outros tipos de documento são exibidos pelas siglas brasileiras — RG, CNH, RNE, CTPS e CRLV — que não podem ser personalizadas. Os nomes no VoiceOver ficam em Acessibilidade — nomes dos documentos.

#### Pré-visualização da captura

```
"smart_capture.preview.title" = "Confira sua foto";
"smart_capture.preview.description" = "Confira se está nítida e sem reflexos.";
"smart_capture.preview.retake" = "Tirar foto novamente";
"smart_capture.preview.confirm" = "Enviar captura";
```

#### Carrossel de instruções — compartilhado

```
"smart_capture.instructions.title" = "Prepare seu documento";
"smart_capture.instructions.subtitle" = "Leva menos de 1 minuto.";
"smart_capture.instructions.accepted_docs_format" = "São aceitos %@";
"smart_capture.instructions.accepted_docs_single_format" = "É aceito %@";
"smart_capture.instructions.skip_tips" = "Pular dicas";
"smart_capture.instructions.next_tip" = "Próxima dica";
"smart_capture.list.or" = "ou";
```

#### Carrossel de instruções — modo de captura

```
"smart_capture.instructions.capture.page1.title" = "Comece por qualquer lado";
"smart_capture.instructions.capture.page1.description" = "Frente, verso ou documento aberto. Identificamos o lado automaticamente.";
"smart_capture.instructions.capture.page2.title" = "Mantenha as bordas visíveis";
"smart_capture.instructions.capture.page2.description" = "Enquadre os quatro cantos do documento e evite inclinar o celular.";
"smart_capture.instructions.capture.page3.title" = "Garanta nitidez";
"smart_capture.instructions.capture.page3.description" = "Evite reflexos e sombras. Dados legíveis agilizam sua aprovação.";
"smart_capture.instructions.capture.cta" = "Tirar foto";
```

#### Carrossel de instruções — modo de upload

```
"smart_capture.instructions.upload.page1.title" = "Envie imagem ou PDF";
"smart_capture.instructions.upload.page1.description" = "Você pode enviar fotos da galeria ou arquivos PDF.";
"smart_capture.instructions.upload.page2.title" = "Envie um ou mais arquivos";
"smart_capture.instructions.upload.page2.description" = "Envie o documento completo ou selecione a frente e o verso de uma vez.";
"smart_capture.instructions.upload.cta" = "Anexar documento";
```

#### Seleção do método de validação

```
"smart_capture.validation_method.title" = "Escolha como validar seu documento";
"smart_capture.validation_method.take_photo" = "Tirar foto";
"smart_capture.validation_method.take_photo.subtitle" = "Fotografe seu documento agora";
"smart_capture.validation_method.attach_document" = "Anexar documento";
"smart_capture.validation_method.attach_document.subtitle" = "Envie os arquivos do documento que você tem no seu dispositivo";
```

#### Seleção da origem do upload

```
"smart_capture.upload.source_selection.title" = "Selecione de onde escolher o documento";
"smart_capture.upload.source_selection.documents" = "Arquivos";
"smart_capture.upload.source_selection.gallery" = "Galeria";
"smart_capture.upload.source_selection.cancel" = "Cancelar";
```

#### Folha de ajuda da câmera

```
"smart_capture.camera.help.sheet_title" = "Precisa de ajuda?";
"smart_capture.camera.help.tip1_title" = "Enquadre as bordas";
"smart_capture.camera.help.tip1_description" = "Não deixe o documento sair da tela.";
"smart_capture.camera.help.tip2_title" = "Evite reflexos";
"smart_capture.camera.help.tip2_description" = "Encontre um local com iluminação indireta.";
"smart_capture.camera.help.tip3_title" = "Dados legíveis";
"smart_capture.camera.help.tip3_description" = "Certifique-se de que os dados estejam legíveis.";
"smart_capture.camera.help.footer" = "Ou, se preferir, anexe o arquivo do documento.";
"smart_capture.camera.help.continue_button" = "Continuar tirando foto";
"smart_capture.camera.help.attach_button" = "Anexar documento";
```

#### Tela de revisão do upload

```
"smart_capture.upload.review.title" = "Confira seu documento";
"smart_capture.upload.review.title.complete" = "Complete seu documento";
"smart_capture.upload.review.empty.title" = "Nenhum documento anexado";
"smart_capture.upload.review.empty.description" = "Anexe um arquivo com o documento completo ou dois arquivos (frente e verso).";
"smart_capture.upload.review.first_file" = "Primeiro arquivo";
"smart_capture.upload.review.second_file" = "Segundo arquivo (opcional)";
"smart_capture.upload.review.attach" = "Anexar documento";
"smart_capture.upload.review.side.front" = "Frente";
"smart_capture.upload.review.side.back" = "Verso";
"smart_capture.upload.review.send" = "Enviar documento";
"smart_capture.upload.review.warning.format" = "Adicione %@ para concluir o envio.";
"smart_capture.upload.review.warning.back_of_format" = "o verso do %@";
"smart_capture.upload.review.warning.back_of_format_masculine" = "o verso do %@";
"smart_capture.upload.review.warning.front_of_format" = "a frente do %@";
"smart_capture.upload.review.warning.front_of_format_masculine" = "a frente do %@";
"smart_capture.upload.review.first_file_prefix" = "Primeiro arquivo: ";
"smart_capture.upload.review.second_file_prefix" = "Segundo arquivo: ";
"smart_capture.upload.review.file_invalid" = "Não foi possível validar este arquivo. Anexe outro documento.";
```

#### Folha de exclusão de arquivo

```
"smart_capture.upload.review.delete.title" = "Excluir arquivo?";
"smart_capture.upload.review.delete.description" = "Se você confirmar a exclusão, será necessário anexar um arquivo novamente. Tem certeza?";
"smart_capture.upload.review.delete.confirm" = "Excluir arquivo";
"smart_capture.upload.review.delete.cancel" = "Manter arquivo";
```

#### Alertas de validação do upload

```
"smart_capture.upload.max_files.alert.title" = "Limite de arquivos";
"smart_capture.upload.max_files.alert.message_format" = "Selecione no máximo %d arquivos.";
"smart_capture.upload.max_files.alert.message_singular" = "Selecione no máximo 1 arquivo.";
"smart_capture.upload.max_files.alert.ok" = "Entendi";
"smart_capture.upload.file_too_large.message" = "Use arquivos com no máximo 10 MB.";
"smart_capture.upload.file_invalid_extension.message" = "Use as extensões: png, jpeg, heif, heic ou pdf.";
"smart_capture.upload.file_invalid_extension.message_format" = "Use as extensões: %@.";
```

#### Falha no envio do upload

```
"smart_capture.upload.send_error.title" = "Algo deu errado";
"smart_capture.upload.send_error.description" = "Algo deu errado ao enviar seu documento. Tente anexá-lo novamente.";
"smart_capture.upload.send_error.retry" = "Tentar novamente";
```

#### Acessibilidade — captura e pré-visualização

```
"smart_capture.accessibility.announcement.photo_captured" = "Foto capturada";
"smart_capture.accessibility.camera.screen" = "Tela de captura de documento";
"smart_capture.accessibility.close_button.label" = "Fechar";
"smart_capture.accessibility.close_button.hint" = "Fecha a tela de captura";
"smart_capture.accessibility.error_banner_close_button.hint" = "Oculta apenas a mensagem de erro";
"smart_capture.accessibility.capture_button.label" = "Capturar foto";
"smart_capture.accessibility.capture_button.hint" = "Captura a imagem do documento";
"smart_capture.accessibility.preview.screen" = "Tela de pré-visualização do documento";
"smart_capture.accessibility.preview.image.label" = "Pré-visualização do documento capturado";
"smart_capture.accessibility.preview.back_button.label" = "Voltar";
"smart_capture.accessibility.help_button.label" = "Ajuda";
"smart_capture.accessibility.help_button.hint" = "Abre dicas para capturar o documento";
"smart_capture.accessibility.camera.help.tip_position_format" = "Dica %1$d de %2$d";
```

#### Acessibilidade — instruções e método de validação

```
"smart_capture.accessibility.instructions.screen" = "Tela de instruções de captura de documento";
"smart_capture.accessibility.instructions.back_button.label" = "Voltar";
"smart_capture.accessibility.instructions.back_button.hint" = "Retorna à tela anterior";
"%@. %@. Dica %d de %d.";
"smart_capture.accessibility.instructions.carousel.hint" = "Deslize para cima ou para baixo para ver as outras dicas";
"smart_capture.accessibility.instructions.skip_tips.hint" = "Pula as dicas e vai direto para a ação";
"smart_capture.accessibility.instructions.next_tip.hint" = "Avança para a próxima dica";
"smart_capture.accessibility.validation_method.screen" = "Tela de seleção do método de validação";
```

#### Acessibilidade — upload

```
"smart_capture.accessibility.upload.review.back_button.label" = "Voltar";
"smart_capture.accessibility.upload.review.back_button.hint" = "Retorna à tela anterior";
"smart_capture.accessibility.upload.review.send_button.hint" = "Envia os arquivos de documento anexados para validação";
"smart_capture.accessibility.upload.slot.preview_button.label" = "Pré-visualizar";
"smart_capture.accessibility.upload.slot.preview_button.hint" = "Abre uma pré-visualização em tela cheia deste arquivo";
"smart_capture.accessibility.upload.slot.delete_button.label" = "Excluir";
"smart_capture.accessibility.upload.slot.delete_button.hint" = "Remove este arquivo do envio";
"smart_capture.accessibility.upload.slot.empty.hint" = "Abre o seletor de arquivos para escolher um documento";
"smart_capture.accessibility.upload.slot.sent_state" = "enviado, não editável";
"smart_capture.accessibility.upload.slot.preview_button_format" = "Pré-visualizar %@";
"smart_capture.accessibility.upload.slot.delete_button_format" = "Excluir %@";
"smart_capture.accessibility.upload.failure.back_button.label" = "Voltar";
"smart_capture.accessibility.upload.failure.back_button.hint" = "Cancela o upload e retorna à tela anterior";
"smart_capture.accessibility.upload.failure.retry_button.hint" = "Tenta enviar o documento novamente";
"smart_capture.accessibility.upload.preview.close_button.label" = "Fechar";
"smart_capture.accessibility.upload.preview.close_button.hint" = "Fecha a pré-visualização do arquivo";
"smart_capture.accessibility.upload.preview.image_label_format" = "Pré-visualização de %@";
"smart_capture.accessibility.upload.preview.pdf_label_singular_format" = "Pré-visualização de %@, PDF, 1 página";
"smart_capture.accessibility.upload.preview.pdf_label_plural_format" = "Pré-visualização de %@, PDF, %d páginas";
```

#### Acessibilidade — nomes dos documentos

```
"smart_capture.accessibility.warning.prefix" = "Aviso";
"smart_capture.accessibility.error.prefix" = "Erro";
"smart_capture.accessibility.send_button.disabled_value" = "Desativado. Anexe os arquivos ausentes para enviar.";
"smart_capture.accessibility.document.identity_card" = "Carteira de Identidade (RG)";
"smart_capture.accessibility.document.driver_license" = "Carteira Nacional de Habilitação (CNH)";
"smart_capture.accessibility.document.residence_identity_card" = "Registro Nacional de Estrangeiro (RNE)";
"smart_capture.accessibility.document.employment_card" = "Carteira de Trabalho e Previdência Social (CTPS)";
"smart_capture.accessibility.document.vehicle_license" = "Certificado de Registro e Licenciamento de Veículo (CRLV)";
```

{% endtab %}
{% endtabs %}

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/captura-inteligente-de-documentos/personalizacao-de-texto.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
