Como integrar os dados da Ahgora no Visio OS

por Lorenzo Lopez Head of Content, Visio 28 de out. de 2026

Para integrar os dados da Ahgora, o caminho que a documentação pública dela mostra é uma API REST descrita em OpenAPI 3.0, com Basic Auth, e, para a folha, uma exportação completa em CSV (páginas consultadas em 12/10/2026). Na camada de Dados do Visio OS, a Ahgora entra como fonte de gente: as batidas, as escalas e os afastamentos ficam por loja, junto com a venda do mesmo turno.

Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas.

Por que a Ahgora é uma fonte de gente que a venda sozinha não explica

Numa terça, a venda de uma loja cai. O PDV mostra o valor e deixa o motivo de fora. Uma parte da resposta está no turno: quantas pessoas estavam escaladas, quantas bateram o ponto, quantas estavam afastadas. Esse dado mora na Ahgora, e a pergunta da gestão precisa dele e do PDV ao mesmo tempo.

Quem quer cruzar os dois precisa extrair um relatório de cada sistema, limpar, conciliar e repetir a conta à mão a cada semana. O custo aparece em dois lugares: o número chega tarde e é disputado, e a pergunta que atravessa duas fontes nunca chega a ser feita. A venda caiu, e a explicação não está no dado de venda. É uma linha do tempo com muitas trilhas, e a Ahgora é uma delas.

A pergunta é sobre a operação, o turno e a loja. A camada não existe para vigiar pessoas, e o que ela entrega não é um indicador de cada funcionário.

O que a Ahgora documenta

As páginas públicas da Ahgora, consultadas em 12/10/2026, trazem três fatos sobre como tirar dado dela.

O primeiro é a API. A documentação da API da Ahgora, consultada em 12/10/2026, descreve uma API REST em OpenAPI 3.0, com Basic Auth, um teto de requisições por minuto e endpoints de funcionários, batidas, afastamentos e escalas. O valor do teto está na própria página, e é lá que o time o confere antes de desenhar a leitura.

O segundo é a exportação. A central da TOTVS, também consultada em 12/10/2026, documenta a exportação completa da folha em CSV.

O terceiro é uma ausência: nas páginas consultadas, a Ahgora não publica MCP próprio. A sua IA lê a Ahgora depois que o dado entra na camada, pelo MCP da Visio e com o seu login.

Quem vê o quê quando a Ahgora entra

Ponto e folha são dados de gente, e a permissão vem antes de qualquer pergunta. Na camada, ela é por usuário, por loja e por app, aplicada no dado: o gerente da loja 12 vê as vendas, a escala e o ponto da loja 12, e não vê a folha nem as vendas do grupo. A gestão vê o grupo inteiro. A mesma regra vale para a IA de cada um, que responde com o login de quem pergunta, e quem sai da empresa é desligado uma vez só.

Do lado da proteção, a Visio é a operadora do dado, e o DPA é público. O dado pessoal que entra fica cifrado e com o acesso registrado, e o que o grupo não quer dentro não entra. Se o grupo decide manter a folha fora, a exportação em CSV dela simplesmente não vira fonte. Os detalhes de segurança estão em como dar os dados da minha empresa para a IA com segurança.

O que muda quando a Ahgora entra por loja

Com a Ahgora na camada, a loja é a unidade. A escala e as batidas de cada loja ficam na mesma linha do tempo da venda do PDV e do extrato do banco da mesma loja, sob uma definição por número, escrita uma vez pela Visio. A atualização é de pelo menos todo dia, cada fonte na sua frequência de extração, e o mapeamento da operação diz, fonte por fonte, desde quando o dado é bom.

Isso troca o trabalho da gestão. Em vez de pedir a quem segura as planilhas, quem decide pergunta à IA que já usa, com o próprio login, e a análise de ontem é o começo da de hoje. As exceções ficam suas: a loja fechada para reforma ou a que mudou de endereço pertence à sua análise e não à verdade compartilhada.

Para mapear a Ahgora junto das outras fontes da sua operação, fale com um especialista.

Como avaliar o caminho da Ahgora: 5 critérios

A pergunta que você quer responder. A API separa batidas, escalas, afastamentos e funcionários em endpoints distintos. Defina quais a pergunta exige antes de ler todos.
A credencial. O acesso é por Basic Auth, o que pede um lugar seguro para guardá-la antes de a leitura existir.
O teto de requisições. A documentação fixa um limite por minuto. Planeje a leitura de modo que a rede inteira caiba nele.
Loja a loja. Escala e batida precisam chegar separadas por loja, senão a comparação entre duas lojas mistura turnos que não se cruzam.
A folha é um arquivo à parte. O CSV completo da folha é outro caminho, com outro público de leitura. Decida se ele entra e quem o enxerga.

Top 4 caminhos para integrar os dados da Ahgora

Dois caminhos nascem na Ahgora, o terceiro entra quando eles não servem e o quarto é a camada.

1. A API REST da Ahgora

É o caminho de máquina: um programa lê funcionários, batidas, afastamentos e escalas pelos endpoints documentados. Quem usa esse caminho recebe o dado da Ahgora e herda o resto do trabalho: definir o que é uma hora trabalhada, separar por loja, guardar a credencial e respeitar o teto de requisições.

2. A exportação completa da folha em CSV

É o caminho de arquivo. Alguém com acesso à Ahgora baixa o CSV da folha e o entrega a quem vai analisar. A frequência é a da pessoa que baixa, e o arquivo carrega a folha inteira, o que pede cuidado com quem pode abri-lo.

3. Um caminho de extração homologado

Quando a API não cabe na rotina do grupo e o arquivo não basta, o caminho é a forma feita com quem faz o sistema. Antes de construir algo por conta própria, verifique com a Visio se já existe um caminho de extração homologado para a Ahgora. Extração contra os termos de uso de um sistema fica fora de qualquer desenho.

4. A Ahgora como fonte da camada de Dados do Visio OS

Em qualquer dos caminhos, a Ahgora vira uma fonte de gente na camada, por loja e na mesma linha do tempo do PDV, do banco e da nota. A promessa de integração da Visio é esta: integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. Quais fontes estão ligadas numa operação é definido no mapeamento daquele cliente.

O que a Ahgora passa a responder junto do resto

Sobre a métrica já calculada e com o seu login, a IA responde o que as fontes juntas permitem:

Ahgora e PDV. Quantas pessoas cobriam o turno e quanto a loja vendeu nele. A pergunta «quem estava no turno quando a venda caiu» deixa de ser projeto.
Ahgora e a porta. A contagem de quem entrou, que chega pela camada de Sensores, ao lado da escala do mesmo horário.
Ahgora e afastamentos. Os afastamentos de uma loja lidos junto da venda da semana, sem pedir o relatório a quem segura a planilha.
Ahgora e a ferramenta de escala. A camada não monta a escala. A ferramenta de escala monta, com os insumos já carregados, e o resultado dela volta como dado.

A IA só lê: a Ahgora fica como está.

Comparativo dos caminhos para integrar a Ahgora

Critério	API REST	Exportação da folha em CSV	Caminho de extração homologado	Camada de Dados do Visio OS
O que expõe	Funcionários, batidas, afastamentos e escalas	A folha completa	Não mencionado nas páginas públicas	O que o caminho escolhido entrega, estruturado
Como se entra	OpenAPI 3.0 com Basic Auth	Arquivo baixado por quem tem acesso	Verificar com a Visio	Mapeamento da operação
Limite documentado	Teto de requisições por minuto	Não mencionado nas páginas públicas	Não mencionado nas páginas públicas	Frequência de extração: pelo menos todo dia
Quem vê	Quem tem a credencial	Quem recebe o arquivo, que traz a folha inteira	Não mencionado nas páginas públicas	Por usuário, por loja e por app, aplicada no dado

Opinião do Head of Content

Lorenzo Lopez, Head of Content da Visio, observa que a pesquisa por «como integrar os dados da Ahgora» esconde uma pergunta sobre o turno: por que a venda daquela loja foi o que foi. Para ele, a integração só vale quando a batida e a escala chegam por loja, na mesma linha do tempo da venda.

A posição dele é a de que a Ahgora acerta ao publicar uma API documentada em OpenAPI e ao documentar uma exportação, e de que o leitor ganha ao decidir primeiro o que a pergunta exige, antes de ler todos os endpoints. Na leitura dele, a camada de Dados do Visio OS é o lugar onde ponto e escala passam a contar na resposta da IA que o gestor já usa, sempre como dado da operação e nunca como nota de um funcionário.

Perguntas frequentes

A Ahgora tem API para integrar os dados?

Sim. A documentação da Ahgora, consultada em 12/10/2026, descreve uma API REST em OpenAPI 3.0, com Basic Auth, um teto de requisições por minuto e endpoints de funcionários, batidas, afastamentos e escalas.

É possível exportar a folha da Ahgora sem usar a API?

Sim. A central da TOTVS, consultada em 12/10/2026, documenta a exportação completa da folha em CSV. O arquivo carrega a folha inteira, então vale decidir antes quem pode abri-lo.

A Ahgora tem MCP oficial?

Nas páginas consultadas em 12/10/2026, a Ahgora não publica MCP próprio. A leitura pela sua IA acontece depois que o dado da Ahgora entra na camada, pelo MCP da Visio e com o seu login.

O gerente de uma loja vê o ponto de outra depois da integração?

Não. A permissão é por usuário, por loja e por app, aplicada no dado: o gerente da loja 12 vê a escala e o ponto da loja 12, e não vê a folha nem as vendas do grupo. A IA dele segue a mesma regra.

E se o caminho da Ahgora na minha operação não estiver claro?

Verifique com a Visio se já existe um caminho de extração homologado antes de construir. A Visio integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. O primeiro passo é o mapeamento de quais fontes a operação já tem e de como cada uma conecta.

Próximos passos

O próximo passo é o mapeamento das fontes que a sua operação já tem e de como cada uma conecta, a Ahgora entre elas. Se a pergunta que abriu esta leitura é sobre um turno específico, fale com um especialista sobre o caminho da Ahgora.

Para ver a camada completa, leia a página da camada de Dados.

Ver também

Conclusão

Integrar os dados da Ahgora começa pela pergunta: se ela precisa de batidas e escalas, a API REST as separa em endpoints; se precisa da folha, o CSV a traz inteira, e a decisão de quem pode abri-lo vem antes. Depois, a escala e as batidas entram na camada por loja, junto com a venda, e o turno passa a explicar a venda na resposta da IA que você já usa. Fale com um especialista da camada de Dados do Visio OS.

Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.