Pular para o conteúdo principal
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.
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.

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.
Sem credenciais válidas do BCB, o BC Correios não consegue sincronizar a correspondência. Se o status de sincronização do Painel mostrar as credenciais como inválidas, atualize-as aqui primeiro.

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.
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.

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.
CampoDescrição
Provedor de IANenhum, OpenAI, Anthropic ou Google Gemini.
Chave de APIA chave de API do seu provedor.
ModeloO modelo a ser usado (por exemplo gpt-4o-mini).
Endpoint personalizadoEndpoint customizado opcional, para provedores self-hosted ou via proxy.
System promptInstruçõ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.
As alterações de configuração são registradas na trilha de Auditoria como eventos Settings updated e BCB connection tested.