> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurações

> Configure as credenciais do BCB, o intervalo de polling, a retenção, as notificações por webhook e o provedor de IA do BC Correios no Reporter Console.

A página **Configurações** é onde um administrador configura como o BC Correios se conecta ao Banco Central do Brasil (BCB) e como ele processa a correspondência. Ela agrupa a configuração em seções recolhíveis: credenciais do BCB, polling, retenção, webhook e IA.

## Acessando as Configurações

***

Abra **Reporter** > **BC Correios** > **Configurações** no menu lateral esquerdo. O título da tela é **Settings**.

<Note>
  Ver Configurações exige a permissão `settings:get`. Salvar alterações e testar conexões exigem permissões de escrita (`settings:patch` / `settings:post`). Com acesso somente leitura, você vê a configuração atual com um banner de somente leitura.
</Note>

## Credenciais do BCB

***

As credenciais do Sisbacen usadas para acessar a caixa de correspondência do BC Correio.

* **Nome de usuário do BCB**: seu nome de usuário do Sisbacen.
* **Senha do BCB**: sua senha do Sisbacen.

Um selo mostra se as credenciais estão **Configuradas** ou **Não configuradas**. Por segurança, os segredos armazenados nunca são mostrados de volta. Deixe um campo em branco para manter o valor atual.

<Warning>
  Sem credenciais válidas do BCB, o BC Correios não pode sincronizar a correspondência. Se o status de sincronização do [Dashboard](/pt/rails/bc-correios/console/bc-correios-dashboard) mostrar as credenciais como inválidas, atualize-as aqui primeiro.
</Warning>

## Polling

***

Controla a frequência com que o BC Correios busca nova correspondência do BCB.

* **Intervalo de sincronização**: escolha 5, 15, 30 ou 60 minutos.

## Retenção

***

O período mínimo para manter a correspondência.

* **Dias de retenção**: mínimo de 5 anos (1.825 dias), máximo de 100 anos. O equivalente em anos aparece ao lado do campo.

<Note>
  A retenção aplica o mínimo regulatório. Por isso o BC Correios não tem exclusão disponível para o usuário. Veja [pastas de correspondência](/pt/rails/bc-correios/console/bc-correios-folders).
</Note>

## Webhook

***

Notificação de saída opcional quando nova correspondência chega.

* **URL do webhook**: o endpoint a notificar.
* **Segredo HMAC**: usado para assinar os payloads do webhook, para que seu receptor possa verificar a autenticidade.

Um selo mostra se o webhook está **Habilitado** ou **Desabilitado**, dependendo da existência de uma URL.

## Provedor de IA

***

Análise automática opcional de correspondência regulatória, no modelo **bring-your-own-key**. Quando configurado, os resumos aparecem no painel **Análise de IA** do [detalhe da correspondência](/pt/rails/bc-correios/console/bc-correios-inbox#mail-detail).

| Campo                      | Descrição                                                                      |
| :------------------------- | :----------------------------------------------------------------------------- |
| **Provedor de IA**         | Nenhum, OpenAI, Anthropic ou Google Gemini.                                    |
| **Chave de API**           | Sua chave de API do provedor.                                                  |
| **Modelo**                 | O modelo a usar (por exemplo, `gpt-4o-mini`).                                  |
| **Endpoint personalizado** | Endpoint personalizado opcional, para provedores auto-hospedados ou com proxy. |
| **Prompt do sistema**      | Instruções opcionais que moldam a análise de IA.                               |

Use **Testar conexão** para verificar a configuração de IA antes de salvar. Em caso de sucesso, o teste informa a latência da resposta.

## Salvando alterações

***

Quando você edita qualquer campo, uma barra de salvamento aparece com as ações **Descartar** e **Salvar**. O BC Correios envia apenas os campos alterados, e mostra uma confirmação quando o salvamento é concluído com sucesso.

<Note>
  As alterações de configuração são registradas na [Trilha de Auditoria](/pt/rails/bc-correios/console/bc-correios-audit) como eventos `Updated settings` e `Tested BCB connection`.
</Note>