Documentação do AlwaysDesk
Tudo para instalar, atender e gerenciar o seu parque com o AlwaysDesk — do primeiro acesso à integração por API.
Introdução
O AlwaysDesk é uma ferramenta de acesso remoto para suporte técnico e times de TI. Com ele você acessa a tela de outro computador, controla teclado e mouse, conversa, transfere arquivos e mantém um inventário do parque — tudo com segurança e um painel de gestão.
- Aplicativo (Windows e macOS): usado pelo técnico e por quem recebe suporte.
- Portal do gestor: painel web para ver dispositivos, grupos, inventário e conectar pelo navegador.
- Central: administração da plataforma (empresas, planos, cobranças, licenças e clusters).
Instalação
Windows
- Baixe o aplicativo para Windows.
- Execute o arquivo. Não precisa de instalação complexa — abre pronto para usar.
- Para deixar o computador sempre disponível, ative Iniciar com o Windows nas Configurações do app.
macOS
Há versão para Mac (Apple Silicon e Intel). Solicite pelo site e enviamos o instalador. Na primeira execução, o macOS pede permissão de Gravação de Tela e Acessibilidade para quem vai ser atendido.
Primeiro acesso
- Abra o AlwaysDesk. Ele mostra Seu ID de suporte e um Código de acesso.
- Para acessar outro computador, digite o ID de 9 dígitos em “Acessar outro computador” e clique em Conectar.
- Informe o código de acesso que aparece no computador remoto (ou use a senha de gestor, no acesso permanente).
- A pessoa no computador remoto aprova a conexão e a sessão começa.
Suporte rápido (sem instalar)
Para quem só vai receber suporte, use o modo rápido. Ele abre uma janela enxuta apenas com o ID e o código de acesso, sem instalar nada. Ideal para enviar ao cliente na hora do atendimento.
Código de acesso e segurança
- Código por sessão: além do ID, cada conexão exige um código de acesso que muda a cada uso.
- Aprovação: quem está no computador aprova cada sessão e pode encerrar quando quiser.
- Conexão protegida: tudo o que passa entre os computadores trafega criptografado.
- Senhas protegidas no painel e bloqueio de tentativas repetidas.
- Senha para fechar: opcionalmente, fechar o aplicativo pede uma senha — útil em máquinas atendidas.
Durante a sessão
- Controle: ligue/desligue o envio de teclado e mouse a qualquer momento.
- Tela cheia: a barra se esconde e reaparece ao encostar o mouse no topo;
Escsai da tela cheia. - Qualidade: escolha entre automática, alta, média e econômica conforme a rede.
- Vários monitores: alterne entre as telas do computador remoto.
- Conversa, texto e arquivos: converse, envie um texto para a área de transferência e transfira arquivos.
Portal do gestor
Acesse em painel.alwaysdesk.com.br com seu e-mail e senha. Lá você:
- Vê todos os dispositivos, quem está online, e organiza por grupos.
- Registra um computador na conta (menu ••• do app → Registrar no portal do gestor → cole o código).
- Envia mensagens que aparecem em janela no computador (e recebe a resposta).
- Conecta com um clique — pelo navegador ou abrindo o app.
Inventário e relatórios
Cada computador registrado envia, na abertura e a cada 30 minutos, um inventário: sistema, processador, memória, discos, rede, antivírus, ativação do Windows e a lista de softwares com data de instalação. No detalhe do dispositivo você vê tudo em abas; em Relatórios há a visão do parque, alertas (disco cheio, antivírus desligado, sem contato) e o catálogo de softwares — com exportação em CSV.
Acesso pelo navegador
No portal, use Acessar computador (ou o botão do dispositivo) para controlar a máquina direto no navegador, sem instalar nada no computador do gestor. Pede o código de acesso ou a senha de gestor, como no app.
Acesso permanente (desacompanhado)
Para máquinas da sua equipe, defina uma senha de gestor no app (menu ••• → Acesso permanente do gestor). Com ela, o gestor conecta sem precisar de aprovação a cada vez — ideal para manutenção quando ninguém está na frente. O acesso por senha não gera aviso na tela, por ser desacompanhado.
Teste de 7 dias
Crie sua conta pelo site (Empresa ou Pessoa física) e use por 7 dias sem cartão. Ao fim do período, a conta trava e é liberada com a assinatura de um plano ou uma licença.
Licença e assinatura
- Teste de 7 dias por computador: o aplicativo completo mostra no topo quantos dias faltam. O prazo fica preso ao computador — reinstalar não reinicia o teste.
- Ao terminar o teste, o aplicativo trava e abre a janela de ativação com duas opções: Tenho uma chave ou Entrar na minha conta. Ao entrar na conta, o AlwaysDesk usa a licença disponível dela e vincula o computador.
- Vagas: cada licença ou plano libera um número de computadores. Se todas estiverem em uso, o aplicativo avisa para fazer upgrade ou pedir uma nova licença ao suporte. Em Assinatura, o gestor vê os computadores que usam a licença e pode liberar uma vaga ao trocar de máquina.
- O suporte rápido não precisa de licença.
- A qualquer momento: menu ••• do aplicativo → Inserir chave de licença.
API v1
API HTTP somente leitura, no escopo da sua conta, para integrar o AlwaysDesk a sistemas próprios e planilhas.
Autenticação
Crie uma chave no portal do gestor em API e integrações e envie no cabeçalho:
Authorization: Bearer adk_sua_chave
Base: https://api.alwaysdesk.com.br/v1
Endpoints
| Método | Rota | Descrição |
|---|---|---|
| GET | /summary | Total, online, offline, grupos e alertas. |
| GET | /devices | Lista de dispositivos. Filtros: ?q= e ?group=. |
| GET | /devices/{id} | Detalhes e inventário de um dispositivo. |
| GET | /groups | Seus grupos. |
Exemplo
curl -H "Authorization: Bearer adk_sua_chave" \
https://api.alwaysdesk.com.br/v1/devices
{
"devices": [
{ "device_id": "…", "name": "NTBK-DANIEL", "code": "547458134",
"online": 1, "group_name": "Suporte", "os": "Windows 11 Pro" }
]
}
Conectores: assistentes de IA, API e webhooks
Em Portal do gestor → Conectores você liga o AlwaysDesk a assistentes de IA, sistemas e automações. Cada conector enxerga somente os computadores da sua empresa e pode ser revogado a qualquer momento.
Assistentes de IA (Claude, ChatGPT, Cursor)
- Em Conectores → Assistentes de IA, clique em Novo conector, dê um nome e escolha o assistente.
- Marque Permitir enviar mensagens só se quiser que o assistente avise os usuários. Sem isso, ele apenas consulta.
- Copie o endereço gerado e cole no assistente (no Claude: Configurações → Conectores → Adicionar conector personalizado).
Depois é só perguntar: “Quais computadores estão offline?”, “Algum disco está quase cheio?”, “Mostre o inventário da recepção” ou “Avise o CAIXA-01 que haverá manutenção às 18h”.
Webhooks
Em Conectores → Webhooks, cadastre um endereço https do seu sistema e escolha os eventos: computador online, offline, registrado, desvinculado ou resposta recebida. Cada aviso chega em JSON, assinado no cabeçalho X-AlwaysDesk-Signature (HMAC-SHA256 com o segredo do webhook).
{ "event": "device.offline", "at": "2026-10-01T14:03:00.000Z",
"data": { "device_id": "…", "title": "Dispositivo ficou offline", "detail": "CAIXA-01" } }
Suporte
Precisa de ajuda? Fale com a gente:
- E-mail: [email protected]
- Site: www.gopixeltech.com.br
AlwaysDesk é desenvolvido pela GoPixel Tecnologia.