Passar para o conteúdo principal

Guia de ferramentas: CS e N2

Documentação em construção

E
Escrito por Equipe Ecommerce

Este artigo reúne tudo que você precisa saber sobre as ferramentas que usamos no dia a dia: para que serve cada uma, quando você vai precisar dela e como solicitar acesso.

Ferramentas

CS

N2

Intercom

Unleash

Grafana

Sentry

Datadog

Cloudflare

Amazon SES

Athena

Launcher

Keeper

Usuário suporte ERP

VPN

GitLab

Power BI

Sidekiq

N8N

Zapier

Descrição detalhada das ferramentas

Salesforce:

Times: CS e N2

Para que serve:

É o nosso CRM central. Nele ficam registrados os dados dos sellers, histórico de relacionamento, oportunidades, tarefas e o acompanhamento de toda a jornada do cliente.

Casos de uso

Consultar informações cadastrais e de contrato de um seller; registrar interações e follow-ups; acompanhar status de oportunidades; alimentar pipelines de reengajamento.

Como solicitar acesso:

Abrir chamado no [canal/ferramenta de TI] informando nome completo, squad e perfil de acesso necessário (somente leitura ou edição). O gestor direto precisa aprovar.



ClickUp:

Times: N2

Para que serve

Nossa principal ferramenta de gestão de tarefas e projetos. É onde ficam os cards de investigação de bugs, melhorias de produto, acompanhamento de jornadas de sellers e automações de fluxo. Vários processos internos disparam webhooks a partir de campos customizados do ClickUp.

Casos de uso

Criar e acompanhar cards de bugs para o time de produto; gerenciar a jornada do seller no Impulsiona via campo "Status da Jornada"; receber notificações de eventos de homologação; organizar tarefas do time.

Como solicitar acesso

Solicitar ao gestor que te adicione ao workspace correto. Para acessos a spaces específicos, o gestor do space precisa conceder a permissão.


Intercom

Times: CS

Para que serve

Plataforma de suporte e comunicação com os sellers. É por onde chegam os tickets de atendimento, onde a equipe responde chamados e onde ficam documentados os artigos de ajuda — incluindo este que você está lendo agora.

Casos de uso: Atender e responder tickets de sellers; consultar histórico de conversas; criar e manter artigos na base de conhecimento; usar o inbox compartilhado para triagem de chamados entre CS e N2.

Como solicitar acesso

Solicitar ao gestor direto que crie o seu usuário no workspace da Olist Ecommerce. O perfil de acesso (agente, admin) é definido conforme o papel na equipe.


Unleash

Times: N2

Para que serve

Ferramenta de feature flags. Permite ativar ou desativar funcionalidades da plataforma VNDA para stores ou grupos específicos sem precisar de um novo deploy. Muito útil para investigação de bugs — é possível verificar se uma flag está impactando o comportamento de uma loja.

Casos de uso

Verificar se uma feature está ativada para um seller específico; ativar/desativar funcionalidades durante troubleshooting; checar rollouts graduais de novas features.

Como solicitar acesso

Abrir chamado para o time de infraestrutura/DevOps via [canal interno]. Acesso de leitura é padrão para N2; acesso de edição requer aprovação do tech lead.



Grafana

Times: N2

Para que serve

Plataforma de observabilidade. Usamos principalmente para consulta de logs via Loki (com queries LogQL) e monitoramento de métricas da plataforma. É a ferramenta central para investigação de comportamentos inesperados em produção.

Casos de uso

Investigar logs de pagamento usando o request_id como chave de correlação; analisar tempo de resposta de integrações (ctx.elapsed); diagnosticar falhas em jobs do Sidekiq; validar comportamento de fluxos de pedidos.

Como solicitar acesso

Solicitar ao time de infraestrutura via [canal interno]. Labels de uso no N2: {container="api-sidekiq", application_name="api-sidekiq"}.



Sentry

Times: N2

Para que serve

Monitoramento de erros em tempo real. Captura exceções, stack traces e contexto de erros da aplicação. Quando algo quebra em produção, o Sentry geralmente é o primeiro lugar a mostrar o que aconteceu e onde no código.

Casos de uso

Investigar erros reportados por sellers; consultar stack traces de exceções; acompanhar a frequência e recorrência de um bug; identificar se um erro é isolado ou sistêmico.

Como solicitar acesso

Solicitar ao gestor que abra chamado para o time de produto/engenharia. Acesso é concedido por organização e projeto dentro do Sentry.



Datadog

Times: N2

Para que serve

Plataforma de monitoramento de infraestrutura e APM (Application Performance Monitoring). Complementa o Grafana com visibilidade sobre métricas de serviços, traces de requisições e dashboards de saúde da plataforma.

Casos de uso

Verificar latência de endpoints da API VNDA; acompanhar saúde de serviços em produção; cruzar traces com logs para diagnóstico de problemas de performance; monitorar alertas de infraestrutura.

Como solicitar acesso

Solicitar ao time de infraestrutura via [canal interno]. Perfil de leitura é o padrão para N2.


Cloudflare

Times: N2

Para que serve

Utilizamos como servidor para gerenciamento de CDN, geração de certificado SSL segurança das lojas, conexão de server side Zaraz das lojas em Olist Ecommerce.

Casos de uso

Como solicitar acesso

Solicitar ao time de infraestrutura.


Amazon SES

Times: N2

Para que serve

Serviço de envio de emails transacionais da AWS. É o serviço responsável pelo disparo de emails das lojas (confirmação de pedido, recuperação de senha, notificações). Problemas de entrega de email frequentemente envolvem configurações do SES e DNS.

Casos de uso

Investigar emails que não estão chegando; verificar se o DKIM Easy DKIM está configurado corretamente no Cloudflare; checar reputação de domínio e bounces; validar CNAMEs do SES.

Como solicitar acesso

Solicitar ao time de infraestrutura/AWS. Para N2, acesso de leitura ao console SES (logs de envio, status de domínios) é o suficiente.


Amazon Athena

Times: CSN2

Para que serve

Motor de consulta SQL sobre o datalake da Olist (arquivos Parquet no S3). Permite consultar dados operacionais dos sellers, como status de loja, datas de lançamento e métricas de GMV, diretamente nas tabelas do datalake sem precisar de um banco de dados tradicional.

Casos de uso

Consultar dados de sellers na tabela datalake_gold.bio_ecommerce_seller; verificar datas de lançamento de novas lojas; extrair métricas para análises de CS; alimentar automações como o projeto Impulsiona.

Como solicitar acesso



Launcher

Times: N2

Para que serve

Aplicação interna para gerenciamento e acompanhamento do processo de lançamento de novas lojas na plataforma.

Casos de uso

Como solicitar acesso

Solicitar ao gestor direto. O acesso é vinculado ao papel no time (CS ou N2) e concedido pelo responsável da ferramenta internamente.


Keeper

Times:CSN2

Para que serve

Cofre de senhas corporativo. É onde ficam armazenadas credenciais compartilhadas de sistemas, tokens de acesso e outras informações sensíveis que precisam ser acessadas pela equipe de forma segura e rastreável.

Casos de uso

Acessar credenciais de ambientes de produção; compartilhar tokens de API de forma segura com o time; armazenar credenciais de ERPs de sellers durante troubleshooting.

Como solicitar acesso

Solicitar ao gestor direto ou TI. Após criação do usuário, o acesso a pastas específicas é concedido pelo responsável de cada pasta no Keeper.


Usuário de suporte ERP

Times:CSN2

Para que serve

Acesso de suporte às contas de ERP dos sellers. Permite visualizar configurações de integração, diretamente no ambiente do seller para diagnóstico de problemas.

Como solicitar acesso

O acesso é solicitado diretamente ao seller, que cria um usuário de suporte no ERP deles. Para acessos recorrentes, as credenciais ficam armazenadas no Keeper. Nunca salve credenciais de sellers localmente.


VPN

Times: N2

Para que serve

Acesso seguro à rede interna da Olist. Necessária para acessar ambientes e ferramentas restritas à rede corporativa, como alguns painéis de infraestrutura, bancos de dados internos e ferramentas de monitoramento que não ficam expostos na internet pública.

Casos de uso

Acessar painéis internos de monitoramento; conectar a bancos de dados de staging ou produção via túnel seguro; acessar ferramentas restritas à rede Olist quando trabalhando remotamente.

Como solicitar acesso

Solicitar ao TI via [canal interno] informando sistema operacional e justificativa. O cliente VPN (ex: OpenVPN, Tailscale) e as credenciais serão fornecidos pelo TI.


GitLab

Times: N2

Para que serve

Repositório de código e CI/CD da plataforma. Para o time de N2, o acesso ao GitLab é principalmente de leitura, permite consultar o código-fonte para entender o comportamento da plataforma, verificar implementações de features e acompanhar deploys recentes que possam ter causado regressões.

Casos de uso

Consultar implementação de uma feature para entender seu comportamento esperado; verificar se um bug reportado corresponde a uma mudança recente de código; acompanhar o histórico de deploys.

Como solicitar acesso

Solicitar ao tech lead ou gestor, que abrirá o acesso aos repositórios relevantes. Acesso de N2 é tipicamente leitura nos projetos da plataforma.


Contentful

Times: CS

Para que serve

CMS (Content Management System) headless usado para gerenciar conteúdos publicados na plataforma para aplicativos listados no admin. O CS pode precisar consultar ou ajustar conteúdos sem envolver o time de desenvolvimento.

Casos de uso

Consultar e atualizar conteúdos de páginas de sellers; publicar materiais de apoio para campanhas; verificar conteúdos que possam estar desatualizados ou incorretos.

Como solicitar acesso

Solicitar ao gestor direto. O acesso ao Contentful é concedido por espaço (space), conforme a necessidade de cada área.


Power BI

Times: CSN2

Para que serve

Ferramenta de BI para visualização e análise de dados operacionais. Concentra dashboards com métricas dos sellers, volume de tickets, performance de integrações e outros KPIs relevantes para CS e N2 tomarem decisões baseadas em dados.

Casos de uso

Acompanhar GMV dos sellers da sua carteira; monitorar volume e tipo de tickets abertos; analisar tendências de performance para priorizar ações de CS; preparar relatórios para revisões periódicas.

Como solicitar acesso

Solicitar ao time de dados via [canal interno]. O acesso a workspaces e relatórios específicos é concedido conforme o papel e a squad.


Sidekiq

Times: N2

Para que serve

Painel de monitoramento de jobs assíncronos da plataforma (Ruby on Rails). Os jobs do Sidekiq processam tarefas em background como sincronização com ERPs, envio de webhooks e notificações. Quando uma integração falha silenciosamente, o Sidekiq costuma ser onde o erro fica registrado.

Casos de uso

Verificar se um job de sincronização está na fila de erros; reintentar jobs que falharam; inspecionar o payload de um job para entender o contexto de uma falha; monitorar filas congestionadas.

Como solicitar acesso

Solicitar ao time de infraestrutura/engenharia. O acesso ao painel Sidekiq requer VPN ativa e credenciais fornecidas pelo time técnico.


N8N

Times: N2

Para que serve

Plataforma de automação de fluxos de trabalho (low-code). É onde vivem as automações operacionais da plataforma — desde criação automática de cards no ClickUp a partir de eventos do datalake, até fluxos de reengajamento de sellers e integrações entre sistemas internos.

Casos de uso

Visualizar e depurar execuções de fluxos de automação; acompanhar erros em webhooks recebidos; monitorar o fluxo do projeto Impulsiona; verificar se um evento disparou corretamente.

Como solicitar acesso

Solicitar ao responsável técnico da squad (Solutions Architect ou N2 sênior). O acesso ao N8N é restrito a quem mantém as automações para evitar alterações não rastreadas em fluxos produtivos.


Zapier

Times:

Para que serve:

Como acessar>

Respondeu à sua pergunta?