Conecte a LocaliTel ao fluxo do cliente
Um guia direto para transformar cobertura, torres e Geotab em dados úteis para operação, automação e tomada de decisão.
Visão Geral
A LocaliTel leva dados de cobertura e integração para a operação do cliente, combinando consulta pública, Geotab e automações internas em um único ecossistema.
Autenticação Pública
Para integrações externas, a API usa X-API-Key. A chave
é validada com hash e limite de uso antes de qualquer resposta.
curl https://SEU-DOMINIO/api/public/operators \
-H "X-API-Key: lkt_sua_chave"Autenticação Geotab
O fluxo Geotab usa X-Geotab-Key, criada na tela
/geotab, para liberar o add-in e registrar o uso
com segurança.
curl https://SEU-DOMINIO/api/geotab/analyze \
-H "Content-Type: application/json" \
-H "X-Geotab-Key: lkg_sua_chave" \
-d '{ "vehicles": [...] }'Como começar
Escolha a integração
Defina se a necessidade é API pública, Geotab ou uma automação interna.
Gere a chave
Crie a chave certa para o cenário e compartilhe apenas com quem vai integrar.
Consuma e acompanhe
Use o endpoint, valide o retorno e acompanhe histórico, limites e respostas.
Integrações
Esta é a área pensada para colocar a LocaliTel para trabalhar junto com a rotina do cliente. Aqui ficam os caminhos oficiais para conectar sistemas, automatizar processos e levar dados para onde a operação já acontece.
API pública
Ideal para apps, portais e automações externas. Usa
X-API-Key e entrega torres, operadoras e análise de
cobertura para consumo direto por outras soluções.
Geotab
Voltado para clientes Enterprise que querem operar com dados de
frota dentro do MyGeotab. Usa X-Geotab-Key, add-in
próprio e histórico persistido.
Admin/Cron
Para rotinas internas, validações e tarefas automáticas como relatórios agendados e processos de suporte.
Futuros canais
Webhook, CRM, ERP e parceiros entram aqui quando houver demanda real do cliente e uma entrega útil para a operação.
Endpoints Públicos
Lista operadoras disponíveis, tecnologias e quantidade de torres.
{
"operators": [
{ "name": "VIVO", "technologies": ["3G", "4G"], "tower_count": 12345 }
]
}Busca torres próximas por coordenada ou lista catálogo paginado quando coordenadas não são enviadas.
{
"towers": [
{ "id": "...", "operator_name": "VIVO", "distance_m": 830 }
]
}Calcula score de cobertura, operadora recomendada e ranking por operadora em um ponto.
{
"latitude": -23.5505,
"longitude": -46.6333,
"radius_km": 10,
"technology": "all"
}Integração Geotab
A integração recebe posições de veículos do MyGeotab, analisa cobertura em lote e salva a execução para histórico e exportação CSV.
Exige X-Geotab-Key ou sessão Supabase Bearer. Acesso
disponível apenas no plano Enterprise.
{
"source": "mygeotab",
"databaseName": "cliente_geotab",
"radius_km": 20,
"technology": "all",
"vehicles": [
{ "id": "b1", "name": "Caminhão 01", "plate": "ABC1D23", "latitude": -23.55, "longitude": -46.63, "online": true }
]
}{
"run_id": "uuid",
"summary": { "total": 1, "statusCounts": { "ok": 1 } },
"results": [
{ "recommended_operator": "VIVO", "score": 82, "recommendation": "Vivo 3G disponível" }
]
}Abra /geotab
Usuário precisa estar no plano Enterprise.
Crie a chave
Copie a X-Geotab-Key. Ela não aparece de novo.
Instale o add-in
Use o JSON de instalação mostrado na tela Geotab.
Admin
Verifica RPCs administrativas. Exige Bearer token de usuário admin.
Cron
Gera e envia relatório semanal para admins. Exige Bearer com
LOCALITEL_CRON_SECRET.
Erros e Limites
Não autenticado
Chave ausente, inválida ou sessão expirada.
Sem permissão
Plano insuficiente ou usuário sem papel admin.
Rate limit
Limite da chave atingido. Use os headers de retry.
{ "error": "X-API-Key obrigatório." }
{ "error": "Integração Geotab disponível apenas no plano Enterprise." }Boas Práticas
Proteja chaves
Nunca exponha service role no navegador. Use apenas chaves públicas ou Geotab.
Use cache
Evite repetir consultas idênticas de torres em alta frequência.
Audite uso
Monitore histórico, execuções e limites por plano.