Conectar seu sistema ao Controller

Tempo estimado: 5 minutos · Pré-requisito: 1 computador onde seu sistema exporta planilhas/CSV.

Por que isso?

Seu sistema de gestão (ex: SisAtendi, Tasy, Nimbi, ou outro) não tem uma API pública para nos conectar diretamente. Mas ele exporta relatórios em CSV ou Excel — e é isso que vamos ler.

O Controller Bridge é um pequeno programa que roda no computador onde os relatórios ficam. Ele:

✅ Lê os arquivos da pasta que você indicar
✅ Manda pro Controller automaticamente todo dia
✅ Roda em background, sem você precisar abrir nada
❌ NÃO mexe no seu sistema de gestão
❌ NÃO envia dados além dos que estão na pasta indicada

Criar o agente no Controller (1 min)

Acesse Conectores → Bridge Agents e clique em + Novo Bridge Agent
Nome: algo identificável, ex: Recepção PC1
Tipo: Folder CSV (CLI) (não mude se tiver dúvida)
Clique em Criar e gerar código

A próxima tela vai mostrar o comando de instalação e o tempo de validade do token (30 minutos).

💡Mantenha essa tela aberta. O token expira em 30 minutos — depois disso você gera um novo no mesmo lugar.

Instalar no Windows (3 min)

2.1 Abrir PowerShell como Administrador

Pressione Windows
Digite PowerShell
Botão direito → Executar como Administrador
Aviso de segurança aparecer → clique Sim

⚠️Precisa ser como Administrador. Sem isso, o serviço Windows não consegue ser registrado, e o Bridge não vai voltar sozinho após reiniciar o PC.

2.2 Colar o comando do dashboard

Use o botão 📋 Copiar da tela do Controller. O comando vai parecer com:

powershell -ExecutionPolicy Bypass -Command "iwr 'https://controller.12brain.org/api/bridge-install?token=XXX' -UseBasicParsing | iex"

Cole no PowerShell, pressione Enter.

2.3 Aguarde os 8 passos

==> Controller Bridge Installer
   Agent: Recepção PC1
   Server: https://controller.12brain.org

[1/8] Node v20.10.0 OK
[2/8] Criando C:\ProgramData\ControllerBridge
[3/8] Baixando pacote do agent...
[4/8] Extraindo em C:\ProgramData\ControllerBridge\agent
[5/8] Instalando dependencias...
[6/8] Pareando com Controller...
[7/8] Salvando config em C:\ProgramData\ControllerBridge\config.json
[8/8] Registrando servico...
Servico Windows registrado e iniciado.

==> Conectado com sucesso!

💡Pronto. O agente está instalado e rodando. Pode fechar o PowerShell.

Apontar para a pasta dos relatórios (1 min)

Agora o agente está conectado, mas ainda não sabe qual pasta ler.

Volte ao Controller → Bridge Agents → clique no agente recém-criado
Status deve estar Active ✅
Clique em + Adicionar Source
Preencha conforme tabela abaixo

Campo	O que colocar	Exemplo
Nome	identifica a fonte	Agenda diária
Caminho	pasta onde seu sistema exporta	C:\Relatorios\Agenda
Tipo de dado	o que esses arquivos representam	Agendamentos
Coluna ID	qual coluna é o ID único	ID
Coluna Nome	nome do paciente/cliente	Paciente
Coluna Data	data/hora do registro	DataHora

💡Não sabe os nomes das colunas? Abra um dos CSV/XLSX no Excel e veja a primeira linha — ela mostra os nomes.

Clique em Salvar e testar. Se tudo certo:

✓ Lemos 132 registros.
✓ 132 inseridos. 0 erros.

Confirmar que está sincronizando

No dashboard, aba Recent Sync Runs, você verá uma linha verde:

Started     Source           Status     Read   Ins   Skip
há 30s      Agenda diária    ✅ success  132   132   0

A partir daqui, o agente vai sincronizar sozinho todo dia às 06:00 (ou no horário que você escolher).

Perguntas frequentes

Vou precisar deixar o computador sempre ligado?

Sim, no horário do sync (default 06:00). Mas você não precisa fazer login — o serviço roda em background, mesmo na tela de bloqueio.

Meu sistema não exporta CSV. Tem outro jeito?

Sim — extensão Chrome, exportação manual ou conexão direta com banco local. Mas o caminho mais simples é configurar seu sistema pra exportar planilhas numa pasta. Quase todos suportam isso.

Posso ter mais de 1 PC com Bridge?

Sim. Cada computador tem seu próprio agente. Você pode ter um na recepção (agendamentos), outro no financeiro (boletos), outro no estoque.

É seguro? O que acontece com meus dados?

Lê apenas a pasta que você apontou. Nada além.
Conexão sempre criptografada (HTTPS).
Logs locais não contêm senhas nem tokens.
Você pode revogar o agente a qualquer momento no dashboard — para imediatamente.

Aparece um aviso vermelho do Windows quando rodo o comando

SmartScreen pode reclamar porque o programa ainda não está com assinatura oficial. Clique em Mais informações → Executar mesmo assim. Estamos publicando a versão assinada em breve.

Aparece "Node não encontrado"

Instale Node.js do site oficial: nodejs.org (versão LTS). Depois rode o comando do Passo 2 novamente.

Como desinstalar?

No PowerShell como Administrador:

controller-bridge-agent service uninstall

Depois apague C:\ProgramData\ControllerBridge. Pronto.

Linux / macOS

Existe uma versão bash equivalente para distribuições com systemd:

curl -fsSL "https://controller.12brain.org/api/bridge-install.sh?token=XXX" | bash

macOS ainda não suportado nativamente.

Algo deu errado?

Status amarelo (Offline): o computador desligou ou perdeu internet. Liga o PC, espera 1 minuto.
Status vermelho (Error): veja "Last error" no dashboard.
Não consegue passar do Passo 2? Mande pro suporte:
- O texto vermelho que apareceu no PowerShell
- O nome do seu antivírus (Avast, Kaspersky, etc.)

Suporte: suporte@12brain.org