Contele Fleet
Conectar
Contele Fleet + Inteligência Artificial

Pergunte e a sua frota responde

Perguntar é só o começo.

  • Consultar qualquer coisa da frota
  • Alterar cadastros do sistema inteiro
  • Lançar abastecimento e manutenção
  • Criar cerca eletrônica
  • Gerar relatório sob medida
  • Montar dashboard do jeito que você pede
  • Apontar o pior ponto da frota
Quero conectar Ver tudo que ele faz →
O que é o MCP

Você vê uma conversa e a Contele cuida do resto

O MCP é a ponte oficial entre o Contele Fleet e a sua IA. Usar é simples assim, e toda a parte pesada fica com a gente.

Como funciona

Do login ao primeiro insight em 3 passos

1

Conecte seu assistente

Cole o endereço no seu app de IA. Sem instalar nada.

2

Entre com sua conta Contele

O mesmo e-mail e senha do app, numa página segura da Contele.

3

Pronto, pode perguntar

Criamos um token de API Aberta para você, e ele é revogável a qualquer momento.

Por que existe

O dado da frota, na velocidade da pergunta

Relatório exige abrir tela, filtrar e exportar. Aqui a resposta chega pronta no chat, a qualquer hora do dia.

Menos telasUma pergunta substitui filtros, exportações e planilhas
Respostas com contextoO assistente cruza ferramentas e explica o número
Onde você já estáNo chat de IA que você usa todo dia, no celular ou no desktop
Sob seu controleChave da sua conta, escopo da sua organização, revogável
Experimente perguntar

Três prompts prontos para copiar

Cole no seu assistente e receba um dashboard em HTML feito na hora, com os dados reais da sua frota.

Ranking de motoristasPontuação geral 0–100, justa por KM rodado

PedidoMonte um ranking dos meus motoristas dos últimos 90 dias, com uma pontuação geral de 0 a 100 para cada um. ConsidereMultas (quantidade, valor e gravidade), eventos de direção agressiva (frenagens, acelerações e curvas fortes), excessos de velocidade, KM rodado e validade da CNH. Como calcularPesos: 40% condução, 30% multas, 20% velocidade e 10% documentação. Normalize pelo KM rodado de cada motorista, para ser justo com quem roda mais, e mostre a nota de cada critério separada. EntregaUm dashboard em HTML, num arquivo único, com o pódio dos 3 melhores, a tabela completa por critério, quem mais evoluiu no período e os 3 pontos de atenção mais urgentes.

Relatório de checklistsPreenchimento, reprovações e pendências

PedidoFaça um relatório completo dos checklists da minha frota no último mês. LevanteOs modelos de checklist em uso, a taxa de preenchimento por veículo e por motorista, os itens mais reprovados e os veículos com pendências abertas. CruzamentosCompare com as manutenções: aponte reprovações que ainda não viraram ordem de serviço e há quantos dias estão paradas. EntregaUm dashboard em HTML, num arquivo único, com resumo executivo no topo, gráfico de preenchimento semana a semana, ranking de itens reprovados e a lista de pendências priorizada por risco.

Custo geral da frotaCombustível, multas e manutenção por veículo

PedidoLevante o custo total da minha frota nos últimos 3 meses, agrupado por veículo e seccionado por categoria. CategoriasCombustível (litros, valor e consumo médio em km/l), multas (quantidade, valor e gravidade) e manutenção (preventivas e corretivas, com o custo de cada ordem). AnálisesCompare os 3 meses entre si, destaque qualquer variação acima de 15% e calcule o custo por KM rodado de cada veículo. EntregaUm dashboard em HTML, num arquivo único, com os totais gerais no topo, gráfico de evolução mensal por categoria, ranking dos veículos mais caros por KM e uma seção final de recomendações de economia.

Conectar

Escolha o seu assistente

Não precisa instalar nada nem programar: você adiciona a conexão com o endereço abaixo e pronto. O login com a sua conta Contele acontece uma única vez, no primeiro acesso — depois é só perguntar.

O endereço
https://cgv-prd-mcp-api.contele.io/mcp
É só isto que você cola no assistente
Seu login Contele · só no primeiro acesso
e-mail e senha do app
Pedido só no primeiro acesso — criamos a chave por você
Na interface · claude.ai
  1. Vá em Configurações → Conectores.
  2. Clique no + → Adicionar conector personalizado e cole o endereço.
  3. Ao conectar, faça login com sua conta Contele na página que abre.

O único da lista que aceita conectores MCP também no plano gratuito, além do Pro e do Max.

No terminal · Claude Code
$ claude mcp add --transport http contele https://cgv-prd-mcp-api.contele.io/mcp

Na primeira pergunta sobre a frota, o Claude Code abre o navegador para você entrar com sua conta Contele.

Na interface · app do Gemini
  1. Abra Apps conectados no app web do Gemini.
  2. Adicione um app personalizado com o endereço.
  3. Faça login com sua conta Contele na página que abre.
No terminal · Gemini CLI
$ gemini mcp add -t http contele https://cgv-prd-mcp-api.contele.io/mcp

Se pedir autorização, rode /mcp auth contele dentro do Gemini CLI — abre o navegador para o login Contele.

Na interface · chatgpt.com
  1. Ative o modo desenvolvedor em Configurações → Apps → Avançado.
  2. Em Configurações → Conectores → Criar, dê um nome e cole o endereço.
  3. Faça login com sua conta Contele na página que abre.

Disponível nos planos Plus, Pro e Business.

No terminal · Codex CLI
$ codex mcp add contele --url https://cgv-prd-mcp-api.contele.io/mcp $ codex mcp login contele

O segundo comando abre o navegador para você entrar com sua conta Contele.

Ou pelo arquivo de configuração
# ~/.codex/config.toml [mcp_servers.contele] url = "https://cgv-prd-mcp-api.contele.io/mcp"
Usa outro assistente? Qualquer aplicativo com suporte a MCP conecta do mesmo jeito: adicione um servidor MCP apontando para https://cgv-prd-mcp-api.contele.io/mcp e entre com sua conta Contele quando ele pedir.

Não encontrou a opção de conectores? Ela pode depender do seu plano. Nesse caso, peça ao seu time de TI para habilitar uma vez e depois é só usar.

Ferramentas

83 ferramentas à disposição do seu assistente

Esta lista vem direto do catálogo do servidor: é exatamente o que o assistente enxerga ao conectar.

Posição atual da frota

consulta Posição e trajetos

Ferramenta: obter_posicao_atual

Mostra onde cada veículo está agora: endereço, velocidade e ignição, direto do rastreador.

Exemplos de pergunta
“Onde está a van FLA-2231?”“Onde está cada veículo da frota agora?”
Bom saber
  • Sem informar um veículo, retorna a frota inteira de uma vez
Parâmetros
vehicle_idopcionalID do veículo; omita para toda a frota

Trajeto por período

consulta Posição e trajetos

Ferramenta: listar_trackings_por_periodo

Reconstrói o trajeto de um veículo entre duas datas, ponto a ponto.

Exemplos de pergunta
“Por onde a van 12 passou ontem?”
Bom saber
  • Período máximo de 3 meses por consulta
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
vehicle_idID do veículo

Último trecho de rota

consulta Posição e trajetos

Ferramenta: obter_ultimo_trecho_rota

Retorna os pontos do trecho de rota mais recente de um veículo.

Exemplos de pergunta
“Qual foi o último trecho rodado do carro 5?”
Bom saber
  • Para a posição de agora, prefira Posição atual da frota
Parâmetros
file_route_idID do arquivo de rota
vehicle_idID do veículo

Dados do rastreador

consulta Posição e trajetos

Ferramenta: buscar_info_modulo

Consulta os dados técnicos do rastreador instalado, buscando por placa ou número de série.

Exemplos de pergunta
“Qual o rastreador instalado na placa ABC1D23?”
Parâmetros
typebuscar por série ("modulo") ou "placa"
valueo número de série ou a placa, conforme "type"

Listar veículos

consulta Veículos, KM e rotas

Ferramenta: listar_veiculos

Lista todos os veículos cadastrados, com os dados de cadastro.

Exemplos de pergunta
“Quais veículos temos na frota?”
Parâmetros
vehicle_idopcionalfiltra por um ID de veículo específico

Detalhes do veículo

consulta Cadastro de veículos, gatilhos e grupos

Ferramenta: buscar_veiculo_por_id

Traz o cadastro completo de um veículo específico.

Exemplos de pergunta
“Quais os dados do veículo 12?”
Parâmetros
vehicle_idID interno do veículo

Gatilhos de KM do veículo

consulta Cadastro de veículos, gatilhos e grupos

Ferramenta: listar_gatilhos_km_veiculo

Lista os marcos de quilometragem configurados para um veículo (lembretes por KM).

Exemplos de pergunta
“Quais gatilhos de KM o carro 5 tem?”
Parâmetros
vehicle_idID do veículo

Gatilhos de horímetro do veículo

consulta Cadastro de veículos, gatilhos e grupos

Ferramenta: listar_gatilhos_horimetro_veiculo

Lista os marcos de horas de uso configurados para um veículo.

Exemplos de pergunta
“Quais gatilhos de horímetro a escavadeira tem?”
Parâmetros
vehicle_idID do veículo

Grupos de veículos

consulta Cadastro de veículos, gatilhos e grupos

Ferramenta: listar_grupos_veiculos

Lista os grupos de veículos da organização.

Exemplos de pergunta
“Quais grupos de veículos existem?”
Parâmetros
group_nameopcionalfiltra por nome do grupo
per_pageopcional
pageopcional
statusopcional

Criar veículos

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: criar_veiculos

Cadastra um ou mais veículos novos na frota.

Exemplos de pergunta
“Cadastra a van placa ABC1D23, modelo Sprinter”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
vehiclesveículos a criar

Editar veículo

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: editar_veiculo

Atualiza o cadastro de um veículo: dados, tipo, combustível, hodômetro, metas, documentos, ícone, e-mails, estágio, câmera ou status.

Exemplos de pergunta
“Corrige a placa do carro 7 para XYZ2A34”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
vehiclevehicle_id e status obrigatórios

Criar gatilhos de KM

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: criar_gatilhos_km

Cria lembretes por quilometragem para veículos.

Exemplos de pergunta
“Me avisa quando o carro 5 chegar em 100.000 km”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
km_triggers

Criar gatilhos de horímetro

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: criar_gatilhos_horimetro

Cria lembretes por horas de uso para veículos.

Exemplos de pergunta
“Avisa quando o gerador completar 500 horas”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
hourmeter_triggers

Criar grupo de veículos

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: criar_grupo_veiculos

Cria um grupo de veículos, já podendo vincular veículos a ele.

Exemplos de pergunta
“Cria o grupo Entregas SP com os carros 3, 5 e 8”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
group_namenome do grupo (único na organização)
vehicle_idsIDs dos veículos (a API exige pelo menos um)

Editar grupo de veículos

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: editar_grupo_veiculos

Renomeia um grupo ou troca os veículos vinculados a ele.

Bom saber
  • A lista de veículos enviada substitui a atual
  • O assistente confirma os dados com você antes de executar
Parâmetros
group_idID do grupo (uuid)
group_namenome do grupo (reenvie o atual se não mudar)
vehicle_idslista COMPLETA dos veículos do grupo: o que ficar de fora é removido (reenvie a atual se não mudar)

Definir grupos do veículo

escrita Cadastro de veículos, gatilhos e grupos

Ferramenta: definir_grupos_do_veiculo

Define de quais grupos um veículo faz parte.

Bom saber
  • A lista enviada vira a lista final de grupos do veículo
  • O assistente confirma os dados com você antes de executar
Parâmetros
vehicle_idID do veículo
group_idsIDs (uuid) dos grupos finais do veículo

Buscar veículos

consulta Veículos, KM e rotas

Ferramenta: buscar_veiculos

Procura veículos por placa, grupo ou tipo, com filtros e paginação.

Exemplos de pergunta
“Quais os veículos do grupo Entregas?”
Parâmetros
search_termopcionalbusca por placa/nome
vehicle_idopcional
statusopcional
group_idopcionalfiltra por grupo
limitopcional
offsetopcional

Relatório de KM do veículo

consulta Veículos, KM e rotas

Ferramenta: obter_relatorio_km

Calcula a distância rodada por um veículo num período.

Exemplos de pergunta
“Quanto o carro 5 rodou essa semana?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
vehicle_idID do veículo
limitopcional
offsetopcional

Relatório de KM da frota

consulta Veículos, KM e rotas

Ferramenta: obter_relatorio_km_frota

Calcula a distância rodada por todos os veículos num período, numa única consulta.

Exemplos de pergunta
“Quanto a frota rodou em agosto?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
filter_groupopcionalrestringe a um grupo

Relatório de rotas do veículo

consulta Veículos, KM e rotas

Ferramenta: obter_relatorio_rotas

Relatório de viagens de um veículo: paradas, trechos e tempos.

Exemplos de pergunta
“Quais as viagens do carro 3 na sexta?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
vehicle_idID do veículo
limitopcional
offsetopcional

Relatório de rotas do grupo

consulta Veículos, KM e rotas

Ferramenta: obter_relatorio_rotas_grupo

Relatório de viagens de vários veículos de uma vez.

Exemplos de pergunta
“Compara as rotas dos carros 12, 15 e 20 essa semana”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
vehicles_idsIDs dos veículos separados por vírgula, ex.: "12,15,20"
limitopcional
offsetopcional

Rotas por motorista

consulta Veículos, KM e rotas

Ferramenta: obter_rotas_por_motorista

Viagens agrupadas por motorista num período.

Exemplos de pergunta
“Por onde o motorista João rodou ontem?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
driver_idID do motorista
limitopcional
offsetopcional

Listar motoristas

consulta Motoristas

Ferramenta: listar_motoristas

Lista os motoristas da organização, com busca e paginação.

Exemplos de pergunta
“Quais motoristas estão ativos?”
Parâmetros
search_termopcionalbusca por nome/CNH
statusopcionalfiltra por status
offsetopcional
limitopcional

Relatório de motoristas

consulta Motoristas

Ferramenta: obter_relatorio_motoristas

Relatório consolidado por motorista: CNH, multas e indicadores de condução.

Exemplos de pergunta
“Como está o desempenho dos motoristas neste mês?”
Parâmetros
indicators_start_dateinício dos indicadores (yyyy-MM-dd)
indicators_end_datefim dos indicadores (yyyy-MM-dd); máximo de 3 meses após o início

Odômetro atual do veículo

consulta Motoristas

Ferramenta: obter_odometro_atual_veiculo

Última leitura de hodômetro registrada pelo rastreador de um veículo.

Exemplos de pergunta
“Qual a quilometragem atual do carro 2?”
Parâmetros
vehicle_idID do veículo

Criar motoristas

escrita Motoristas

Ferramenta: criar_motoristas

Cadastra um ou mais motoristas, já definindo quais veículos podem dirigir.

Bom saber
  • Cada motorista precisa de ao menos um veículo, grupo ou tipo permitido
  • O assistente confirma os dados com você antes de executar
Parâmetros
drivers

Editar motorista

escrita Motoristas

Ferramenta: editar_motorista

Atualiza o cadastro de um motorista: contato, CNH, permissões ou status.

Bom saber
  • Desativar um motorista também o desvincula dos veículos
  • O assistente confirma os dados com você antes de executar
Parâmetros
driverid, document e status sempre presentes. Campo vazio ou 0 mantém o valor atual (só email pode ser limpo)

Vincular motorista ao veículo

escrita Motoristas

Ferramenta: vincular_motorista_veiculo

Vincula um motorista a um veículo, podendo defini-lo como motorista padrão.

Exemplos de pergunta
“Coloca o João como motorista padrão da van 12”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
driver_idID do motorista
vehicle_idID do veículo
type_attachmentopcional"default" = motorista padrão do veículo

Desvincular motorista do veículo

escrita Motoristas

Ferramenta: desvincular_motorista_veiculo

Remove o vínculo entre um motorista e um veículo.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
driver_id
vehicle_id
type_attachmentopcional

Listar pontos de interesse

consulta Pontos de interesse

Ferramenta: listar_pontos_de_interesse

Lista os locais cadastrados: bases, clientes, postos e outros pontos.

Exemplos de pergunta
“Quais pontos de interesse temos cadastrados?”
Parâmetros
nameopcionalfiltra por nome
addressopcionalfiltra por endereço
type_idopcional
per_pageopcional
pageopcional

Sugerir pontos de interesse

consulta Pontos de interesse

Ferramenta: sugerir_pontos_de_interesse

Autocompleta pontos por nome ou endereço, ranqueado por relevância e proximidade.

Exemplos de pergunta
“Procura postos perto do centro”
Parâmetros
qtermo de busca (nome ou endereço parcial)
latopcionallatitude para ranquear por proximidade
lngopcionallongitude para ranquear por proximidade
limitopcional

Tipos de ponto de interesse

consulta Pontos de interesse

Ferramenta: listar_tipos_de_ponto

Lista as categorias de ponto de interesse: posto, cliente, base e outras.

Parâmetros
nameopcional
statusopcional

Criar ponto de interesse

escrita Pontos de interesse

Ferramenta: criar_ponto_interesse

Cadastra um novo local no mapa da operação.

Exemplos de pergunta
“Cadastra o cliente Alfa na Av. Paulista, 1000”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
namenome do ponto
type_idID (uuid) do tipo de ponto — veja listar_tipos_de_ponto
lat
lng
addressopcionalendereço completo
complementopcionalcomplemento do endereço
identification_documentopcionalCNPJ ou CPF do local, só dígitos
contact_nameopcional
phone_numberopcional
emailopcional
observationopcional

Editar ponto de interesse

escrita Pontos de interesse

Ferramenta: editar_ponto_interesse

Atualiza os dados de um ponto de interesse existente.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
idID (uuid) do ponto — veja listar_pontos_de_interesse
nameopcional
type_idopcional
latopcional
lngopcional
addressopcional
complementopcionalcomplemento do endereço
identification_documentopcionalCNPJ ou CPF do local, só dígitos
contact_nameopcional
phone_numberopcional
emailopcional
observationopcional

Listar abastecimentos

consulta Abastecimentos

Ferramenta: listar_abastecimentos

Lista os abastecimentos registrados: data, litros, valor, posto e veículo.

Exemplos de pergunta
“Quais os abastecimentos do carro 3 no mês?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd); máximo de 3 meses após start_date
vehicle_idopcional
vehicle_idsopcional
driver_idsopcional
limitopcional
pageopcional

Resumo de abastecimentos

consulta Abastecimentos

Ferramenta: resumo_abastecimentos

Números consolidados de abastecimento no período: gasto total, litros e médias.

Exemplos de pergunta
“Quanto gastei de combustível em julho?”
Parâmetros
start_perioddata inicial (yyyy-MM-dd)
end_perioddata final (yyyy-MM-dd)
vehicle_idsopcional
driver_idsopcional

Consumo de combustível por veículo

consulta Abastecimentos

Ferramenta: consumo_combustivel_por_veiculo

Consumo médio (km/l) e gasto por veículo, para comparar eficiência.

Exemplos de pergunta
“Qual veículo faz menos km por litro?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
vehicle_idopcional

Registrar abastecimentos

escrita Abastecimentos

Ferramenta: registrar_abastecimentos

Registra abastecimentos manualmente, um ou vários de uma vez.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
fuels

Editar abastecimento

escrita Abastecimentos

Ferramenta: editar_abastecimento

Corrige um abastecimento já registrado.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
fuel_idID do abastecimento
vehicle_idopcional
driver_idopcional
fuel_dateopcionalyyyy-MM-dd HH:mm:ss
litersopcional
total_valueopcional
liter_valueopcional
fuel_type_idopcionaltipo de combustível: 1 Gasolina comum, 2 Etanol comum, 3 Diesel S10, 4 Gás natural, 5 Biodiesel, 6 Elétrico, 7 Gasolina aditivada, 8 Etanol aditivado, 9 Diesel S500, 10 Diesel S10 aditivado, 11 GNV
fully_filledopcional1 tanque cheio, 0 parcial
odometeropcionalhodômetro SEMPRE em quilômetros (km), como aparece no painel do veículo; nunca em metros ou milhas. O servidor converte para a unidade interna
hourmeter_in_secondsopcionalhorímetro em SEGUNDOS (horas × 3600), só para máquinas (type_vehicle_id 6); veículos comuns usam odometer
fuel_methodopcionalgas_station posto, internal_pomp bomba interna
gas_station_idopcionalID (uuid) do posto: ponto de interesse do tipo posto, veja listar_pontos_de_interesse; algumas organizações exigem o posto em todo abastecimento
payment_type_idopcionalID da forma de pagamento cadastrada na organização (payment_type_id/payment_type_name aparecem em listar_abastecimentos); ID inválido é rejeitado
arla_total_valueopcionalvalor total do Arla 32, até 2 casas
arla_liters_quantityopcionallitros de Arla 32, até 3 casas
latopcionallatitude do abastecimento
lngopcionallongitude do abastecimento
statusopcional1 ativo, 0 inativo
fuel_observationopcional

Listar multas

consulta Multas

Ferramenta: listar_multas

Lista as multas: data, valor, veículo, motorista e gravidade.

Exemplos de pergunta
“Quais multas tivemos em agosto?”
Parâmetros
search_termopcional
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd); máximo de 3 meses após start_date
vehicle_idsopcional
driver_idsopcional
pageopcional
per_pageopcional

Detalhes da multa

consulta Multas

Ferramenta: obter_multa

Detalhes completos de uma multa específica.

Parâmetros
fine_idID da multa

Resumo de multas

consulta Multas

Ferramenta: resumo_multas

Totais de multas no período: quantidade, custo e gravidade.

Exemplos de pergunta
“Quanto pagamos de multa no trimestre?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
driver_idsopcional
vehicle_idsopcional

Multas por motorista

consulta Multas

Ferramenta: multas_por_motorista

Multas consolidadas por motorista, com custo e pontos na CNH.

Exemplos de pergunta
“Qual motorista tem mais multas?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
driver_idsopcional
search_termopcional

Registrar multa

escrita Multas

Ferramenta: registrar_multa

Registra uma multa manualmente para um veículo e motorista.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
vehicle_id
driver_id
fine_detailsdetalhes da multa

Editar multa

escrita Multas

Ferramenta: editar_multa

Atualiza os dados de uma multa registrada.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
fine_idID da multa
vehicle_id
driver_id
fine_detailstodos os campos atuais da multa, com as alterações aplicadas

Listar manutenções

consulta Manutenção

Ferramenta: listar_manutencoes

Lista as ordens de manutenção: veículo, tipo, status e custo.

Exemplos de pergunta
“Quais manutenções estão abertas?”
Parâmetros
maintenance_statusopcionalfiltra por status
search_termopcional
vehicle_idsopcional
plan_idsopcional
per_pageopcional
pageopcional

Detalhes da manutenção

consulta Manutenção

Ferramenta: obter_manutencao

Detalhes completos de uma ordem de manutenção.

Parâmetros
maintenance_idID da manutenção

Resumo de manutenções

consulta Manutenção

Ferramenta: resumo_manutencoes

Totais de manutenção no período: custo por tipo e por status.

Exemplos de pergunta
“Quanto gastamos de manutenção no mês?”
Parâmetros
start_perioddata inicial (yyyy-MM-dd)
end_perioddata final (yyyy-MM-dd)
group_vehicle_idsopcional

Listar planos de manutenção

consulta Manutenção

Ferramenta: listar_planos_manutencao

Lista os planos preventivos, como trocar óleo a cada 10 mil km.

Parâmetros
search_labelopcional
vehicle_idsopcional
per_pageopcional
pageopcional

Itens do plano de manutenção

consulta Manutenção

Ferramenta: listar_itens_do_plano

Mostra o que um plano de manutenção cobre e a periodicidade de cada item.

Parâmetros
plan_idID do plano
search_termopcional
per_pageopcional
pageopcional

Criar manutenção

escrita Manutenção

Ferramenta: criar_manutencao

Abre uma ordem de manutenção para um veículo, com itens e dados do serviço.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
itemsopcionalitens da manutenção (ex.: troca de óleo, pastilha)
historyopcionalhistórico de eventos da ordem
vehicle_id
status_idopcionalstatus: 0 agendada, 1 em andamento, 2 atrasada, 3 concluída
detailsdatas da manutenção
serviceopcionaldados do serviço; sem OS ainda, deixe os campos no padrão (o objeto precisa existir)

Reagendar manutenção

escrita Manutenção

Ferramenta: reagendar_manutencao

Move uma manutenção para outra data no calendário.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
maintenance_idID (uuid) da manutenção
new_start_datenova data (yyyy-MM-dd)

Atualizar status da manutenção

escrita Manutenção

Ferramenta: atualizar_status_manutencao

Muda o status de uma manutenção, como abrir ou concluir.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
maintenance_idID (uuid) da manutenção
maintenance_statusnovo status

Editar manutenção

escrita Manutenção

Ferramenta: editar_manutencao

Atualiza uma ordem de manutenção existente.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
itemsopcionalitens da manutenção; reenvie os atuais, a lista substitui a anterior
historyopcionalhistórico de eventos da ordem; ausente mantém o atual
idID (uuid) da manutenção
vehicle_idID do veículo da manutenção
status_idopcionalstatus: 0 agendada, 1 em andamento, 2 atrasada, 3 concluída
detailsdatas da manutenção (reenvie as atuais se não mudarem)
serviceopcionaldados do serviço; sem OS ainda, deixe os campos no padrão (o objeto precisa existir)

Criar plano de manutenção

escrita Manutenção

Ferramenta: criar_plano_manutencao

Cria um plano preventivo com regras por KM, horas ou tempo.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
namenome do plano
descriptionopcional
due_date_configopcionalconfiguração de avisos de vencimento
itemsopcionalitens/regras do plano
vehiclesveículos cobertos pelo plano (a API exige pelo menos um)

Editar plano de manutenção

escrita Manutenção

Ferramenta: editar_plano_manutencao

Atualiza nome, avisos e itens de um plano preventivo.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
idID (uuid) do plano
namenome do plano (reenvie o atual se não mudar)
descriptionopcional
due_date_configopcional
itemsopcional
vehiclesveículos cobertos pelo plano (reenvie os atuais se não mudarem)

Duplicar plano de manutenção

escrita Manutenção

Ferramenta: duplicar_plano_manutencao

Clona um plano existente com todas as regras e itens.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
plan_idID (uuid) do plano a duplicar

Ativar ou desativar planos

escrita Manutenção

Ferramenta: atualizar_status_planos

Ativa ou desativa vários planos de uma vez.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
plan_idsIDs (uuid) dos planos
status1 ativa, 0 desativa

Listar itens de manutenção

consulta Itens de manutenção

Ferramenta: listar_itens_base

Lista o catálogo de itens de manutenção da organização, como troca de óleo e pastilha de freio.

Parâmetros
search_labelopcionalbusca pelo nome do item
include_disabledopcional
pageopcional
per_pageopcional

Criar item de manutenção

escrita Itens de manutenção

Ferramenta: criar_item_base

Adiciona um item novo ao catálogo, controlado por KM ou por horas de uso.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
namenome do item
milestone_type"odometer" controla por KM; "hourmeter" por horas

Editar item de manutenção

escrita Itens de manutenção

Ferramenta: editar_item_base

Renomeia um item do catálogo ou troca o tipo de controle.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
idID do item base
namenome do item (reenvie o atual se não mudar)
milestone_type

Vínculos do item com veículos

consulta Itens de manutenção

Ferramenta: listar_vinculos_item_base

Mostra em quais veículos um item está vinculado e o status em cada um.

Parâmetros
base_item_idID do item base
search_labelopcionalbusca por veículo
status_on_vehicleopcionalfiltra pelo status do item no veículo
pageopcional
per_pageopcional

Progresso dos itens por veículo

consulta Itens de manutenção

Ferramenta: obter_progresso_itens_vinculados

Mostra quanto falta, em KM, horas ou dias, para cada item vencer em cada veículo.

Exemplos de pergunta
“Quais veículos estão perto da troca de óleo?”
Parâmetros
bound_item_idsIDs dos vínculos item-veículo

Listar usuários

consulta Usuários e acessos

Ferramenta: listar_usuarios

Lista as contas de login da organização.

Bom saber
  • Criação e edição de usuários é feita só pelo sistema Contele Fleet, por segurança
Parâmetros
search_termopcionalbusca por nome/email
statusopcional
limitopcional
offsetopcional

Detalhes do usuário

consulta Usuários e acessos

Ferramenta: obter_usuario

Detalhes de uma conta de usuário específica.

Parâmetros
user_idID do usuário

Níveis de acesso

consulta Usuários e acessos

Ferramenta: listar_niveis_de_acesso

Lista os perfis de permissão da organização.

Bom saber
  • Gerenciamento de níveis de acesso é feito só pelo sistema, por segurança
Parâmetros
nameopcional
per_pageopcional
pageopcional

Eventos de câmera

consulta Câmeras e chip

Ferramenta: listar_eventos_camera

Eventos detectados pela câmera com IA: fadiga, distração, uso de celular e colisão.

Exemplos de pergunta
“Teve alerta de fadiga essa semana?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd)
driver_idsopcional
vehicle_idsopcional
event_typesopcional
search_termopcional
pageopcional
limitopcional

Resumo de eventos de câmera

consulta Câmeras e chip

Ferramenta: resumo_eventos_camera

Totais dos eventos de câmera no período.

Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd); máximo de 3 meses após start_date
driver_idsopcional
event_typesopcional

Dados do chip

consulta Câmeras e chip

Ferramenta: obter_dados_chip

Dados do chip de conectividade do rastreador, por número de série.

Parâmetros
serial_numbernúmero de série do rastreador

Comandos enviados

consulta Comandos do rastreador

Ferramenta: listar_comandos

Histórico de comandos enviados aos rastreadores, com status e data.

Exemplos de pergunta
“Quais comandos foram enviados ao carro 9?”
Parâmetros
search_termopcional
type_commandopcionalfiltra por tipo de comando
vehicle_idopcional
statusopcionalfiltra por status
offsetopcional
limitopcional

Tipos de comando

consulta Comandos do rastreador

Ferramenta: listar_tipos_comando

Lista os tipos de comando disponíveis para os rastreadores.

Parâmetros
Nenhum — é só chamar.

Status de firmware

consulta Comandos do rastreador

Ferramenta: obter_status_firmware

Status da atualização de firmware de um rastreador.

Parâmetros
serial_numbernúmero de série do rastreador

Ajustar horímetro do rastreador

escrita Comandos do rastreador

Ferramenta: ajustar_horimetro_rastreador

Corrige o horímetro do rastreador para o valor total real, em segundos.

Bom saber
  • O valor enviado substitui o total atual
  • O assistente confirma os dados com você antes de executar
Parâmetros
commands

Ajustar odômetro do rastreador

escrita Comandos do rastreador

Ferramenta: ajustar_odometro_rastreador

Corrige o hodômetro do rastreador para o valor total real, em metros.

Bom saber
  • 1 km equivale a 1.000 metros; o valor substitui o total atual
  • O assistente confirma os dados com você antes de executar
Parâmetros
commands

Listar eventos

consulta Eventos, alarmes e cercas

Ferramenta: listar_eventos

Eventos gerais de rastreamento por período: cercas, alarmes e ignição.

Exemplos de pergunta
“O que aconteceu com a frota ontem?”
Parâmetros
start_datedata/hora inicial ISO UTC (ex.: 2026-08-01T00:00:00Z)
end_datedata/hora final ISO UTC (ex.: 2026-08-15T23:59:59Z); máximo de 3 meses após start_date
vehicle_idids de veículos separados por vírgula (ex.: "12,15,20"); para a frota toda, mande todos os ids — sem esse filtro a consulta expira
driver_idopcional
type_event_idopcionalfiltra por tipo de evento
limitopcionalitens por página
offsetopcionalpágina (começa em 1)

Eventos de direção agressiva

consulta Eventos, alarmes e cercas

Ferramenta: listar_eventos_direcao_agressiva

Frenagens bruscas, acelerações e curvas fortes num período.

Exemplos de pergunta
“Teve frenagem brusca do João essa semana?”
Parâmetros
start_perioddata inicial (yyyy-MM-dd)
end_perioddata final (yyyy-MM-dd); máximo de 3 meses após start_period
driver_idsopcional
vehicle_idsopcional
limitopcional
offsetopcional

Resumo de eventos

consulta Eventos, alarmes e cercas

Ferramenta: resumo_eventos

Totais de eventos por tipo no período.

Parâmetros
start_perioddata inicial (yyyy-MM-dd)
end_perioddata final (yyyy-MM-dd); máximo de 3 meses após start_period
vehicle_idsopcional
driver_idsopcional

Listar cercas virtuais

consulta Eventos, alarmes e cercas

Ferramenta: listar_cercas

Lista as cercas virtuais: nome, status, limite de velocidade e veículos vinculados.

Parâmetros
search_termopcionalbusca pelo nome da cerca
statusopcional1 = ativa, 0 = inativa
limitopcional
offsetopcional

Criar cerca virtual

escrita Eventos, alarmes e cercas

Ferramenta: criar_cerca

Desenha uma cerca virtual no mapa, com limite de velocidade e veículos vinculados.

Exemplos de pergunta
“Cria uma cerca em volta do depósito”
Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
namenome da cerca
coordinatesvértices do polígono NA ORDEM em que se ligam, como um "ligue os pontos": cada ponto se conecta ao seguinte e o último volta ao primeiro (não repita o primeiro ponto no fim). Mínimo 3 pontos. Ordem errada cria uma cerca com o formato trocado.
speed_in_km_hopcionallimite de velocidade dentro da cerca
vehiclesopcionalIDs dos veículos vinculados
all_vehiclesopcionaltrue aplica a todos os veículos da empresa
show_mapopcionalexibir a cerca no mapa (padrão true); só pode ser definido na criação

Editar cerca virtual

escrita Eventos, alarmes e cercas

Ferramenta: editar_cerca

Altera nome, área, limite de velocidade ou veículos de uma cerca existente.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
fence_idID da cerca
nameopcional
coordinatesopcionalnovo polígono; substitui o anterior por inteiro. Vértices NA ORDEM em que se ligam, como um "ligue os pontos": cada ponto se conecta ao seguinte e o último volta ao primeiro (não repita o primeiro ponto no fim). Mínimo 3 pontos.
speed_in_km_hopcional
vehiclesopcional
all_vehiclesopcional
statusopcional1 = ativa, 0 = inativa

Marcar eventos como analisados

escrita Eventos, alarmes e cercas

Ferramenta: marcar_eventos_analisados

Dá baixa em eventos já revisados, em lote.

Bom saber
  • O assistente confirma os dados com você antes de executar
Parâmetros
event_idsIDs dos eventos
analyzedtrue marca como analisado, false desmarca

Listar checklists

consulta Checklists

Ferramenta: listar_checklists

Lista os checklists preenchidos pelos motoristas.

Exemplos de pergunta
“Quais checklists foram preenchidos hoje?”
Parâmetros
start_datedata inicial (yyyy-MM-dd)
end_datedata final (yyyy-MM-dd); máximo de 3 meses após start_date
templates_idsopcionalIDs (uuid) de modelos separados por vírgula
forms_idsopcionalIDs (uuid) de checklists separados por vírgula
only_forms_with_answersopcional
pageopcional
per_pageopcional

Modelos de checklist

consulta Checklists

Ferramenta: listar_modelos_checklist

Lista os modelos de checklist em uso na organização.

Parâmetros
statusopcional
search_textopcionalbusca pelo nome do modelo
pageopcional
per_pageopcional
Contele Fleet MCP

Pronto para conversar com a sua frota?

Conecte o seu assistente em menos de 5 minutos, sem instalar nada e com a chave sempre sob o seu controle.

Conectar agora Rever como funciona