> ## 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 credenciais do BCB, intervalo de polling, retenção, notificações por webhook e o provedor de IA para o BC Correios.

A página **Configurações** é onde um administrador define 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 Configurações

***

Abra **Reporter** > **BC Correios** > **Configurações** no menu lateral esquerdo.

<Note>
  Visualizar 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 Sisbacen usadas para acessar a caixa de correio do BC Correio.

* **Usuário BCB** — seu usuário Sisbacen.
* **Senha BCB** — sua senha Sisbacen.

Um badge mostra se as credenciais estão **Configurado** ou **Não configurado**. Por segurança, segredos armazenados nunca são exibidos de volta — deixe um campo em branco para manter o valor existente.

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

## Polling

***

Controla com que frequência o BC Correios busca novas correspondências no BCB.

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

## Retenção

***

O período mínimo pelo qual a correspondência é mantida.

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

<Note>
  A retenção impõe o mínimo regulatório. É por isso que o BC Correios não tem exclusão disponível ao usuário — veja [pastas de correspondência](/pt/lerian-console/reporter-console/bc-correios-folders).
</Note>

## Webhook

***

Notificação de saída opcional quando uma nova correspondência é recebida.

* **URL do Webhook** — o endpoint a ser notificado.
* **Segredo HMAC** — usado para assinar os payloads do webhook para que seu receptor possa verificar a autenticidade.

Um badge mostra se o webhook está **Ativado** ou **Desativado** com base na definição de uma URL.

## Provedor de IA

***

Análise automática opcional da correspondência regulatória, em regime **bring-your-own-key**. Quando configurada, os resumos aparecem no painel de insight de IA do [detalhe da correspondência](/pt/lerian-console/reporter-console/bc-correios-inbox#detalhe-da-correspondência).

| Campo                      | Descrição                                                                |
| :------------------------- | :----------------------------------------------------------------------- |
| **Provedor de IA**         | Nenhum, OpenAI, Anthropic ou Google Gemini.                              |
| **Chave de API**           | A chave de API do seu provedor.                                          |
| **Modelo**                 | O modelo a ser usado (por exemplo `gpt-4o-mini`).                        |
| **Endpoint personalizado** | Endpoint customizado opcional, para provedores self-hosted ou via proxy. |
| **System prompt**          | Instruções opcionais que moldam a análise da IA.                         |

Use **Testar conexão** para verificar a configuração de IA antes de salvar; em caso de sucesso, a latência da resposta é informada.

## 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 que você alterou e mostra uma confirmação quando o salvamento é bem-sucedido.

<Note>
  As alterações de configuração são registradas na trilha de [Auditoria](/pt/lerian-console/reporter-console/bc-correios-audit) como eventos `Settings updated` e `BCB connection tested`.
</Note>