ADVs

Para que serve

Organiza o funil de oportunidades e lembra o vendedor da próxima ação na hora certa (cadência), com envio pelo WhatsApp de Orçamentos (2º número) e apoio de IA.

As abas

• 🎯 Ações de hoje — a fila de follow-ups que a cadência gerou. Em cada cartão: texto sugerido (editável), escolha do contato e os botões 📤 Enviar por WhatsApp, ✓ Já fiz e ⏭ Pular hoje. ✨ Regenerar com IA reescreve o texto.
• 💬 Respostas — quando o cliente responde no WhatsApp de Orçamentos, a mensagem é casada com a oportunidade, classificada (interesse, adiamento, fechamento…) e a cadência se ajusta sozinha. Áudios são transcritos (se a IA estiver ligada).
• 📊 Painel — indicadores do funil: valor em aberto/fechado, ticket médio, taxa de conversão, e gráficos por temperatura, status, vertical, dono e passo da cadência.
• 📋 Funil — todas as oportunidades, com filtros. Clique numa para ver/editar dados, contatos e a linha do tempo, e rodar 🎯 Probabilidade, 🧠 Estratégia e 🔎 Inteligência do cliente (IA).

Como a cadência funciona

Cada oportunidade tem passos (1 a 9) com intervalos em dias úteis. No dia certo o sistema gera a ação pendente (aparece em Ações de hoje); se ficar parada, vira Atrasada. Ela só entra na automação se "Bloquear automação" estiver desmarcado (no detalhe da oportunidade) e o status/fase forem elegíveis. Ajustes em ⚙️ Cadência (gestor): número de WhatsApp usado, intervalos por passo e regras.

IA (opcional)

Em 🤖 IA (gestor) você cadastra um endpoint compatível com OpenAI (ex.: OpenWebUI local): URL + modelo + chave. Com a IA ligada, as sugestões, a probabilidade, a estratégia, a inteligência do cliente e a transcrição de áudio passam a funcionar. Sem IA, o sistema usa mensagens-modelo e o resto do módulo funciona normalmente.

🔗 Abrir documentação pública — link para compartilhar com quem vai integrar (não exige login): https://adv.omegalight.com.br/api-docs

1. Autenticação

Toda requisição precisa de uma chave, enviada no cabeçalho Authorization. A chave aparece só uma vez, na criação.

Authorization: Bearer SUA_CHAVE_AQUI

Alternativa: cabeçalho X-API-Key: SUA_CHAVE_AQUI. Sem chave válida → 401. Chave de leitura tentando gravar → 403.

URL base: https://adv.omegalight.com.br

2. Listar as tabelas disponíveis

curl -H "Authorization: Bearer SUA_CHAVE" \
  https://adv.omegalight.com.br/api/v1/tables

Retorna cada tabela, número de linhas, colunas e se é gravável.

3. Ler dados de uma tabela

Paginação com limit (máx. 1000) e offset. Filtro por igualdade em qualquer coluna (?coluna=valor).

# últimos anexos de um pedido
curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://adv.omegalight.com.br/api/v1/pedido_meta?limit=50"

# filtrando por coluna
curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://adv.omegalight.com.br/api/v1/pedido_meta?base=mega&numero=0726-000084"

Resposta: { "tabela", "total", "limit", "offset", "itens": [ ... ] }

4. Gravar (só chaves de escrita)

Inserir — objeto JSON com as colunas:

curl -X POST -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"base":"mega","numero":"0726-000084","resp_fechamento":"João"}' \
  https://adv.omegalight.com.br/api/v1/pedido_meta

Atualizar — where (obrigatório) + set:

curl -X PATCH -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"where":{"base":"mega","numero":"0726-000084"},"set":{"resp_fechamento":"Maria"}}' \
  https://adv.omegalight.com.br/api/v1/pedido_meta

Apagar — where obrigatório (nunca apaga a tabela inteira):

curl -X DELETE -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"where":{"base":"mega","numero":"0726-000084"}}' \
  https://adv.omegalight.com.br/api/v1/pedido_meta

5. Planilhas (LibreOffice Calc / Excel / Google Sheets)

Planilhas não enviam cabeçalho de autenticação, então a chave vai na URL (&key=SUA_CHAVE) e os dados saem em CSV ou tabela HTML (&format=csv ou &format=html).

LibreOffice Calc (com atualização automática):

1. Menu Planilha ▸ Vincular a dados externos…
2. Cole a URL:
   https://adv.omegalight.com.br/api/v1/pedido_cache?format=html&limit=1000&key=SUA_CHAVE
3. Escolha a tabela detectada (HTML_1) e confirme.
4. Marque "Atualizar a cada N segundos" se quiser atualização automática.

Numa célula só: =WEBSERVICE("...&format=csv&key=SUA_CHAVE")

Excel: Dados ▸ Obter Dados ▸ Da Web, com format=csv&key=SUA_CHAVE.
Google Sheets: =IMPORTDATA("https://adv.omegalight.com.br/api/v1/pedido_cache?format=csv&key=SUA_CHAVE")

OnlyOffice: não tem "vincular a dados externos" nem WEBSERVICE/IMPORTDATA (e as macros não acessam a internet). Não dá para consultar ao vivo. O jeito é baixar e abrir: no navegador, abra https://adv.omegalight.com.br/api/v1/pedido_cache?format=csv&key=SUA_CHAVE, salve o .csv e abra no OnlyOffice (separador vírgula, UTF-8). Não atualiza sozinho — rebaixe quando quiser dados novos.

6. Segurança — o que a API NÃO expõe

• Nunca saem: hashes de senha, credenciais do WK/GED/e-mail, códigos OTP, tokens e as próprias chaves de API.
• users vem sem senha/credenciais e é somente leitura. audit_log também é só leitura.
• Toda ação por API fica registrada na Auditoria (categoria "api").
• Guarde a chave como uma senha. Se vazar, revogue na hora em Configurações e crie outra.
• Use as chaves em servidor/integração — evite colocá-las em páginas ou apps que rodam no navegador.