Web Cookie Providers (Português (Brasil))

Antes de começar

Importante: Sempre copie as credenciais de uma solicitação de rede ativa, e não do armazenamento de cookies do navegador.

Muitos problemas de autenticação são causados pela cópia de cookies do local errado.

NÃO copie do armazenamento de cookies

A maioria dos navegadores expõe os cookies armazenados por meio de:

DevTools
→ Application (ou Storage)
→ Cookies

Embora esses cookies pareçam corretos, eles podem estar:

• desatualizados
• incompletos
• sem cookies enviados apenas em solicitações autenticadas

O uso desses valores pode causar falhas de autenticação, mesmo que pareçam válidos.

Copie de uma solicitação ativa

Em vez disso, use os cookies de uma solicitação bem-sucedida:

DevTools
→ Network
→ Atualize a página
→ Abra uma solicitação de chat ou conversa
→ Request Headers
→ Cookie

O cabeçalho de solicitação Cookie contém exatamente as informações de autenticação que seu navegador usou com sucesso.

Para a maioria dos provedores de Cookies da Web, esse é o valor que deve ser colado no OmniRoute.

---

Configuração geral

O processo de configuração é o mesmo para a maioria dos provedores de Cookies da Web.

1. Entre no site do provedor.
2. Abra as Ferramentas do Desenvolvedor do navegador.
3. Abra a guia Network.
4. Atualize a página.
5. Abra uma solicitação autenticada de chat ou conversa.
6. Copie as credenciais de autenticação necessárias.
7. Abra o OmniRoute.
8. Acesse Providers → Add Provider.
9. Selecione seu provedor de Cookies da Web.
10. Cole as credenciais.
11. Clique em Test Connection.
12. Salve o provedor.

As credenciais exatas necessárias dependem do provedor.

---

Formatos de credenciais dos provedores

Sites diferentes armazenam a autenticação de maneiras distintas. Alguns exigem apenas cookies, enquanto outros podem exigir cabeçalhos ou tokens adicionais.

Provedor	Formato das credenciais	Guia do provedor
Claude Web	Cabeçalho completo da solicitação Cookie	docs/providers/CLAUDE_WEB.md
ChatGPT Web (Codex)	Cabeçalho Cookie completo	docs/providers/CHATGPT_WEB.md
Gemini Web	(verificar)
Copilot Web	(verificar)	docs/providers/COPILOT-M365.md
Microsoft 365 Copilot (BizChat)	WS access_token + chathubPath	docs/providers/COPILOT-M365.md
Grok Web	(verificar)
…	…	…

Atualize esta tabela à medida que novos provedores de Cookies da Web forem adicionados ou que os provedores existentes alterarem seus requisitos de autenticação.

---

O que os provedores de Cookies da Web podem e não podem fazer

Os provedores de Cookies da Web reutilizam a interface de chat de um site. Eles não oferecem os mesmos recursos das APIs oficiais.

Compatível

• Autenticação usando sua sessão existente do navegador
• Acesso aos modelos disponíveis por meio da sua conta
• Transmissão contínua de respostas do chat
• Nenhuma chave de API necessária

Não compatível

• Chamadas de funções
• Chamadas de ferramentas
• Edição automática de arquivos
• Fluxos de trabalho de IDE com agentes
• Recursos disponíveis apenas por API

Esse é o comportamento esperado e não é um bug.

Se você precisar de execução de ferramentas, edição automática de arquivos ou outros fluxos de trabalho com agentes, use um provedor com chave de API em vez de um provedor de Cookies da Web.

---

Ressalva sobre a validação

Uma Test Connection bem-sucedida ou a validação dos cookies apenas verifica se as credenciais fornecidas parecem estar no formato esperado.

Até que a Issue #7857 seja resolvida, uma validação bem-sucedida não garante que a autenticação do provedor ocorrerá corretamente.

Se a autenticação ainda falhar, verifique se você copiou as credenciais de uma solicitação de rede ativa, e não do armazenamento de cookies do navegador.

---

Solução de problemas

Falha na autenticação

Verifique se as credenciais foram copiadas de:

Network
→ Request Headers
→ Cookie

e não de:

Application
→ Cookies

---

O cookie funciona no navegador, mas não no OmniRoute

Alguns provedores incluem cookies que são enviados apenas durante solicitações autenticadas.

Copie novamente as credenciais de uma solicitação de rede recente após abrir uma conversa com sucesso.

---

Sessão expirada

Os provedores de Cookies da Web usam sua sessão existente do navegador.

Se a sessão do navegador expirar ou você sair da conta, será necessário copiar um novo conjunto de credenciais.

---

A conexão de teste é aprovada, mas as solicitações falham

Até que a Issue #7857 seja resolvida, a aprovação na validação não garante que a solicitação de autenticação será bem-sucedida.

Copie novamente suas credenciais de uma solicitação autenticada recente antes de continuar a solução de problemas.

---

Exemplo de provedor

Para obter instruções completas específicas de um provedor, consulte:

• Claude Web — docs/providers/CLAUDE_WEB.md

O guia do Claude Web demonstra o processo completo de configuração de um provedor de Cookies da Web e serve como implementação de referência.

---

Práticas recomendadas

• Copie as credenciais de uma solicitação autenticada recente.
• Evite reutilizar cookies antigos.
• Mantenha sua sessão do navegador ativa enquanto estiver usando provedores de Cookies da Web.
• Trate os cookies copiados como credenciais confidenciais.
• Use provedores com chave de API quando precisar de chamadas de funções ou fluxos de trabalho com agentes.

---

Código-fonte do OmniRoute (a58000c7685f)