Campos no Card Kanban
Selecione os dados que deseja ver.
Agenda Operacional de Implantação Guiada
Acompanhamento dinâmico das sessões do dia
Atendimentos Agendados para Hoje (0)
Próximos Dias Agendados (0)
Aguardando Escolha de Data / Link Enviado (0)
Indicadores & Performance Operacional IG
Métricas de conversão, reagendamentos, carteira por implantador e receita
Pendências Operacionais 0
Reuniões atrasadas ou pendentes de gravaçãoDistribuição por Status
Desempenho por Implantador
| Implantador | Total | Concluídos | Taxa |
|---|
Ajustes, Importação & Exportação de Dados
Importe planilhas de referência no formato da Implantação Guiada ou exporte os dados atuais
Importação / Exportação de Planilha
Compatível com todos os campos oficiais da planilha de Implantação Guiada
Solicitações Internas
Registre ou acompanhe suas demandas para o time de Operações
Nova Solicitação
Registre uma nova demanda ou solicitação de melhoria para o time de Operações
Acompanhar minhas Solicitações
Veja o histórico e status de todas as solicitações que você enviou
Central de Ajuda
Manual prático de uso do Bling LINK Operacional
Navegando pelo Kanban
O Kanban é a tela principal do sistema. Ele organiza todos os clientes em colunas que representam a fase atual da implantação. Cada cartão representa um cliente.
Como mover um cartão de fase:
- Clique no cartão do cliente para abrir o modal de detalhes.
- Vá até a aba Implantação.
- Altere o campo Status para a nova fase desejada.
- Clique em Salvar. O cartão se moverá automaticamente para a coluna correta.
Dica: Você também pode usar o botão de status diretamente no topo do cartão no Kanban para uma mudança rápida de fase.
O que significa cada coluna:
Criando um Novo Registro
Para adicionar um novo cliente à base:
- Clique no botão + Novo Registro, localizado na barra superior do Kanban (canto superior direito).
- Preencha os campos obrigatórios: Nome da empresa e Implantador.
- Preencha os demais campos conforme as informações disponíveis.
- Clique em Salvar. O novo cartão aparecerá na coluna correspondente ao status selecionado.
Editando Dados de um Cliente
Clique sobre qualquer cartão do Kanban ou linha da Planilha para abrir o painel de detalhes. O painel é dividido em abas:
💡 Dica: O painel direito exibe a linha do tempo de notas — registre interações, observações ou pendências com contexto de data e autor. As notas ficam visíveis para toda a equipe.
Módulos do Menu Lateral
Visão principal por colunas de status. Arraste ou edite cards para mover entre fases.
Todos os clientes em formato tabela. Ideal para busca rápida e visão geral.
Mostra as sessões agendadas para hoje, próximos dias e pendentes de data.
KPIs de taxa de conclusão, reagendamentos, volume financeiro e desempenho por implantador.
Registre e acompanhe demandas enviadas para o time de Operações (ex: melhorias, integrações).
Exclusivo do time Bling Loja Virtual. Registra ações e follow-ups dos clientes BLV.
Links Rápidos e Atalhos
Barra superior (Topbar):
- Campo de busca: Filtra em tempo real por empresa, contato ou qualquer campo visível.
- Filtro por implantador: Exibe apenas os cartões do profissional selecionado.
- Botão ☀️/🌙: Alterna entre o tema claro e escuro da área de trabalho.
Dentro de um Card (Kanban):
- 📱 WhatsApp: Abre o modal de disparo de mensagem pré-formatada para o cliente.
- 📹 Meet: Abre o link da reunião Google Meet configurado para o cliente.
- 💬 Octa: Abre a conversa desse cliente no Octadesk diretamente.
Documentação Técnica
Arquitetura, segurança e integrações do Bling LINK
Visão Geral — O que o sistema faz
O Bling LINK Operacional é uma aplicação web interna desenvolvida para o time de Implantação da Bling. Seu objetivo é centralizar o acompanhamento de clientes em processo de implantação do sistema Bling (ERP/e-commerce), substituindo planilhas manuais por um sistema colaborativo em tempo real.
O sistema gerencia dois times distintos com bases de dados separadas:
- IG (Implantação Guiada): Clientes do plano com acompanhamento humano direto.
- BLV (Bling Loja Virtual): Clientes com foco em implantação de loja virtual.
Stack de Tecnologias
O sistema usa tecnologias modernas, gratuitas ou de baixo custo, e não depende de grandes infraestruturas. Aqui está o que roda por trás:
HTML + CSS (Tailwind via CDN) + JavaScript puro. Sem frameworks como React ou Vue — roda direto no navegador.
Node.js com Express. Serve os arquivos estáticos e expõe uma API REST que o frontend consome. Roda localmente na porta 3000.
Supabase (PostgreSQL na nuvem). Armazena todos os registros de clientes, atividades e projetos. Também gerencia a autenticação de usuários.
helmet— Adiciona cabeçalhos de segurança HTTP em todas as respostas.cors— Controla quais origens podem chamar a API.express-rate-limit— Limita a quantidade de requisições por IP para evitar abuso.pg— Cliente do PostgreSQL usado pelo servidor.PapaParse— Lê e interpreta arquivos CSV para importação de planilhas.
Como o Frontend e o Backend se comunicam
Toda a comunicação entre a tela do usuário e o servidor segue o padrão REST — o frontend faz chamadas HTTP para rotas específicas do servidor, e o servidor responde em JSON.
O fluxo padrão de uma ação (ex: salvar um cliente) é:
- Usuário clica em Salvar no modal do cliente.
- O JavaScript chama a função
apiFetch('/api/clientes/123', { method: 'PUT', body: ... }). - A função
apiFetchinjeta automaticamente o token JWT do usuário no cabeçalhoAuthorization. - O servidor Express recebe a requisição, valida o JWT com o Supabase, e verifica se o e-mail do usuário está na lista de acessos permitidos (RBAC).
- Se tudo estiver correto, o servidor executa a operação no banco (Supabase/PostgreSQL) usando o token do usuário — o que garante que as regras de RLS (Row Level Security) sejam aplicadas.
- O banco retorna os dados atualizados. O servidor responde com o JSON. O frontend atualiza a tela sem recarregar a página.
| Método + Rota | Descrição |
|---|---|
| GET /api/auth/me | Valida o JWT e retorna os dados do usuário logado (nome, role, times). |
| GET /api/clientes | Lista todos os clientes da IG. |
| POST /api/clientes | Cria um novo cliente IG. |
| PUT /api/clientes/:id | Atualiza os dados de um cliente IG existente. |
| DELETE /api/clientes/:id | Remove um cliente IG. |
| GET /api/clientes-blv | Lista todos os clientes da BLV. |
| GET /api/timeline-cnpj/:cnpj | Retorna as notas combinadas de IG + BLV para um CNPJ. |
| GET /api/cross-lookup/:cnpj | Busca dados do mesmo CNPJ nos dois times simultaneamente. |
| GET /api/projetos | Lista as solicitações internas. |
| GET /api/atividades-blv | Lista as atividades registradas pelo time BLV. |
Segurança — Login, Proteção de Rotas e Banco de Dados
Autenticação via Magic Link (Supabase Auth)
Em vez de senha, o sistema usa um Magic Link enviado por e-mail. O fluxo é:
- Usuário informa o e-mail na tela de login e clica em Enviar Link de Acesso.
- O Supabase envia um e-mail com um link único e temporário (expira em 1 hora, uso único).
- Ao clicar no link, o Supabase valida o token e redireciona o usuário para
http://localhost:3000com um JWT (JSON Web Token) na URL. - O JavaScript do app detecta automaticamente o token da URL, estabelece a sessão e a armazena no
sessionStoragedo navegador (apagado ao fechar a aba). - O app verifica com o backend (
GET /api/auth/me) se o e-mail está na lista de usuários autorizados.
RBAC — Controle de Acesso por Perfil
O sistema possui dois perfis de usuário, definidos diretamente no server.js. Qualquer e-mail não listado recebe um erro 403 (acesso negado) mesmo que consiga se autenticar no Supabase:
| Perfil | E-mails autorizados | Times | Acesso extra |
|---|---|---|---|
| admin | [email protected] | IG + BLV | Ajustes, Documentação, todas as rotas |
| agent | [email protected] [email protected] | IG ou BLV | Módulos operacionais do seu time |
RLS — Segurança no Nível do Banco de Dados
O Supabase tem um mecanismo chamado Row Level Security (RLS). Funciona assim: mesmo que alguém descubra a URL do banco de dados, ele não consegue ler ou escrever dados sem um JWT válido de um usuário autenticado.
Quando o servidor faz uma operação no banco, ele usa o JWT do usuário (não uma chave de serviço global). Isso significa que o banco verifica individualmente se aquele usuário específico pode executar aquela operação — uma camada extra de proteção, independente do código do servidor.
clientes, clientes_blv, atividades_loja_virtual, gestao_projetos. Todas exigem autenticação para leitura e escrita.
Integrações e API — Como sistemas externos enviam dados
Sistemas externos como o Octadesk, Jestor ou qualquer automação (n8n, Zapier, Make) podem criar e atualizar registros no Bling LINK via chamadas HTTP à nossa API. Para isso é necessário um token de serviço (JWT de um usuário admin).
Exemplo: Criar um cliente IG via API externa
{
"empresa": "Empresa Exemplo LTDA",
"cnpj": "12.345.678/0001-90",
"nomeContato": "João Silva",
"whatsapp": "51999990000",
"emailDaEmpresa": "[email protected]",
"emailDaAgenda": "[email protected]",
"cidade": "Porto Alegre",
"estado": "RS",
"plano": "Premium",
"valorIG": 299.00,
"status": "Agendada",
"implantador": "Manu",
"agenda": "2026-09-15 14:00 - 15:30"
}
Exemplo: Registrar uma atividade BLV
{
"empresa": "Empresa Exemplo LTDA",
"titulo": "Follow-up pós-implantação",
"followup": "Cliente reportou dúvida sobre emissão de NF-e. Orientamos e enviamos tutorial.",
"criadoPor": "Luan Cavalheiro"
}
Exemplo: Atualizar o status de um cliente IG
{
"status": "Concluído",
"igRealizada": "Sim",
"informacoesPos": "Implantação concluída. Cliente apto para uso autônomo."
}
200 / 201— Operação bem-sucedida. Retorna o objeto JSON atualizado.400— Dados inválidos no corpo da requisição.401— Token JWT ausente, inválido ou expirado.403— E-mail do token não está na lista de acessos permitidos.404— Registro não encontrado.429— Limite de requisições atingido (rate limit: 500 req/min para API geral).500— Erro interno do servidor.