admin_delete
ChatGPTDELETE genérico na API HageLab em nome do usuário conectado: inativa (exclusão lógica) registros numa rota documentada. Contexto admin: só administradores (tipo 1 ou 2). Fluxo: leia instrucoes-ia.md e o contrato da rota (ler_pagina), consulte rota_permitida se tiver dúvida, chame com confirmar:false para obter a prévia e o previa_id, mostre a prévia ao usuário e, só depois do ok explícito, repita a mesma chamada com confirmar:true e o previa_id. Até 20 registros por confirmação (lote em operacoes, até 20 itens). Rotas de credenciais, execução financeira, exclusão irreversível e as cobertas por ferramenta específica (tag_, crm_) são recusadas com o motivo e a ferramenta indicada. A API continua conferindo permissão, dono e regras. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
admin_post
ChatGPTPOST genérico na API HageLab em nome do usuário conectado: cadastra registros numa rota documentada. Contexto admin: só administradores (tipo 1 ou 2). Fluxo: leia instrucoes-ia.md e o contrato da rota (ler_pagina), consulte rota_permitida se tiver dúvida, chame com confirmar:false para obter a prévia e o previa_id, mostre a prévia ao usuário e, só depois do ok explícito, repita a mesma chamada com confirmar:true e o previa_id. Até 20 registros por confirmação (lote em operacoes, até 20 itens). Rotas de credenciais, execução financeira, exclusão irreversível e as cobertas por ferramenta específica (tag_, crm_) são recusadas com o motivo e a ferramenta indicada. A API continua conferindo permissão, dono e regras. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
admin_put
ChatGPTPUT genérico na API HageLab em nome do usuário conectado: altera registros numa rota documentada. Contexto admin: só administradores (tipo 1 ou 2). Fluxo: leia instrucoes-ia.md e o contrato da rota (ler_pagina), consulte rota_permitida se tiver dúvida, chame com confirmar:false para obter a prévia e o previa_id, mostre a prévia ao usuário e, só depois do ok explícito, repita a mesma chamada com confirmar:true e o previa_id. Até 20 registros por confirmação (lote em operacoes, até 20 itens). Rotas de credenciais, execução financeira, exclusão irreversível e as cobertas por ferramenta específica (tag_, crm_) são recusadas com o motivo e a ferramenta indicada. A API continua conferindo permissão, dono e regras. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
arquivo_enviar
ChatGPTEnvia um PDF ou uma imagem (até 655360 bytes) e devolve o arquivo_id, sem link nem curl: o servidor faz o upload. No ChatGPT, use o anexo da conversa no campo arquivo (o servidor baixa o anexo, confere o tipo pelos bytes e não usa conteudo_base64); no Claude, envie o conteúdo em base64 no campo conteudo_base64, com nome e tipo. Informe só um dos dois. Sempre pede prévia antes (confirmar:false, nada é enviado); só envia com confirmar:true, o mesmo previa_id e o mesmo arquivo, depois do ok do usuário. Se o anexo expirar ou mudar entre a prévia e a confirmação, anexe de novo e gere nova prévia. Só administrador com sessão na empresa 0; estabelecimento escolhe a empresa dona do chamado ou da tag e tag_id liga o arquivo a ela. tipo: pdf ou o mime exato (application/pdf, image/jpeg, image/png, image/webp), conferido com os bytes do arquivo. O arquivo_id vai no campo file ou photo (crm_atualizar, chamados_abrir, chamados_atualizar, tag_etapa_adicionar) como {"arquivo_id": "..."}. Se o envio falhar depois de iniciado o resultado pode ser incerto: confira antes de refazer, com nova prévia. Com conteudo_base64 acima do limite (ou se o conteúdo não couber no argumento), use crm_arquivo_preparar e envie pelo link. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
buscar_docs
ChatGPTUse quando não sabe em qual página está a resposta. Aceita um termo ou a pergunta em frase completa (ex.: "Quantos chamados o cliente teve nos últimos 60 dias?"). Devolve páginas ordenadas por relevância, com trechos, seção (secao) e próximo passo; por padrão as 10 mais relevantes (limite), todas=true devolve todas as que casam. Ordem: buscar_docs primeiro, depois ler_pagina com o caminho e a seção que ela devolveu. Use escopo="api" para contrato de rotas (parâmetros, respostas, permissões) e escopo="manual" para saber como o usuário faz algo no App (tela, botão, passo a passo). Não chute nomes de página. Páginas administrativas (backlog e relatórios internos de validação) só aparecem com administrativas:true, em conta interna e a pedido explícito do usuário.
calibracao_arquivo_preparar
ChatGPTGera um link de upload de uso único (15 min) para enviar o PDF de um certificado de calibração (nome de 1 a 120 caracteres). Sempre devolve prévia (confirmar:false); só gera o link com confirmar:true depois do ok do usuário. A resposta traz a URL e um comando curl: o usuário envia o PDF com ele e a resposta do envio traz o arquivo_id, que vai em calibracao_enviar. O PDF não passa pelo conector. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; cliente só grava em produtos da própria empresa. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
calibracao_enviar
ChatGPTEnvia certificados de calibração para produtos. Cada item leva o PDF novo (arquivo_id, do link de calibracao_arquivo_preparar) ou, quando o certificado já existe em outro produto, reaproveita o PDF dele (calibracao_origem_id): o arquivo é duplicado e o original não muda. De 1 a 20 itens, que podem misturar as duas formas; cada item tem produto_id e exatamente um entre arquivo_id e calibracao_origem_id. Com arquivo_id: dt_val obrigatório e, opcionais, tipo_calibracao, observacoes e km; cada arquivo vale para um único certificado. Com calibracao_origem_id: só dt_val opcional (obrigatório quando o certificado de origem não é o ativo do produto de origem); a validação feita no original não é copiada. Cada item inativa o certificado ativo do produto e atualiza a validade dele. Sempre devolve prévia (confirmar:false) com validade atual e nova, certificado que será inativado e avisos; só grava com confirmar:true depois do ok do usuário, com o mesmo previa_id. O lote para no primeiro item que não gravou; os seguintes saem como não executados. Nunca exclui. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; cliente só grava em produtos da própria empresa. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
chamados_abrir
ChatGPTAbre um chamado de atendimento (categoria_id, descricao, lat e lng obrigatórios, nunca inventados: se o usuário não deu a localização, Informe a localização que você tem, sem inventar coordenadas: (a) a última posição conhecida do equipamento do chamado, consultada na API (origem_localizacao "equipamento"; posicao_em é opcional, com a data dessa leitura); (b) a estimativa de localização do usuário por IP que o seu cliente tiver (origem_localizacao "ip_usuario"); (c) a localização aproximada que o usuário informar, com cidade ou endereço convertidos em coordenadas com segurança ou as próprias coordenadas (sem origem_localizacao). Se nenhuma estiver disponível, pergunte ao usuário. O servidor não obtém localização por IP. A prévia mostra a localização como referencial. Informe origem_localizacao quando souber (equipamento ou ip_usuario; posicao_em opcional): a prévia mostra a localização como referencial. adicionais = campos da etapa de abertura por rótulo; produto_id e identificador opcionais). Antes de usar, leia chamados_descrever (categorias, etapas e a etapa de abertura): o conector valida obrigatórios, tipos e opções, não inventa campos nem escolhe etapa por nome. REGRA DA CONTA: sem conta_atendimento_id o chamado abre na conta padrão (Hage Desk, que atende a própria Hage: software e equipamentos), sem o usuário dizer nada; só use outra conta se o usuário pedir EXPRESSAMENTE, nunca por inferência. Qualquer cliente ou colaborador abre em qualquer conta de atendimento; administrador abre como Hage Desk; a empresa solicitante é cliente_id (vínculo por interessados) e, com produto_id, tem de ser o dono do equipamento (sem cliente_id e com equipamento de outra empresa a prévia recusa e mostra o dono: confirme com o usuário, o conector não preenche sozinho). O conector não executa nem confere a automação da etapa (onFieldChange): leia o código com chamados_descrever (incluir_automacao:true), faça você as consultas e cálculos e envie os campos já preenchidos; o conector só confere o contrato estático (campos existentes, tipo, obrigatórios não ocultos e opções cadastradas não vazias). Campos address, table, photo e schedule têm formato próprio (veja o formato de cada campo em chamados_descrever, operacao etapa): foto vai como {"arquivo_id"} de um upload (arquivo_enviar com o anexo do ChatGPT no campo arquivo ou, no Claude, conteudo_base64, ou crm_arquivo_preparar quando houver rede, com estabelecimento = conta de atendimento; só administrador com sessão na empresa 0), evento de agenda novo só por administrador com sessão na empresa 0; as recusas de campo trazem tipo (ausente, estrutura_invalida ou tipo_nao_suportado) e o caminho do problema. E-mail real só vai para os destinatários adicionais que você informar em emails (a prévia os destaca); notificações cadastradas na etapa ou na tag continuam por conta da API. Custo de R$ 0,50 por chamado, exige contrato de chamado ativo na conta. O conector não procura chamados parecidos: antes de abrir, consulte os chamados em aberto da conta (chamados_consultar, mesmo equipamento ou identificador) e decida com o usuário. Categoria que proíbe duplicidade é recusada. Sempre devolve prévia (confirmar:false) com a conta, a etapa e o corpo exato; só grava com confirmar:true e o previa_id, depois do ok do usuário. Campo de arquivo (file) não é suportado; foto (photo) só por upload de administrador. Nunca exclui. A permissão é a da sua sessão (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
chamados_atualizar
ChatGPTAltera um chamado existente (chamado_id). operacao editar: identificador, descricao, prev_inicio, prev_conclusao (aceita datas passadas; só equipe de atendimento e administrador; não cria histórico nem notifica); etapa: registra uma etapa do próprio chamado (etapa_id, adicionais por rótulo, descricao, lat, lng, responsaveis opcional que SUBSTITUI a lista inteira; só equipe e administrador; etapa de conclusão conclui o chamado); o conector não executa nem confere a automação da etapa (onFieldChange): leia o código com chamados_descrever (incluir_automacao:true), faça você as consultas e cálculos e envie os campos preenchidos; o conector só confere o contrato estático. Campos address, table, photo e schedule têm formato próprio (veja chamados_descrever, operacao etapa com chamado_id): foto vai como {"arquivo_id"} de um upload feito com arquivo_enviar (anexo do ChatGPT no campo arquivo; no Claude, conteudo_base64) ou, quando houver rede, crm_arquivo_preparar, sempre com estabelecimento = conta dona e tag_id = o chamado (só administrador com sessão na empresa 0) ou como URL de foto já gravada neste chamado; schedule recebe o id de um evento existente da agenda do campo ou {criar_evento: {titulo, inicio, fim, usuarios}} (só administrador com sessão na empresa 0; o evento só é criado na confirmação, sem convite por e-mail, e é cancelado se a gravação falhar de forma definitiva); as recusas de campo trazem tipo (ausente, estrutura_invalida ou tipo_nao_suportado) e o caminho do problema. O parâmetro emails (só em etapa e avaliar) envia e-mail real aos destinatários ADICIONAIS informados e a prévia os destaca; notificações cadastradas na etapa ou na tag continuam por conta da API; avaliar: avaliação do atendimento pelo cliente solicitante (etapa_id obrigatório, o da etapa de avaliação do chamado; chamado concluído, ainda sem avaliação; regrava a data de conclusão); comentar: comentário interno (interno:true, só equipe; o cliente não vê) ou externo (visível ao cliente, dispara as notificações de sempre). lat e lng são obrigatórios em etapa e nunca devem ser inventados; em comentar e avaliar são opcionais: sem eles o servidor usa a localização já registrada no próprio chamado (a prévia mostra "localização do chamado, não do usuário") e, se o chamado não tiver localização válida, recusa pedindo lat e lng. Se o usuário não deu a localização na etapa, Informe a localização que você tem, sem inventar coordenadas: (a) a última posição conhecida do equipamento do chamado, consultada na API (origem_localizacao "equipamento"; posicao_em é opcional, com a data dessa leitura); (b) a estimativa de localização do usuário por IP que o seu cliente tiver (origem_localizacao "ip_usuario"); (c) a localização aproximada que o usuário informar, com cidade ou endereço convertidos em coordenadas com segurança ou as próprias coordenadas (sem origem_localizacao). Se nenhuma estiver disponível, pergunte ao usuário. O servidor não obtém localização por IP. A prévia mostra a localização como referencial. Informe origem_localizacao quando souber (equipamento ou ip_usuario; posicao_em opcional): a prévia mostra a localização como referencial. Leia o chamado antes com chamados_consultar detalhar e as etapas com chamados_descrever. REGRA DA CONTA: a conta usada é sempre a dona real do chamado; conta_atendimento_id só vale se for a dona, e nunca deve ser trocada por inferência. O cliente só mexe em chamado em que é interessado. Sempre devolve prévia (confirmar:false) com a conta, o chamado e o que será enviado; só grava com confirmar:true e o previa_id, depois do ok do usuário. Se a gravação ocorrer e a releitura falhar, o resultado vem com aviso de conferência pendente: nunca grave de novo. Campo de arquivo (file) não é suportado. Nunca exclui nem altera a conta dona, o solicitante ou os interessados. A permissão é a da sua sessão (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada …
chamados_consultar
ChatGPTSó leitura. operacao pesquisar lista chamados com filtros (numero, chamado_id, categoria, etapa, status abertos|concluidos|atrasados|novos|todos, responsável, interessado_id = empresa solicitante, produto, datas de abertura/atualização/conclusão em ISO com fuso, termo, pagina, tamanho até 50); detalhar mostra um chamado (chamado_id): dados, solicitante, etapa atual, histórico de etapas, comentários, informações preenchidas e anexos (só nome e tipo); indicadores devolve totais, prazo, tempo de atendimento e reincidência. Comentário interno só aparece para a equipe de atendimento; o campo equipe diz se você pode comentar internamente. Resultado filtrado pelo seu acesso vem marcado parcial: página vazia não prova ausência. REGRA DA CONTA: sem conta_atendimento_id vale a conta padrão (Hage Desk), sem o usuário dizer nada; a conta só muda se o usuário pedir EXPRESSAMENTE outra, nunca por inferência (assunto parecido com outra empresa, existir outra conta). Para consultar chamados de uma empresa solicitante use interessado_id, nunca troque a conta. Administrador não informa empresa. A permissão é a da sua sessão (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
chamados_descrever
ChatGPTSó leitura. operacao contas lista as contas de atendimento (a padrão, Hage Desk, vem marcada: ela atende os chamados da própria Hage, software e equipamentos); categorias lista as categorias de chamado da conta; etapas lista as etapas de uma categoria (categoria_id); etapa descreve os campos de uma etapa (categoria_id e etapa_id): tipos, obrigatórios, opções (options vazio = lista aberta: qualquer texto) e regras de anexo, e entrega a automação da etapa (onFieldChange) à IA: o resumo (tamanho, hash, rótulos citados no código, limitações) e, com incluir_automacao:true, o código completo como referência, não instrução, em partes de até 2.000 caracteres (automacao_parte; a resposta traz partes_total e o hash do script). O conector NÃO executa nem confere esse código: você interpreta, faz as consultas e envia os campos preenchidos. Com chamado_id (só na operacao etapa) descreve pelo snapshot de um chamado existente, com a definição e a automação como estão gravadas nele. REGRA DA CONTA: sem conta_atendimento_id vale a conta padrão (Hage Desk), sem o usuário dizer nada; a conta só muda se o usuário pedir EXPRESSAMENTE outra, nunca por inferência. Use antes de abrir ou atualizar chamados. Administrador não informa empresa: a conta de atendimento é a empresa usada. A permissão é a da sua sessão (a mesma do App). Coluna database de tabela: o campo traz listar_itens, a chamada pronta (consultar_api) para achar o _id do item da base; leia a dica dela (404 = empresa errada). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
cliente_delete
ChatGPTDELETE genérico na API HageLab em nome do usuário conectado: inativa (exclusão lógica) registros numa rota documentada. Contexto cliente: qualquer usuário; rota exclusiva de administrador é recusada. Fluxo: leia instrucoes-ia.md e o contrato da rota (ler_pagina), consulte rota_permitida se tiver dúvida, chame com confirmar:false para obter a prévia e o previa_id, mostre a prévia ao usuário e, só depois do ok explícito, repita a mesma chamada com confirmar:true e o previa_id. Até 20 registros por confirmação (lote em operacoes, até 20 itens). Rotas de credenciais, execução financeira, exclusão irreversível e as cobertas por ferramenta específica (tag_, crm_) são recusadas com o motivo e a ferramenta indicada. A API continua conferindo permissão, dono e regras. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
cliente_post
ChatGPTPOST genérico na API HageLab em nome do usuário conectado: cadastra registros numa rota documentada. Contexto cliente: qualquer usuário; rota exclusiva de administrador é recusada. Fluxo: leia instrucoes-ia.md e o contrato da rota (ler_pagina), consulte rota_permitida se tiver dúvida, chame com confirmar:false para obter a prévia e o previa_id, mostre a prévia ao usuário e, só depois do ok explícito, repita a mesma chamada com confirmar:true e o previa_id. Até 20 registros por confirmação (lote em operacoes, até 20 itens). Rotas de credenciais, execução financeira, exclusão irreversível e as cobertas por ferramenta específica (tag_, crm_) são recusadas com o motivo e a ferramenta indicada. A API continua conferindo permissão, dono e regras. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
cliente_put
ChatGPTPUT genérico na API HageLab em nome do usuário conectado: altera registros numa rota documentada. Contexto cliente: qualquer usuário; rota exclusiva de administrador é recusada. Fluxo: leia instrucoes-ia.md e o contrato da rota (ler_pagina), consulte rota_permitida se tiver dúvida, chame com confirmar:false para obter a prévia e o previa_id, mostre a prévia ao usuário e, só depois do ok explícito, repita a mesma chamada com confirmar:true e o previa_id. Até 20 registros por confirmação (lote em operacoes, até 20 itens). Rotas de credenciais, execução financeira, exclusão irreversível e as cobertas por ferramenta específica (tag_, crm_) são recusadas com o motivo e a ferramenta indicada. A API continua conferindo permissão, dono e regras. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
consultar_api
ChatGPTFaz uma consulta GET (só leitura) na API HageLab em nome do usuário conectado; a API decide o que esta conta pode ver. Use para ler uma rota já conhecida. Ordem de leitura: primeiro a página instrucoes-ia.md (ler_pagina), depois o contrato da rota com buscar_docs ou ler_pagina; nunca suponha nomes de rota nem de parâmetros. Informe a rota sem barra inicial (ex.: produtos/paginar/20/1) e os parâmetros em parametros, ex.: {"excludeFields": "campo1,campo2"} nas listagens que aceitam esse parâmetro; para reduzir o peso de tags use paginar_tag_parts. Regra do excludeFields: é obrigatório em parametros nas listagens /paginar/ (menos cercas-virtuais e bases de dados), em tag-parts/get/<id>, tag-parts/get-chamado/<cliente>/<id> e tag-parts/info/<id>; sem ele a consulta não é enviada. Vazio ("") é a escolha consciente de não excluir. Em tags, chaves desconhecidas são ignoradas em silêncio e categoria é escalar. status=desvinculadas é recusado. Em tag-parts/get e tipo-checkpoint as automações (onFieldChange, onClick) saem por padrão e a resposta avisa; incluir_automacoes=true (argumento do conector, não da API) as traz. Em tipo-checkpoint/<id> (uma etapa), parametros {"onFieldChange": "true"} traz só o onFieldChange; nas listagens (paginar) ele nunca vem. Listagens de chamados (tag-parts/paginar-chamados e tag-parts/agrupar-chamados) são POST e não funcionam aqui: use paginar_tag_parts. A resposta começa com um cabeçalho de integridade (itens entregues, corpo truncado, resumo cortado, arrays reduzidos, como continuar); se Corpo truncado for sim, não conclua indicador com estes dados. Para pesar menos a resposta sem mudar a consulta, use manter (caminhos a conservar em cada item) ou resumo ({"por": "campo"}, contagem por valor); o cabeçalho de integridade continua sobre a resposta original da API. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado. Nas tags, excludeFields aceita caminhos (ex.: info.checkpoint, ultima_etapa.checkpoint, checkpoints) e os nomes curtos: checkpoint (em info[] e ultima_etapa), campos e onFieldChange (em info[], ultima_etapa, checkpoints e, em tag-parts/info, checklist). O aviso ignorado(s) lista os nomes que não existiam.
crm_agenda_evento
ChatGPTAdiciona, edita ou cancela evento na agenda Comercial (só ela), sem registrar etapa do CRM. Para agendar junto com uma etapa, use crm_atualizar com o campo de agendamento. Adicionar: tag do CRM opcional (com tag, título e descrição seguem a regra da agenda com os dados do lead; sem tag, titulo é obrigatório); confere horário, duração, expediente e conflito dos responsáveis, e sugere horários livres quando ocupado. Editar: só o que muda. Cancelar: status cancelado, com motivo opcional. Sempre devolve prévia (confirmar:false); só grava com confirmar:true depois do ok do vendedor. Quando há participantes, a API envia convite, reenvio ou cancelamento por e-mail: exige confirmar_convite:true. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
crm_arquivo_preparar
ChatGPTGera um link de upload de uso único (15 min) para enviar um PDF ou uma imagem ao CRM, opcionalmente ligado a uma tag. Sempre pede prévia antes (confirmar:false); só gera o link com confirmar:true depois do ok do vendedor. A resposta traz a URL e um comando curl; o arquivo enviado com esse comando devolve um arquivo_id, que vai no campo file ou photo do crm_atualizar. Foto de chamado (campo photo de chamados_abrir, chamados_atualizar ou tag_etapa_adicionar, só administrador com sessão na empresa 0): informe estabelecimento (a empresa dona do chamado) e, se o chamado já existe, o tag_id dele; o arquivo_id vai no campo como {"arquivo_id": "..."}. tipo: pdf ou o mime exato (application/pdf, image/jpeg, image/png, image/webp). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
crm_atualizar
ChatGPTAvança ou registra uma etapa do funil comercial e/ou atualiza dados básicos de uma tag do CRM (identificador, alias, previsão de conclusão, título). Descobre as etapas e os campos na hora. Sempre devolve prévia (confirmar:false); só grava com confirmar:true, depois do ok do vendedor. Cada etapa registrada dispara as notificações configuradas dela à equipe e os e-mails da etapa (a prévia lista destinatário e texto). Os campos calculados pelo App (números, valores, receita, probabilidade, parcelas) são calculados aqui e listados na prévia; o que não é simulado aparece em avisos. Agendamento (schedule): evento na agenda Comercial; participantes recebem convite só com confirmar_convite:true. Arquivo (file/photo): [{arquivo_id}] de um arquivo enviado com arquivo_enviar (direto) ou crm_arquivo_preparar (link, para quem tem rede). Modo corrigir (modo:"corrigir", com etapa, campos e motivo): troca valores do ÚLTIMO registro daquela etapa, com prévia antes/depois; a correção NÃO renotifica, não reenvia e-mails e não recalcula os registros posteriores (a prévia os lista). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
crm_cliente_base
ChatGPTAdiciona ou edita um cliente na base de clientes do comercial. Sempre busca antes pelo campo único (CNPJ) e nunca adiciona se já existir: devolve o existente e orienta editar. Sempre devolve prévia (confirmar:false); só grava com confirmar:true, depois do ok do vendedor. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
crm_descrever
ChatGPTSó leitura. Com tag_id, resume uma tag do CRM: etapa atual, último valor de cada campo (com a etapa, quem gravou e quando), Número da Proposta e pendências simples (cadastro vinculado sem CNPJ, Empresa com espaço sobrando); use como primeiro passo para entender uma tag. Com etapa (id ou nome), descreve os campos da etapa: rótulo, tipo, obrigatório, opções, se o conector aceita, calcula ou não grava (com motivo), formato das tabelas e dos agendamentos, e-mails, título e prazo calculados e bloqueios simulados. Com base:"clientes", descreve o layout da base de clientes (campos, chave única, tabela Contatos). Sem parâmetros, lista as etapas ativas. Use antes de crm_atualizar para montar os campos certos. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
crm_lead_novo
ChatGPTCria um lead na etapa Lead do funil comercial. O autor do lead é o usuário do conector (o seu usuário), não um robô. Sempre pede prévia antes (confirmar:false); só grava com confirmar:true depois do ok do vendedor. Consome a cota diária de leads e dispara o alerta de WhatsApp da equipe se ninguém atender em 2 min. Não use para teste. Reenvio do mesmo e-mail e telefone não duplica. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
ler_pagina
ChatGPTUse depois de buscar_docs, com o caminho e a seção que ela devolveu, para ler a página com o texto completo; também serve para ler uma página inteira ou só as linhas com um termo (filtro). Não chute caminhos. Se truncada, continue com inicio = proximo_inicio (vale também com filtro). Devolve hash_doc (hash da página inteira, em qualquer modo de leitura): é a prova de leitura que consultar_api, paginar_tag_parts e as ferramentas de escrita exigem em hashes_docs. Páginas administrativas (backlog e relatórios internos de validação) só aparecem com administrativas:true, em conta interna e a pedido explícito do usuário.
listar_paginas
ChatGPTUse para navegar pelo índice da documentação quando não há um termo claro, ou se buscar_docs não achou nada. Lista páginas com título e descrição, opcionalmente por prefixo de caminho. Se vier truncada, use pular = proximo_pular ou prefixo para filtrar. Depois, leia a página escolhida com ler_pagina. Páginas administrativas (backlog e relatórios internos de validação) só aparecem com administrativas:true, em conta interna e a pedido explícito do usuário.
paginar_tag_parts
ChatGPTConsulta paginada de tag-parts na API HageLab, em nome do usuário conectado. É só leitura: o método é POST apenas porque os filtros vão no corpo. Use para listar tags e chamados: a é o tamanho da página (máximo 10001), b é o número da página a partir de 1, filtros (corpo) só filtram as entradas do histórico info[] de cada tag; os filtros da listagem (categoria, status, datas, interessados, cliente_id, order) vão em parametros, a query da URL, ex.: {"categoria": "<id>", "status": "andamento", "excludeFields": "checkpoints,info.checkpoint,ultima_etapa.checkpoint"}. categoria é escalar: para chamados, uma consulta por categoria. excludeFields é obrigatório em parametros (vazio "" é permitido, como decisão de não excluir). Em parametros, chaves desconhecidas são ignoradas em silêncio. status=desvinculadas é recusado (grava dados na API), use outro status ou nenhum. Ordem de leitura: primeiro a página instrucoes-ia.md (ler_pagina), depois o contrato de tag-parts/paginar com buscar_docs ou ler_pagina; o guia de consulta de tags é a página Guia de consulta de tags: do fluxo ao filtro (modulos/tag_parts/guia-consulta-tags.md). Nunca suponha filtros. A resposta começa com um cabeçalho de integridade (itens entregues de total do servidor, corpo truncado, como continuar): se Corpo truncado for sim, não conclua indicador com estes dados e repita com excludeFields ou página menor. Para pesar menos a resposta sem mudar a consulta, use manter (caminhos a conservar em cada item) ou resumo ({"por": "campo"}, contagem por valor); o cabeçalho de integridade continua sobre a resposta original da API. Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado. Nas tags, excludeFields aceita caminhos (ex.: info.checkpoint, ultima_etapa.checkpoint, checkpoints) e os nomes curtos: checkpoint (em info[] e ultima_etapa), campos e onFieldChange (em info[], ultima_etapa, checkpoints e, em tag-parts/info, checklist). O aviso ignorado(s) lista os nomes que não existiam.
rota_permitida
ChatGPTConsulta, sem gravar nada, se a política do conector libera uma escrita (rota, verbo e contexto) e, se não, o motivo e a ferramenta indicada. liberada:true significa só ausência de bloqueio do conector: a API ainda confere permissão, dono e regras. Não exige hashes_docs. Devolve as páginas da documentação que descrevem a rota com esse verbo.
tag_duplicar
ChatGPTCria uma tag nova a partir de outra da sua empresa (tag_id), só no modo planejamento: leva o cabeçalho da categoria e, das etapas pedidas em etapas, os registros ainda abertos, com horários do plano deslocados pela diferença de prev_inicio. Serve também para criar tag numa categoria que já tem uma tag: duplique com etapas vazias e registre a primeira etapa com tag_etapa_adicionar. Responsáveis, produto, empresa anexada, contatos e e-mails vêm da origem; a tag nova não entra na rotina nem no grupo. Para trocar as paradas use tag_editar com acao plano_rota. Repetir a mesma duplicação devolve a tag já criada. Sempre devolve prévia (confirmar:false); só grava com confirmar:true depois do ok do usuário. Nunca exclui nem altera a origem. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; a permissão é a da API (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
tag_editar
ChatGPTEdita uma tag existente. acao dados: altera só identificador, alias_identificador, descricao, prev_inicio, prev_conclusao, prev_next_step e privativa (categoria, cliente, produto, início, conclusão e contatos não mudam por aqui); acao plano_rota: substitui o plano de rota já gravado pelo plano completo novo (campos opcional ajusta outros campos da mesma etapa, sem temperatura; paradas existentes mantêm o id; paradas já executadas não podem sair; o conector não calcula rota; serviceTime em SEGUNDOS). Sempre devolve prévia (confirmar:false) com o antes e depois; só grava com confirmar:true depois do ok do usuário. Nunca exclui. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; a permissão é a da API (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
tag_etapa_adicionar
ChatGPTRegistra uma etapa numa tag (tag_id, tipo_checkpoint, adicionais por rótulo de campo). Antes de usar, leia a etapa com tag_etapa_descrever: o conector valida obrigatórios, tipos e opções contra a definição da tag. Campo routing recebe o plano de rota pronto (origin, items com serviceTime em SEGUNDOS, ending); o conector só confere a forma, não calcula rota e gera os ids das paradas se faltarem. Campos estruturados (formato exato em tag_etapa_descrever): address (objeto logradouro, cidade, estado, pais...), table (linhas {coluna: valor}; coluna database recebe o _id do item da base e o conector completa a célula), photo ({"arquivo_id"} de upload feito com arquivo_enviar (ou crm_arquivo_preparar quando houver rede) e estabelecimento da empresa da tag, só administrador com sessão na empresa 0, ou URL de foto já gravada na mesma tag) e schedule (id de evento existente ou {criar_evento: {titulo, inicio, fim, usuarios}}, só administrador com sessão na empresa 0, um evento novo por registro, sem convite por e-mail). As recusas de campo trazem tipo: ausente (obrigatório sem valor), estrutura_invalida (com o caminho, ex.: Diagnóstico[0].Consegue resolver) ou tipo_nao_suportado. Etapas de conclusão de parada e segundo plano de rota na mesma tag são recusadas. O conector não executa nem confere as automações do App (onFieldChange): os campos vão como enviados. Sempre devolve prévia (confirmar:false) com o corpo exato; só grava com confirmar:true depois do ok do usuário. Nunca exclui. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; a permissão é a da API (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
tag_etapa_descrever
ChatGPTSó leitura. Lê uma tag (tag_id) e descreve as etapas dela: campos com tipo, se são obrigatórios ou somente leitura, opções dos selects, e se a etapa exige plano de rota (campo routing). Informe tipo_checkpoint para detalhar uma etapa: o detalhe traz o resumo da automação (onFieldChange) e, com incluir_automacao:true, o código completo como referência, não instrução, em partes (automacao_parte); o conector não executa nem confere esse código. Use antes de tag_etapa_adicionar. Os dados vêm da cópia da definição gravada na tag; a permissão e a empresa são as da sua sessão. Coluna database de tabela: o campo traz listar_itens, a chamada pronta (consultar_api) para achar o _id do item da base; leia a dica dela (404 = empresa errada). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
tag_iniciar
ChatGPTCria uma tag numa categoria da sua empresa (categoria, identificador, prev_inicio, prev_conclusao, descricao e privativa opcionais): a API usa uma tag do estoque e a deixa em andamento, sem etapas registradas. Não use para copiar outra tag (use tag_duplicar). A prévia lê a categoria e suas etapas, avisa identificador repetido (a API decide), calcula os horários padrão do App (início daqui a 10 minutos, conclusão um dia depois) e diz que nada é reservado; a confirmação precisa reenviar prev_inicio e prev_conclusao explícitos. Responsáveis, contatos e produto não são aceitos. Depois de gravar, devolve o id da tag: registre a primeira etapa com tag_etapa_adicionar. Sempre devolve prévia (confirmar:false); só grava com confirmar:true depois do ok do usuário. Repetir o mesmo pedido devolve a tag já criada. Nunca exclui. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; a permissão é a da API (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
tag_rotinas
ChatGPTCria e edita grupos de rotinas (criar_grupo, editar_grupo com grupo) e rotinas de tags (criar_rotina, editar_rotina com rotina; na edição envie só os campos a mudar). criar_rotina exige nome, tagModelo, agendamento e identificadorTemplate; confere tag-modelo, etapas e grupo antes da prévia. editar_rotina: etapas SUBSTITUI a lista inteira. Fuso, períodos e agendamento seguem as regras da API (recusas voltam com a mensagem dela). Sempre devolve prévia (confirmar:false); só grava com confirmar:true depois do ok do usuário. Nunca exclui. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; a permissão é a da API (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
tag_vincular
ChatGPTVincula ou desvincula tags filhas (ids, de 1 a 20) a uma tag pai (tag_id). A prévia lê a tag pai e cada filha: tag inexistente ou de outra empresa bloqueia, e as já vinculadas (ou não vinculadas, no desvincular) são ignoradas. Com acao vincular_sensores ou desvincular_sensores liga ou solta caixas (produto_ids, de 1 a 20, date opcional ISO com fuso) numa tag iniciada; só para empresa e colaborador (administrador é recusado); a prévia mostra os produtos sem IMEI e avisa o que a API vai recusar. Sempre devolve prévia (confirmar:false); só grava com confirmar:true depois do ok do usuário. Não exclui tags. Empresa: a da sua sessão; só administrador pode enviar estabelecimento (id da empresa) para gravar em nome de um cliente; a permissão é a da API (a mesma do App). Exige o parâmetro hashes_docs: o hash_doc de instrucoes-ia.md e o de uma página que documenta esta rota ou ferramenta (ler_pagina devolve hash_doc). Reutilize os hashes já obtidos na conversa; releia só se a chamada responder desatualizado.
versao_docs
ChatGPTUse para saber se a documentação mudou desde a última leitura (versão, data de publicação e commit). Não serve para responder perguntas sobre o sistema; para isso use buscar_docs.