# the news

## Docs

- [Claude Code setup](https://docs.thenewscc.com.br/ai-tools/claude-code.md): Configure Claude Code for your documentation workflow
- [Cursor setup](https://docs.thenewscc.com.br/ai-tools/cursor.md): Configure Cursor for your documentation workflow
- [Windsurf setup](https://docs.thenewscc.com.br/ai-tools/windsurf.md): Configure Windsurf for your documentation workflow
- [Introdução](https://docs.thenewscc.com.br/api-reference/introduction.md): API completa para gerenciamento de dados e operações do ecossistema
- [Registrar Agente](https://docs.thenewscc.com.br/api-reference/openai/agent-register.md): Cria um novo agente com configuração customizada
- [Usar Agente](https://docs.thenewscc.com.br/api-reference/openai/agent-use.md): Chat usando agente pré-configurado
- [Chat Completion](https://docs.thenewscc.com.br/api-reference/openai/chat.md): Executa chat completion básico com OpenAI GPT
- [Chat with MCP](https://docs.thenewscc.com.br/api-reference/openai/chat-mcp.md): Chat com Model Context Protocol para contexto dinâmico
- [Chat with Tools](https://docs.thenewscc.com.br/api-reference/openai/chat-tools.md): Chat com function calling para executar tools e ações
- [OpenAI API Integration](https://docs.thenewscc.com.br/api-reference/openai/introduction.md): API de integração com OpenAI para chat, agents e tools
- [Listar Recursos](https://docs.thenewscc.com.br/api-reference/openai/resources.md): Lista todos os agentes e tools disponíveis
- [Criar Quiz para Data](https://docs.thenewscc.com.br/api-reference/quiz/admin-create.md): Cria um quiz para uma data específica
- [Deletar Quiz](https://docs.thenewscc.com.br/api-reference/quiz/admin-delete.md): Deleta um quiz específico e todos os dados relacionados
- [Gerar Quiz Diário](https://docs.thenewscc.com.br/api-reference/quiz/admin-generate.md): Força a geração do quiz diário baseado na última edição da newsletter
- [Listar Todos os Quizzes](https://docs.thenewscc.com.br/api-reference/quiz/admin-list.md): Lista todos os quizzes criados no sistema com paginação
- [Listar Quizzes Disponíveis](https://docs.thenewscc.com.br/api-reference/quiz/available.md): Retorna a lista de quizzes disponíveis para o usuário nos últimos 3 dias
- [Obter Quiz](https://docs.thenewscc.com.br/api-reference/quiz/get-quiz.md): Retorna um quiz específico com todas as suas perguntas
- [Histórico de Tentativas](https://docs.thenewscc.com.br/api-reference/quiz/history.md): Retorna o histórico de todas as tentativas de quiz do usuário
- [Quiz API](https://docs.thenewscc.com.br/api-reference/quiz/introduction.md): API para sistema de quiz de recuperação de streaks baseado nas edições diárias (matinal e noturna) do The News
- [Submeter Respostas](https://docs.thenewscc.com.br/api-reference/quiz/submit.md): Submete as respostas do usuário para um quiz e verifica se passou
- [Ativar Indicação](https://docs.thenewscc.com.br/api-reference/referrals/activate.md): Ativa uma indicação pendente
- [Banir/Desbanir Usuário](https://docs.thenewscc.com.br/api-reference/referrals/ban.md): Alterna o status de banimento de um usuário. Requer autenticação JWT.
- [Listar Usuários Banidos](https://docs.thenewscc.com.br/api-reference/referrals/banned-list.md): Retorna a lista de todos os usuários banidos. Requer autenticação JWT.
- [Verificar Fraude](https://docs.thenewscc.com.br/api-reference/referrals/check-fraud.md): Executa uma verificação de fraude de emergência
- [Contagem por Email](https://docs.thenewscc.com.br/api-reference/referrals/count-by-email.md): Obtém a contagem de indicações para um email
- [Listar Entregas](https://docs.thenewscc.com.br/api-reference/referrals/delivery.md): Lista as respostas dos formulários de entrega. Requer autenticação JWT.
- [Status dos Formulários de Entrega](https://docs.thenewscc.com.br/api-reference/referrals/delivery-buttons.md): Verifica quais formulários de entrega de produtos/recompensas um usuário já enviou
- [Exportar Indicações](https://docs.thenewscc.com.br/api-reference/referrals/export.md): Exporta dados de indicações em formato CSV
- [Introdução](https://docs.thenewscc.com.br/api-reference/referrals/introduction.md): API para gerenciamento do programa de indicações
- [Listar Indicações](https://docs.thenewscc.com.br/api-reference/referrals/list.md): Lista todas as indicações com filtros e paginação. Requer autenticação JWT.
- [Login de Usuário](https://docs.thenewscc.com.br/api-reference/referrals/login.md): Realiza o login de um usuário existente
- [Registrar Usuário](https://docs.thenewscc.com.br/api-reference/referrals/register.md): Registra um novo usuário no programa de indicações
- [Reenviar Email de Ativação](https://docs.thenewscc.com.br/api-reference/referrals/resend.md): Reenvia o email de ativação para uma indicação pendente
- [Inscrever Indicação](https://docs.thenewscc.com.br/api-reference/referrals/subscribe.md): Inscreve através do programa de indicações
- [Atualizar Dados de Fraude](https://docs.thenewscc.com.br/api-reference/referrals/update-fraud.md): Atualiza dados de fraude ausentes em indicações antigas
- [Adicionar Mensagem](https://docs.thenewscc.com.br/api-reference/sac/add-message.md): Adiciona uma nova mensagem a um ticket
- [Anexos](https://docs.thenewscc.com.br/api-reference/sac/attachments.md): Gerencia anexos de tickets de suporte
- [Deletar Tickets em Lote](https://docs.thenewscc.com.br/api-reference/sac/batch-delete.md): Realiza soft delete de múltiplos tickets de uma vez
- [Enviar Mensagem em Lote](https://docs.thenewscc.com.br/api-reference/sac/batch-messages.md): Envia a mesma mensagem para múltiplos tickets de uma vez
- [Atualizar Status em Lote](https://docs.thenewscc.com.br/api-reference/sac/batch-status.md): Atualiza o status de múltiplos tickets de uma vez
- [Criar Ticket](https://docs.thenewscc.com.br/api-reference/sac/create-ticket.md): Cria um novo ticket de suporte
- [Fast Response em Lote](https://docs.thenewscc.com.br/api-reference/sac/fast-response-batch.md): Processa múltiplos tickets com IA simultaneamente
- [Fast Response Preview](https://docs.thenewscc.com.br/api-reference/sac/fast-response-preview.md): Gera resposta de IA sem criar ticket (preview)
- [Fast Response para Ticket](https://docs.thenewscc.com.br/api-reference/sac/fast-response-ticket.md): Gera resposta de IA para um ticket específico
- [Obter Ticket](https://docs.thenewscc.com.br/api-reference/sac/get-ticket.md): Obtém os detalhes completos de um ticket específico
- [SAC/Support API](https://docs.thenewscc.com.br/api-reference/sac/introduction.md): API completa para gerenciamento de tickets de suporte e atendimento ao cliente
- [Listar Mensagens](https://docs.thenewscc.com.br/api-reference/sac/list-messages.md): Lista o histórico de mensagens de um ticket com paginação
- [Listar Tickets](https://docs.thenewscc.com.br/api-reference/sac/list-tickets.md): Lista tickets de suporte com filtragem e paginação
- [Obter Opções](https://docs.thenewscc.com.br/api-reference/sac/options.md): Retorna as opções disponíveis para formulários de tickets
- [Criar Resposta Rápida](https://docs.thenewscc.com.br/api-reference/sac/quick-replies-create.md): Cria um novo template de resposta rápida
- [Excluir Resposta Rápida](https://docs.thenewscc.com.br/api-reference/sac/quick-replies-delete.md): Remove um template de resposta rápida
- [Listar Respostas Rápidas](https://docs.thenewscc.com.br/api-reference/sac/quick-replies-list.md): Lista templates de respostas rápidas com filtros e paginação
- [Atualizar Resposta Rápida](https://docs.thenewscc.com.br/api-reference/sac/quick-replies-update.md): Atualiza um template de resposta rápida existente
- [Usar Resposta Rápida](https://docs.thenewscc.com.br/api-reference/sac/quick-replies-use.md): Incrementa o contador de uso e retorna o conteúdo formatado
- [Relatórios e Métricas](https://docs.thenewscc.com.br/api-reference/sac/reports.md): API completa para geração de relatórios avançados do SAC com cache de 2h
- [Performance de Agentes](https://docs.thenewscc.com.br/api-reference/sac/reports-agents.md): Retorna métricas de performance por agente
- [Análise de Cohorts](https://docs.thenewscc.com.br/api-reference/sac/reports-cohorts.md): Retorna análise de cohorts (grupos de tickets por período)
- [Comparativo entre Períodos](https://docs.thenewscc.com.br/api-reference/sac/reports-comparison.md): Compara métricas entre dois períodos
- [Dashboard de Relatórios](https://docs.thenewscc.com.br/api-reference/sac/reports-dashboard.md): Retorna métricas principais do dashboard com cache de 2h
- [Relatório Detalhado](https://docs.thenewscc.com.br/api-reference/sac/reports-detailed.md): Gera relatório completo com todos os filtros e métricas
- [Distribuição de Tickets](https://docs.thenewscc.com.br/api-reference/sac/reports-distribution.md): Retorna distribuição de tickets por hora, dia da semana e newsletter
- [Filtros Disponíveis](https://docs.thenewscc.com.br/api-reference/sac/reports-filters.md): Retorna todos os filtros disponíveis para relatórios
- [Tendências de Issues](https://docs.thenewscc.com.br/api-reference/sac/reports-issues.md): Retorna tendências de issues ao longo do tempo
- [Métricas de Resolução](https://docs.thenewscc.com.br/api-reference/sac/reports-resolution.md): Retorna métricas detalhadas de resolução de tickets
- [Resumo Rápido](https://docs.thenewscc.com.br/api-reference/sac/reports-summary.md): Retorna resumo dos últimos 30 dias
- [Série Temporal](https://docs.thenewscc.com.br/api-reference/sac/reports-timeseries.md): Retorna série temporal de tickets com status detalhado
- [Adicionar Tag ao Ticket](https://docs.thenewscc.com.br/api-reference/sac/tags-add-ticket.md): Associa uma tag a um ticket de suporte
- [Criar Tag](https://docs.thenewscc.com.br/api-reference/sac/tags-create.md): Cria uma nova tag de suporte
- [Deletar Tag](https://docs.thenewscc.com.br/api-reference/sac/tags-delete.md): Remove uma tag de suporte do sistema
- [Listar Tags](https://docs.thenewscc.com.br/api-reference/sac/tags-list.md): Retorna todas as tags de suporte disponíveis
- [Remover Tag do Ticket](https://docs.thenewscc.com.br/api-reference/sac/tags-remove-ticket.md): Remove a associação de uma tag com um ticket
- [Atualizar Tag](https://docs.thenewscc.com.br/api-reference/sac/tags-update.md): Atualiza uma tag de suporte existente
- [Atualizar Ticket](https://docs.thenewscc.com.br/api-reference/sac/update-ticket.md): Atualiza os campos de um ticket
- [Adicionar Ice Credits](https://docs.thenewscc.com.br/api-reference/streaks/add-ice-credits.md): Adiciona créditos de gelo para um usuário
- [Completar Missão](https://docs.thenewscc.com.br/api-reference/streaks/complete-mission.md): Marca uma missão como completada
- [Exportar Emails](https://docs.thenewscc.com.br/api-reference/streaks/export-emails.md): Exporta emails de usuários filtrados por critérios de streak. Requer autenticação JWT.
- [Histórico de Leituras](https://docs.thenewscc.com.br/api-reference/streaks/get-history.md): Obtém o histórico completo de leituras de um usuário
- [Obter Missões](https://docs.thenewscc.com.br/api-reference/streaks/get-missions.md): Obtém as missões de streak disponíveis para um leitor
- [Ranking de Leitores (Legacy)](https://docs.thenewscc.com.br/api-reference/streaks/get-ranking.md): Obtém o ranking dos leitores com maiores streaks
- [Datas de Leitura](https://docs.thenewscc.com.br/api-reference/streaks/get-reading-dates.md): Obtém todas as datas em que o usuário realizou leituras
- [Obter Streak do Usuário](https://docs.thenewscc.com.br/api-reference/streaks/get-user-streak.md): Obtém informações detalhadas sobre o streak atual do usuário
- [Adicionar Membros ao Grupo](https://docs.thenewscc.com.br/api-reference/streaks/groups-add-members.md)
- [Criar Grupo de Amigos](https://docs.thenewscc.com.br/api-reference/streaks/groups-create.md): Cria um novo grupo de amigos para competições privadas de streak
- [Listar Grupos do Usuário](https://docs.thenewscc.com.br/api-reference/streaks/groups-list.md): Lista todos os grupos dos quais o usuário autenticado é membro
- [Ranking do Grupo](https://docs.thenewscc.com.br/api-reference/streaks/groups-ranking.md)
- [Introdução](https://docs.thenewscc.com.br/api-reference/streaks/introduction.md): API para gerenciamento de streaks e leitura de conteúdo
- [Pixel de Rastreamento](https://docs.thenewscc.com.br/api-reference/streaks/pixel-tracking.md): Pixel de rastreamento para monitorar abertura de emails
- [Ranking Global](https://docs.thenewscc.com.br/api-reference/streaks/ranking-global.md): Obtém o ranking global dos top 100 leitores com maior streak de leitura
- [Invalidar Cache do Ranking](https://docs.thenewscc.com.br/api-reference/streaks/ranking-invalidate-cache.md): Invalida forçosamente o cache do ranking global (uso administrativo)
- [Ranking Global com Posição do Usuário](https://docs.thenewscc.com.br/api-reference/streaks/ranking-with-position.md): Obtém o ranking global e inclui a posição específica do usuário autenticado
- [Registrar Leitura](https://docs.thenewscc.com.br/api-reference/streaks/register-read.md): Registra uma nova leitura de conteúdo para um usuário
- [Registrar Compartilhamento](https://docs.thenewscc.com.br/api-reference/streaks/save-share.md): Registra quando um usuário compartilha seu streak
- [Atualizar Preferências de Presentes](https://docs.thenewscc.com.br/api-reference/streaks/update-gift-preferences.md): Atualiza as preferências do usuário sobre recebimento de presentes
- [Webhook Beehiiv](https://docs.thenewscc.com.br/api-reference/subscription/beehiiv-webhook.md): Recebe eventos de inscrição do Beehiiv
- [Obter Métricas](https://docs.thenewscc.com.br/api-reference/subscription/get-metrics.md): Retorna métricas detalhadas de inscrições
- [Obter Assinante](https://docs.thenewscc.com.br/api-reference/subscription/get-subscriber.md)
- [Obter Resumo](https://docs.thenewscc.com.br/api-reference/subscription/get-summary.md): Retorna resumo consolidado das métricas
- [Introdução](https://docs.thenewscc.com.br/api-reference/subscription/introduction.md): API para gerenciamento de inscrições e métricas de assinantes
- [Inscrever via Referral](https://docs.thenewscc.com.br/api-reference/subscription/referral-subscribe.md): Inscreve através do programa de indicações
- [Inscrever no the news](https://docs.thenewscc.com.br/api-reference/subscription/subscribe.md): Inscreve um usuário diretamente em uma newsletter
- [Inscrever (Outros)](https://docs.thenewscc.com.br/api-reference/subscription/subscribe-others.md): Permite inscrever outras pessoas nas newsletters
- [desenvolvimento local](https://docs.thenewscc.com.br/development.md): configure o ambiente de desenvolvimento para trabalhar com nossa API
- [Code blocks](https://docs.thenewscc.com.br/essentials/code.md): Display inline code and code blocks
- [Images and embeds](https://docs.thenewscc.com.br/essentials/images.md): Add image, video, and other HTML elements
- [Markdown syntax](https://docs.thenewscc.com.br/essentials/markdown.md): Text, title, and styling in standard markdown
- [Navigation](https://docs.thenewscc.com.br/essentials/navigation.md): The navigation field in docs.json defines the pages that go in the navigation menu
- [Reusable snippets](https://docs.thenewscc.com.br/essentials/reusable-snippets.md): Reusable, custom snippets to keep content in sync
- [configurações da API](https://docs.thenewscc.com.br/essentials/settings.md): configurações e variáveis de ambiente para integração com nossa API
- [bem-vindos ao the news](https://docs.thenewscc.com.br/index.md): documentação completa para nossa plataforma de mídia
- [Visão Geral da Arquitetura](https://docs.thenewscc.com.br/portal/architecture/overview.md): Arquitetura completa do Portal do The News
- [Tech Stack](https://docs.thenewscc.com.br/portal/architecture/tech-stack.md): Stack tecnológico serverless do Portal do The News
- [Portal - Documentação Técnica](https://docs.thenewscc.com.br/portal/introduction.md): Documentação técnica interna do Portal do The News
- [início rápido](https://docs.thenewscc.com.br/quickstart.md): comece a usar nossa API em minutos

## OpenAPI Specs

- [sac-reports](https://docs.thenewscc.com.br/api-reference/openapi/sac-reports.json)
- [sac-openai](https://docs.thenewscc.com.br/api-reference/openapi/sac-openai.json)
- [referrals](https://docs.thenewscc.com.br/api-reference/openapi/referrals.json)
- [streaks](https://docs.thenewscc.com.br/api-reference/openapi/streaks.json)
- [subscription](https://docs.thenewscc.com.br/api-reference/openapi/subscription.json)
- [openapi](https://docs.thenewscc.com.br/api-reference/openapi/openapi.json)

## Optional

- [the news](https://thenewscc.com.br)
- [foguinho](https://thenewscc.com.br/streak)
- [programa de indicações](https://app.thenewscc.com.br)