Artigos sobre a Rota Nacional

Como exigir privacidade em todas as chaves da organização

Fri, 30 Oct 2026 13:49:50 GMT

# Como exigir privacidade em todas as chaves da organização

A organização pode exigir a barreira de privacidade na RN. Entenda o bloqueio da API nativa, o erro 403 e o caminho protegido para o chat.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Quando o consentimento da chave não basta

Uma equipe pode precisar que os dados pessoais sejam tratados antes de chegar a um modelo externo. O aceite de envio de uma conexão não deve remover essa exigência. A RN permite registrar a obrigação na configuração da organização.

A escolha vale para as chaves e os domínios de inferência daquela organização. Ela não altera a configuração de outras empresas. Exigir a barreira também não ativa a gravação de conversas: tratamento antes do envio e armazenamento são escolhas distintas.

## Ative a exigência nas configurações

Selecione a organização no painel. Abra Configurações e depois Inferência e privacidade. Em Barreira de privacidade, use Editar, escolha Exigir barreira e salve. A alteração exige uma sessão de dono ou administrador da organização.

Na API de gestão, o campo é policy.privacy_barrier_required. A gravação envia a versão lida para impedir que uma edição antiga sobrescreva outra. Omitir o campo mantém o valor anterior; não funciona como uma autorização implícita para desligar a proteção.

## O que muda para quem integra

Com a exigência ligada, /v1/providers/* retorna 403 com o código organization_privacy_barrier_required antes de processar o corpo ou enviá-lo ao provedor. O sistema recusa também arquivos, lotes e streaming nesse caminho. Ele não tenta transformar um formato nativo que a barreira não sabe proteger.

Use /v1/chat/completions com um modelo rota/* e a política placeholder, redact ou block. O modo monitor também recebe 403, pois conserva o conteúdo original. Se a aplicação usa um pool fornecido por outra organização, a exigência daquele pool também vale. Cabeçalho, prompt e consentimento da chave não removem essa condição.

## Perguntas frequentes

A barreira modifica o corpo da API nativa?

Não. Quando a organização exige a barreira, a API nativa é recusada. O tratamento ocorre no caminho de chat protegido, com o catálogo rota/*.

Ativar isso muda a privacidade de outras organizações?

A alteração fica na organização escolhida. A exigência só alcança outra organização quando ela usa o pool fornecido por quem a impôs.

- [Contrato atual da API da RN](https://rota-nacional.ia.br/openapi.json) - [Tecnologia e limites da privacidade](https://rota-nacional.ia.br/pt/tecnologia/)

[Abrir configurações](https://rota-nacional.ia.br/pt/app/configuracoes/)

[Como exigir privacidade em todas as chaves da organização](https://rota-nacional.ia.br/pt/artigos/barreira-obrigatoria-por-organizacao/)

Anonimização antes da IA: marcadores, remoção ou bloqueio?

Fri, 30 Oct 2026 13:49:50 GMT

# Anonimização antes da IA: marcadores, remoção ou bloqueio?

Compare as políticas de dados pessoais da RN e escolha o tratamento adequado ao seu fluxo. Veja por que monitoramento não significa anonimização.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Reduza os dados enviados ao modelo

Um pedido de resumo ou classificação nem sempre precisa do nome, do telefone ou do documento de uma pessoa. Nas rotas protegidas da RN, a barreira examina o conteúdo antes da chamada ao modelo. Ela combina a detecção de nomes com regras para categorias de dados pessoais.

O objetivo é reduzir a exposição no fluxo de inferência. A detecção tem limites e não equivale a uma garantia de anonimização irreversível. Valide o resultado com exemplos fictícios representativos do seu processo e mantenha os controles de acesso da sua aplicação.

## Escolha o comportamento da organização

- placeholder substitui o dado encontrado por um marcador, como [PESSOA_1] ou [CPF_1], para conservar parte do contexto. - redact remove o valor encontrado. É útil quando a identificação não contribui para a tarefa. - block recusa o pedido com 422 quando a barreira encontra dados pessoais. - monitor registra a detecção, mas conserva o conteúdo. Esse modo não limpa o pedido antes do envio.

## Use o caminho adequado ao conteúdo

O chat protegido usa o catálogo rota/*. O endpoint /v1/privacy/clean trata texto sem chamar um modelo de resposta. Para documentos ou imagens, confira a extração em /v1/privacy/extract e a disponibilidade da capacidade antes do envio. A barreira de texto não enxerga diretamente os pixels de uma imagem nem o áudio.

O gateway /v1/providers/* conserva o formato original e não aplica esse tratamento. Uma organização pode exigir a barreira e recusar esse caminho. A política do pedido só pode endurecer a da organização. Gravar conversas, permitir envio externo e tratar dados pessoais continuam sendo decisões diferentes.

## Perguntas frequentes

Monitor protege o texto enviado ao provedor?

Não. Monitor conserva o conteúdo. Uma organização que exige a barreira precisa usar placeholder, redact ou block no chat protegido.

Posso usar a barreira sem gerar uma resposta de IA?

Sim. /v1/privacy/clean trata texto sem chamar um modelo de resposta. Consulte na API as condições de acesso e pagamento.

- [Tecnologia da Rota Nacional](https://rota-nacional.ia.br/pt/tecnologia/) - [Documentação de privacidade](https://rota-nacional.ia.br/openapi.json)

[Experimentar a barreira](https://rota-nacional.ia.br/pt/app/experimentar/)

[Anonimização antes da IA: marcadores, remoção ou bloqueio?](https://rota-nacional.ia.br/pt/artigos/anonimizar-dados-antes-da-ia/)

Gateway de IA sem trocar o modelo da sua aplicação

Fri, 30 Oct 2026 13:49:50 GMT

# Gateway de IA sem trocar o modelo da sua aplicação

Centralize conexões de IA na RN sem converter o corpo de cada provedor. Entenda o endpoint nativo, o pool autorizado e os limites da migração.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Mude o acesso, preserve o contrato

Uma aplicação que já usa um provedor pode depender de parâmetros que não existem em uma API de chat genérica. No gateway nativo da RN, o caminho /v1/providers/{provider}/ recebe o caminho original da API. O modelo continua no formato esperado pelo provedor.

A aplicação autentica com uma chave RN da organização. O segredo externo fica na conexão do servidor. O gateway conserva corpo, parâmetros, resposta e erro HTTP do provedor. Ele não troca um parâmetro recusado por outro nem muda o modelo para conseguir responder.

## Confira três condições antes da mudança

- A conexão precisa pertencer à organização ou a um fornecedor explicitamente autorizado. - O caminho e o contrato usados pela aplicação precisam estar disponíveis no gateway. Confira arquivos, streaming e respostas assíncronas além do chat. - O envio nativo exige consentimento e não aplica a barreira de conteúdo. Uma exigência de privacidade da organização ou do pool fornecedor recusa o pedido.

## Migre um fluxo por vez

Cadastre a conexão, confira o contrato financeiro e escolha o domínio de inferência. Atualize o endpoint e a credencial da aplicação. Valide um pedido representativo, os erros esperados e os recursos que o fluxo consulta depois. Um chat que respondeu não prova que um lote ou upload também funciona.

Sem X-RN-Connection-Id, a seleção ocorre no pool autorizado. Esse cabeçalho é um identificador de conexão, não uma credencial de acesso. Recursos anteriores conservam a conexão que os criou. O gateway não repete automaticamente uma chamada já enviada: confira o estado antes de tentar de novo.

## Perguntas frequentes

Preciso mandar a chave do provedor na aplicação?

A aplicação usa a chave RN da organização. O segredo do provedor fica cifrado na conexão do servidor.

O gateway nativo anonimiza os pedidos?

Não. Ele conserva o corpo original. Use o chat protegido para aplicar a barreira; se ela for obrigatória, o caminho nativo recebe 403.

- [Índice da API da RN](https://rota-nacional.ia.br/api/) - [OpenAPI do gateway](https://rota-nacional.ia.br/openapi.json)

[Consultar os endpoints](https://rota-nacional.ia.br/pt/docs/)

[Gateway de IA sem trocar o modelo da sua aplicação](https://rota-nacional.ia.br/pt/artigos/gateway-nativo-sem-trocar-modelo/)

Várias chaves de IA com isolamento por organização

Fri, 30 Oct 2026 13:49:50 GMT

# Várias chaves de IA com isolamento por organização

Organize conexões de provedores por empresa. Veja como pausa, pesos, consentimento e vínculo de arquivos evitam misturar o uso de clientes.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Uma conta externa não deve virar acesso compartilhado

Quando várias aplicações usam as mesmas contas de provedores, centralizar as chaves ajuda a administrar o acesso. Isso não autoriza uma empresa a consultar arquivos, lotes ou respostas de outra. A RN vincula conexões à organização e registra os recursos nativos no espaço que os criou.

A chave RN autentica o consumidor. A chave externa pertence à conexão usada pelo servidor. Um identificador de conexão não substitui a autenticação e não permite escolher uma chave de outra organização.

## Gerencie o pool sem alterar os segredos nos projetos

O pool pode conter mais de uma chave do mesmo provedor. A administração permite pausar conexões e definir pesos para a distribuição entre chaves elegíveis. A seleção considera o escopo autorizado; ela não é uma permissão para usar o saldo de qualquer organização.

Ter um cadastro próprio pausado ou revogado não libera automaticamente uma chave de outro pool. A herança precisa de vínculo, contrato e, no modo nativo, dos aceites aplicáveis. Exigir a barreira de privacidade tem prioridade sobre o aceite nativo.

## Preserve o vínculo dos recursos assíncronos

Arquivos, lotes e respostas anteriores continuam ligados à conexão que os criou. Uma consulta posterior não pode escolher outra chave ao acaso. Essa regra importa ao processar documentos, acompanhar um lote ou ler a saída de uma tarefa.

Antes de revogar uma conexão, confira os trabalhos pendentes. Na migração de um recurso antigo, confirme a organização, a conta externa e o vínculo original. Não recrie uma tarefa paga apenas porque a consulta de estado ainda não foi integrada.

## Perguntas frequentes

Posso cadastrar mais de uma chave do mesmo provedor?

Sim. O pool aceita várias conexões, com pausa e peso na distribuição. Elas precisam estar elegíveis para a organização e para o contrato usado.

Trocar o peso move arquivos e lotes antigos?

Não. Recursos anteriores conservam a conexão original. O peso orienta a seleção de novas chamadas elegíveis.

- [Escopo e autenticação da API](https://rota-nacional.ia.br/openapi.json) - [Documentação da Rota Nacional](https://rota-nacional.ia.br/pt/docs/)

[Gerenciar a organização](https://rota-nacional.ia.br/pt/app/configuracoes/)

[Várias chaves de IA com isolamento por organização](https://rota-nacional.ia.br/pt/artigos/chaves-provedores-isoladas-por-organizacao/)

Uma API de IA no domínio da sua organização

Fri, 30 Oct 2026 13:49:50 GMT

# Uma API de IA no domínio da sua organização

Entenda o domínio de inferência white label da RN: marca, verificação do endereço, HTTPS e vínculo com as chaves da organização.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## O endereço faz parte da integração

Uma empresa pode oferecer às suas aplicações um endereço de inferência com a própria marca. Na RN, o domínio virtual fica vinculado à organização. O endpoint mantém o contrato da API, enquanto o nome e a identidade visual vêm da configuração autorizada.

Esse vínculo não cria uma rede de clientes com acesso compartilhado. O domínio de uma organização recusa a chave de outra. A marca também não transfere os segredos dos provedores para o navegador ou para o código público das aplicações.

## Da configuração à ativação

O processo inclui cadastrar o domínio, conferir o destino DNS, vincular o endereço à organização correta e ativar HTTPS. Configure os registros indicados e aguarde a checagem. Não substitua o endpoint em uma aplicação antes de o domínio estar ativo e o certificado funcionar.

O nome, o logo e os dados legais da marca são administrados no espaço da organização. O envio de e-mail tem configuração própria. Ativar a marca não prova que seu remetente está autorizado a enviar e-mail; confira esse estado separadamente.

## Conserve as políticas ao mudar o endereço

Uma chamada pelo domínio personalizado continua sujeita às permissões da organização, à rede permitida, às cotas e ao contrato financeiro. O caminho nativo ainda exige consentimento. Se a organização exige a barreira, mudar o hostname não libera /v1/providers/*.

Antes da virada, valide a chave correta, o caminho que a aplicação usa e a leitura dos recursos anteriores. Mantenha um roteiro de volta para o endpoint anterior. Não publique no material comercial nomes, domínios ou credenciais de clientes sem autorização.

## Perguntas frequentes

Um domínio próprio permite usar a chave de outra empresa?

Não. O domínio está vinculado à organização e a autenticação precisa corresponder a ela.

Marca ativa significa que o e-mail também está ativo?

Não. A marca e o remetente têm estados próprios. O envio depende da configuração e da autorização do endereço de e-mail.

- [Contrato público da RN](https://rota-nacional.ia.br/openapi.json) - [Integrações da Rota Nacional](https://rota-nacional.ia.br/pt/docs/agentes/)

[Abrir sua organização](https://rota-nacional.ia.br/pt/app/configuracoes/)

[Uma API de IA no domínio da sua organização](https://rota-nacional.ia.br/pt/artigos/dominio-proprio-api-ia-whitelabel/)

Como acompanhar custo, limites e recibos de inferência

Fri, 30 Oct 2026 13:49:50 GMT

# Como acompanhar custo, limites e recibos de inferência

Diferencie reserva, uso medido e cobrança. Saiba consultar um recibo da RN, interpretar estados pendentes e evitar repetir uma chamada paga.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Tokens não contam toda a história

Um pedido pode reservar um valor antes da resposta e terminar com um consumo menor. A reserva protege o limite autorizado. A liquidação usa o contrato e o consumo que foi possível medir. Por isso, valor reservado e valor cobrado aparecem como informações diferentes.

Também há diferença entre o custo do provedor e o serviço da RN. Uma chave própria e uma chave fornecida podem seguir contratos distintos. Consulte a tarifa aplicável ao seu caso. Um campo sem informação não representa custo zero.

## Recupere o estado antes de repetir

Quando há reserva no gateway, o cabeçalho X-RN-Inference-Receipt identifica o recibo. A rota /v1/inference/receipts permite consultar os registros autorizados do pagador. O painel também mostra recibos na gestão de inferência.

Uma conexão interrompida não prova que o provedor deixou de executar o pedido. Uso desconhecido pode permanecer pendente para conciliação. Consulte o recibo e o estado do recurso assíncrono antes de enviar o mesmo trabalho outra vez. A RN não repete automaticamente um envio nativo já feito.

## Defina limites em mais de um nível

O limite de saída limita o tamanho da resposta solicitada. As cotas da organização controlam pedidos e tokens no período. Saldo e contrato controlam a autorização financeira. Esses controles se complementam; um não substitui o outro.

Arquivos e operações de leitura não são a mesma coisa que uma nova inferência. Lotes precisam de um contrato que represente seu processamento posterior; uma tarifa por token na criação não mede todo o trabalho do lote. Para investigar um erro, guarde o identificador do pedido e do recibo, sem colocar prompts ou chaves em logs públicos.

## Perguntas frequentes

Reserva e cobrança são o mesmo valor?

Não necessariamente. A reserva cobre o teto autorizado. A liquidação considera o contrato e o uso medido; a diferença pode ser devolvida.

Uma falha de conexão autoriza repetir a chamada?

Não por si só. O provedor pode ter recebido o pedido. Consulte o recibo e o estado do trabalho antes de tentar novamente.

- [Recibos e limites na API](https://rota-nacional.ia.br/openapi.json) - [Preços e acesso](https://rota-nacional.ia.br/api/pricing)

[Consultar meu uso](https://rota-nacional.ia.br/pt/app/uso/)

[Como acompanhar custo, limites e recibos de inferência](https://rota-nacional.ia.br/pt/artigos/recibos-limites-custo-inferencia/)

Teste grátis de IA com e-mail e verificação humana

Fri, 30 Oct 2026 13:49:50 GMT

# Teste grátis de IA com e-mail e verificação humana

Veja como começar na RN, confirmar a conta e usar o teste disponível. Entenda as cotas, a verificação no primeiro uso e a continuidade por crédito.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Comece por uma tarefa pequena

Abra a conversa da RN e escolha uma tarefa que você consiga avaliar: resumir um texto fictício, revisar uma frase ou organizar uma lista. Entre com uma conta de e-mail confirmado ou com o Google. Antes da concessão gratuita, conclua o aceite e a verificação humana.

A checagem acontece no servidor. Ter uma janela aberta ou conhecer o endpoint não concede o benefício. O sistema confere a identidade da sessão, o e-mail confirmado e a resposta da verificação humana.

## O grátis tem limites

Confira os valores atuais em /api/pricing e no painel. O teste da conta nova e uma eventual cota diária são benefícios com regras próprias. O saldo disponível considera reservas de pedidos em andamento. Uma oferta habilitada não significa uso ilimitado nem disponibilidade permanente de todos os provedores.

A concessão inicial é por pessoa. Trocar de organização não cria outra. A cota diária depende da configuração ativa e do teto compartilhado da plataforma. Uma conta que já comprou crédito não precisa de outra concessão para usar seu saldo pago.

## Continue quando o saldo terminar

Se o pedido não couber no saldo ou na cota, a RN informa a condição e oferece a compra de crédito no fluxo. A janela de pagamento abre sobre a tarefa. Depois da confirmação, a pessoa continua sem precisar montar a conversa de novo.

O acesso gratuito do site não transforma toda a API em gratuita. Capacidades pagas e agentes seguem as condições do endpoint usado. Comece pelo recurso disponível e confirme o preço antes de autorizar uma chamada paga.

## Perguntas frequentes

Posso ganhar outro teste criando uma organização?

Não. A concessão inicial é por pessoa. Trocar de organização não renova o benefício.

Preciso confirmar o e-mail para usar o grátis?

Sim. A conta precisa de e-mail confirmado ou acesso pelo Google, além do aceite e da verificação humana exigida para a concessão.

- [Condições atuais do teste](https://rota-nacional.ia.br/api/pricing) - [Conta e concessão na API](https://rota-nacional.ia.br/openapi.json)

[Experimentar uma conversa](https://rota-nacional.ia.br/app/bots/)

[Teste grátis de IA com e-mail e verificação humana](https://rota-nacional.ia.br/pt/artigos/teste-gratis-ia-email-verificado/)

Crédito de IA por Pix: como continuar depois do teste

Fri, 30 Oct 2026 13:49:50 GMT

# Crédito de IA por Pix: como continuar depois do teste

Entenda a compra de crédito na RN, o saldo da organização e a cobrança por uso. O pagamento abre sobre a tarefa e mantém o contexto do trabalho.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Compre para a conta que vai usar

A RN oferece continuidade por crédito pré-pago. Quando a tarefa pede saldo, a contratação mostra o valor e as condições antes da confirmação. Comprar crédito avulso não ativa uma assinatura por inferência.

Confira a organização selecionada antes de pagar. O saldo da conta pessoal e o saldo de uma organização não são a mesma carteira de uso. As chaves daquela organização seguem seu contexto, suas permissões e suas condições de consumo.

## O pagamento acompanha a tarefa

O saldo e a compra abrem em uma janela sobre o trabalho. O fluxo não exige que você abandone a conversa para procurar uma página comercial. Depois da confirmação do pagamento, o produto atualiza o saldo e retoma o caminho de uso.

Use o estado informado pela RN. Uma imagem de comprovante ou uma tela de pagamento aberta não substitui a confirmação do fluxo financeiro. Se o Pix estiver pendente, acompanhe esse estado antes de gerar outra cobrança.

## Confira o preço do recurso escolhido

Modelos e capacidades têm unidades diferentes. Chat pode cobrar tokens de entrada e saída; outras capacidades seguem sua unidade publicada. Uma reserva pode cobrir o teto de uma resposta e ser ajustada depois conforme o uso medido.

Consulte a tabela e os recibos antes de automatizar grandes volumes. Limite a saída dos pedidos e acompanhe o consumo da organização. Crédito disponível não elimina cotas, políticas de privacidade, restrições de rede nem indisponibilidade de uma capacidade.

## Perguntas frequentes

Comprar crédito cria uma assinatura?

Crédito avulso é uma compra pré-paga. Confira as condições da contratação exibida; ele não vira uma assinatura automaticamente.

O saldo libera qualquer modelo ou capacidade?

Não. Também valem disponibilidade, permissões, limites e condições do recurso escolhido.

- [Preços atuais](https://rota-nacional.ia.br/api/pricing) - [Cancelamento e reembolso](https://rota-nacional.ia.br/pt/cancelamento/)

[Abrir meu uso e saldo](https://rota-nacional.ia.br/pt/app/uso/)

[Crédito de IA por Pix: como continuar depois do teste](https://rota-nacional.ia.br/pt/artigos/credito-pix-api-sem-assinatura/)

API para agentes: pagamento por chamada com x402

Fri, 30 Oct 2026 13:49:50 GMT

# API para agentes: pagamento por chamada com x402

Conheça a porta paga da RN para agentes sem cadastro. Veja o desafio 402, a autorização de gasto e a diferença para uma chave de organização.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Descubra o preço antes de autorizar o gasto

Um agente pode consultar o catálogo e escolher uma rota que ofereça pagamento por chamada. Sem pagamento, essa porta responde 402 com as condições aceitas. O cliente precisa interpretar a oferta e obter autorização para o valor antes de pagar.

A RN usa x402 com USDC na Base nas rotas que oferecem essa opção. Nem toda operação administrativa ou conexão privada vira uma chamada pública paga. Confira a autorização específica do endpoint em /openapi.json.

## Pagamento e organização resolvem problemas diferentes

O pagamento autoriza o recurso vendido naquela rota. Ele não concede acesso a arquivos privados de outra organização, não cadastra conexões e não muda políticas de privacidade. Para usar um pool privado, o consumidor continua precisando do escopo e das permissões exigidos.

No chat pago por uso, a reserva cobre o teto autorizado e a liquidação considera o consumo informado. Um job assíncrono retorna os dados para acompanhar sua execução. Guarde o identificador e consulte o estado; não trate um timeout como autorização para comprar o mesmo trabalho de novo.

## Integre o cliente com orçamento explícito

Use um cliente que compreenda o desafio e o comprovante de pagamento da versão oferecida pelo servidor. Defina um teto por ação e uma política para recusas. Uma mensagem de um modelo pedindo pagamento não é autoridade suficiente para movimentar a carteira.

No MCP, consulte as ferramentas e seu contrato. O transporte direto pode representar o desafio de pagamento dentro do resultado da ferramenta. Não presuma que o formato do HTTP é idêntico ao do MCP. O painel com conta, teste grátis e Pix continua sendo a entrada para pessoas.

## Perguntas frequentes

Preciso criar conta para toda chamada de agente?

As rotas que oferecem x402 permitem comprar a chamada sem cadastro. Conexões privadas e administração mantêm suas exigências próprias de autorização.

Pagar permite acessar o pool de qualquer organização?

Não. Pagamento não substitui isolamento, permissões, consentimentos ou a exigência de privacidade da organização.

- [Autorização e pagamento por rota](https://rota-nacional.ia.br/openapi.json) - [Índice da API da RN](https://rota-nacional.ia.br/api/)

[Ver rotas e condições](https://rota-nacional.ia.br/pt/docs/)

[API para agentes: pagamento por chamada com x402](https://rota-nacional.ia.br/pt/artigos/agentes-ia-pagamento-x402/)

Como conectar clientes OpenAI e Anthropic à RN

Fri, 30 Oct 2026 13:49:50 GMT

# Como conectar clientes OpenAI e Anthropic à RN

Escolha entre o catálogo protegido e o gateway nativo antes de configurar um cliente de IA ou agente de código. Modelo, endpoint e chave precisam combinar.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Escolha primeiro o contrato

A RN oferece chat compatível com o formato OpenAI em /v1/chat/completions e com o formato Messages em /v1/messages. Esse catálogo usa identificadores rota/* e aplica a política de dados pessoais da organização.

O gateway nativo é outro contrato. Ele conserva o modelo e o formato do provedor por /v1/providers/{provider}/. Não troque um caminho pelo outro apenas mudando o hostname: confira se o cliente precisa de ferramentas, arquivos, multimodalidade ou respostas que aquele caminho suporta.

## Configure endereço, credencial e modelo juntos

Num cliente OpenAI compatível, o endereço base do catálogo é a origem da RN seguida de /v1. Use uma chave RN e um modelo publicado em /v1/models. No cliente Anthropic compatível, a origem e o caminho Messages seguem o exemplo da documentação.

A página de agentes de código reúne os exemplos da RN para clientes suportados. Copie o exemplo do cliente real. Não exponha o segredo em repositório, captura, comando público ou configuração enviada a outra pessoa. O identificador de uma conexão não substitui a chave RN.

## Valide também as falhas

Faça uma chamada curta com conteúdo fictício. Depois confira streaming, ferramentas e limites que seu fluxo realmente usa. Uma resposta 401 indica problema de credencial; 403 pode vir de política da organização; 402 pede saldo ou condição financeira válida. O corpo do erro informa o código específico.

Se a organização exige a barreira, o cliente precisa usar um caminho protegido. Um agente de código não ganha permissão para enviar conteúdo bruto só por conseguir selecionar outro provedor. A aplicação mantém o controle sobre quais arquivos e informações entram no contexto.

## Perguntas frequentes

Posso usar qualquer nome de modelo no catálogo protegido?

Use os identificadores publicados em /v1/models e liberados para a organização. Os nomes nativos dos provedores pertencem ao contrato do gateway nativo.

Compatibilidade de chat garante suporte a toda API do provedor?

Não. Confira os caminhos e os recursos que a aplicação usa. Arquivos, mídia, ferramentas e operações assíncronas têm contratos próprios.

- [Configuração de agentes](https://rota-nacional.ia.br/pt/docs/agentes/) - [Catálogo público de modelos](https://rota-nacional.ia.br/v1/models)

[Configurar meu cliente](https://rota-nacional.ia.br/pt/docs/agentes/)

[Como conectar clientes OpenAI e Anthropic à RN](https://rota-nacional.ia.br/pt/artigos/integrar-api-openai-anthropic/)

n8n com IA e privacidade: um fluxo de atendimento

Fri, 30 Oct 2026 13:49:50 GMT

# n8n com IA e privacidade: um fluxo de atendimento

Use o exemplo n8n da RN para receber uma mensagem e devolver uma resposta. Veja autenticação, limites e responsabilidades antes de ligar ao seu canal.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## O exemplo faz uma tarefa delimitada

A RN publica um fluxo importável de atendimento para n8n. Ele recebe um campo message de outro fluxo, valida a entrada e chama o chat da RN. O resultado contém reply e model. O exemplo usa dados fictícios para permitir uma primeira execução sem informação de cliente.

Esse fluxo não envia mensagens ao WhatsApp. O canal fica com a aplicação que o chama. Ela precisa autenticar a entrada, controlar duplicatas e decidir quando encaminhar a conversa para uma pessoa.

## Separe autenticação e conteúdo

Importe o JSON da integração e configure Bearer Auth no nó HTTP Request. Mantenha a credencial no mecanismo de credenciais do n8n, separada do corpo JSON. O exemplo não precisa conter a chave de um provedor externo: ele usa a chave RN.

Confira o modelo rota/* e a organização da chave. A chamada passa pela política configurada na RN. Se a equipe exige a barreira, o contrato protegido deve continuar sendo usado ao adaptar o fluxo.

## Conecte ao processo real com controle

A versão publicada valida mensagens de 1 a 8.000 caracteres. Ela não salva dados de execução e não faz repetição automática quando a chamada falha. Ao adaptar o fluxo, preserve uma política de retenção coerente com seu processo.

Teste o caminho de erro, o esgotamento de saldo e o encaminhamento humano antes de conectar um canal real. Não use uma resposta gerada como autorização para emitir cobrança, alterar cadastro ou prometer condições comerciais. Essas ações precisam de regras e permissões na aplicação.

## Perguntas frequentes

O fluxo já envia a resposta ao WhatsApp?

Não. Ele devolve reply e model. A aplicação chamadora integra o canal e controla autenticação, duplicatas e encaminhamento humano.

A chave precisa ficar dentro do JSON do pedido?

Não. Configure Bearer Auth no n8n e mantenha a credencial separada do conteúdo.

- [JSON do fluxo n8n](https://rota-nacional.ia.br/integracoes/rota-atendimento-n8n.json) - [Guia de integração](https://rota-nacional.ia.br/pt/solucoes/agentes-de-whatsapp/#n8n)

[Abrir o fluxo n8n](https://rota-nacional.ia.br/pt/solucoes/agentes-de-whatsapp/#n8n)

[n8n com IA e privacidade: um fluxo de atendimento](https://rota-nacional.ia.br/pt/artigos/n8n-atendimento-com-privacidade/)

OCR nativo ou extração com privacidade: qual usar?

Fri, 30 Oct 2026 13:49:50 GMT

# OCR nativo ou extração com privacidade: qual usar?

Diferencie o OCR nativo da Mistral e a extração de texto com tratamento de dados pessoais na RN. O tipo de entrada e a política mudam a integração.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Ler um documento não é o mesmo que proteger seu texto

OCR transforma conteúdo visual em texto e estrutura. A barreira de privacidade trata dados pessoais no conteúdo que consegue examinar. Uma imagem enviada diretamente a um modelo não fica protegida só porque outra parte da conversa passou por regras de texto.

Escolha o caminho antes de integrar. Se a organização exige tratamento antes do envio, confira a extração protegida e as capacidades disponíveis. Se precisa do contrato nativo de um provedor, avalie a autorização para enviar o documento original.

## Quando usar o OCR nativo

O caminho /v1/providers/mistral/v1/ocr conserva o corpo aceito pela Mistral, incluindo o modelo e as opções suportadas pelo provedor. A entrada pode referenciar um documento ou imagem no formato nativo ou um arquivo próprio registrado no gateway.

Esse caminho exige conexão autorizada e consentimento nativo. Ele envia o documento original e não aplica a barreira. Uma organização que exige a barreira recebe 403 antes do envio. O gateway conserva os erros do provedor em vez de alterar o pedido para tentar fazê-lo passar.

## Quando usar a extração protegida

O endpoint /v1/privacy/extract fornece a entrada para obter texto tratado antes de usá-lo no chat protegido. Confira os formatos, o tamanho máximo e a disponibilidade da capacidade na API. O fato de existir uma rota não significa que um worker esteja disponível naquele instante.

Comece com um documento fictício representativo. Verifique ordem de leitura, tabelas e categorias detectadas. OCR pode errar caracteres e estrutura; a detecção de dados pessoais também tem limites. Não anuncie extração perfeita nem conformidade legal automática a partir de uma resposta bem-sucedida.

## Perguntas frequentes

O OCR nativo aplica a barreira de privacidade?

Não. Ele mantém o documento e o contrato do provedor. Se a organização exige a barreira, esse caminho é recusado.

Posso colocar uma imagem no chat para a barreira ler?

A barreira de texto não lê pixels. Confira a extração protegida, os formatos suportados e a capacidade disponível antes de enviar o conteúdo ao chat.

- [Rotas e limites da RN](https://rota-nacional.ia.br/openapi.json) - [Contrato oficial de OCR da Mistral](https://docs.mistral.ai/api/endpoint/ocr)

[Conferir extração e OCR](https://rota-nacional.ia.br/pt/docs/)

[OCR nativo ou extração com privacidade: qual usar?](https://rota-nacional.ia.br/pt/artigos/ocr-nativo-extracao-privacidade/)