Leads
Clientes para prospecção ativa.
Clientes para prospecção ativa.
Escolha se a importação é B2C ou B2B e cole as linhas do Excel ou Google Sheets. Com cabeçalho, as colunas são reconhecidas pelo nome, em qualquer ordem (ex.: consumidor, telefone1, email, cidade_bairro, estado, codigo_cliente); colunas que não servem são ignoradas. Sem cabeçalho, use a ordem: nome email telefone bairro cidade estado codigo_cliente. Códigos de cliente repetidos são importados e riscados na tabela. Todo lead entra em "Aguardando contato".
Para ver e renomear o que já foi importado, use a aba Extração, em "Importações de leads".
Cole os códigos de modelo (um por linha) que contam como Premium. Todo lead cujo campo "Modelo" bater com algum da lista recebe Lead Premium = Sim — os outros não são tocados. A lista também fica guardada: novas importações com esses modelos já entram marcadas sozinhas, sem precisar colar de novo. Pode colar de novo quando quiser atualizar a lista.
Cole os números de OS (um por linha) que foram promotoras no R-NPS. Todo lead cuja "OS" bater com algum da lista recebe Promotor R-NPS = Sim — os outros não são tocados. A lista também fica guardada: novas importações com essas OS já entram marcadas sozinhas, sem precisar colar de novo. Pode colar de novo quando quiser atualizar a lista.
O usuário entra pelo botão "Acessar" da página inicial com o próprio nome de usuário e a senha. Todo usuário novo começa com a senha provisória leads; no primeiro acesso o sistema obriga a pessoa a criar a própria senha. Esqueceu a senha? Use "Redefinir senha" na tabela: volta a ser leads e a pessoa cria uma nova no próximo acesso. Usuários antigos marcados "sem senha" continuam entrando só com o nome até você clicar em "Criar senha". Não pode haver dois usuários com o mesmo nome (maiúsculas, espaços e símbolos não contam).
| Usuário | Nome | Leads exibidos | Aguardando contato | R-NPS | Premium | Senha | Ativo | Doc API |
|---|
O gestor entra pelo mesmo botão "Acessar", com usuário e senha (começa com a senha provisória leads e troca no primeiro acesso). Ele vê só os usuários atribuídos a ele: a lista com os números de cada um, o dashboard e o "Ver como". No "Ver como" o gestor só olha: não muda status nem escreve observação.
| Gestor | Nome | Usuários | Senha | Ativo |
|---|
Escolha o gestor ao lado de cada usuário. Salva na hora.
| Usuário | Gestor |
|---|
Cada usuário tem a sua própria configuração. Marcado = o usuário vê a coluna. O administrador sempre vê todas. Use "Ver como" para conferir exatamente o que o usuário está vendo.
| Usuário | Exibidos | Aguardando | Contatos hoje | Reuniões hoje | Sem interesse hoje | Pós-venda hoje | Contatos (7d) |
|---|
Uma integração acessa os leads exatamente como o usuário escolhido: mesmos leads atribuídos, mesmas colunas liberadas. Pode ler os leads novos/atualizados e também escrever (mudar status, preencher campos vazios).
| Nome | Usuário | Criada em | Último uso | Ativa |
|---|
Endpoints, campos, limite de requisições e um exemplo completo em Python. Marque "Doc API" na tabela de usuários acima para liberar esse mesmo botão também na tela de quem for consumir a API.
Cada linha é um login (usuário). Conta só quem entrou de verdade com aquele usuário. Os seus acessos não entram aqui: quando você usa "Visualizar como" no admin, ou entra por um aparelho marcado como seu, isso é contado como acesso do admin, não do usuário.
| Login | Último acesso | Quem acessou por último | Acessos (7 dias) | Acessos (30 dias) | Aparelhos diferentes (30 dias) |
|---|
Do mais recente para o mais antigo. Login = qual usuário foi acessado. Quem = qual aparelho entrou (dê nomes aos aparelhos na tabela de baixo) ou Você (admin). Como = digitou o usuário, só reabriu a página, ou foi você pelo painel admin.
| Quando | Login acessado | Quem | Como | De onde | Navegador / sistema |
|---|
Cada navegador que entra recebe um código próprio, guardado nele mesmo. Mesmo com todos usando o mesmo login, dá pra separar quem é quem: clique em "dar nome" (ex.: "SP – recepção", "Notebook do chefe"). Todo navegador onde você entra no painel admin é marcado sozinho como "É meu". Se usar outro aparelho seu (celular, por exemplo), marque "É meu" nele. Se a pessoa limpar os dados do navegador ou usar aba anônima, aparece como aparelho novo.
| Aparelho | Nome | Logins que usou | Navegador / sistema | Último IP | Acessos | Último | É meu |
|---|
Cada vez que você cola leads na aba Leads, eles ficam marcados com o nome do lote. Aqui aparecem todos, do mais recente para o mais antigo. "Renomear" muda o nome para todos os leads daquele lote; "Ver na tabela" abre a aba Leads filtrada nele.
| Lote | Importado em | Leads | B2C / B2B | Premium | R-NPS | Duplicados | Exibidos a usuários |
|---|
Importe a Volumetria IH ou o Service Order Excel download, do jeito que o arquivo vem (com a linha de cabeçalho). O formato é reconhecido sozinho e só fica gravado o que serve para o controle: OS, ASC, tipo de serviço, modelo, status, garantia, datas e cidade. Nome e dados do cliente não são gravados. Importar a mesma OS de novo só atualiza, não duplica. Extraído = Sim quando a OS já está nos leads (contato coletado).
Filtros: texto = contém; vários valores exatos separados por vírgula (ex.: IH,CI); datas: 2026, 09/2026, 15/09/2026 ou 01/09/2026 a 15/09/2026; preço: >=5000 ou <1000; vazio = sem valor. Clique no título da coluna para ordenar. "Premium?" segue o critério da seção Premium logo abaixo.
Cole as duas colunas do Excel, ordem de serviço e modelo (uma OS por linha, em qualquer ordem). Cada modelo é comparado pelos 7 primeiros caracteres (ex.: SM-S928 = Galaxy S24 Ultra, QN65S90 = OLED S90 65") com a tabela de referência abaixo, que tem o nome, o preço e se a família está na lista Premium.
Modelos cuja família (7 primeiros caracteres) não está na tabela de referência, nem uma parecida (6 primeiros). Ordenado pelas que mais aparecem. Digite o preço e saia do campo: ele entra na tabela de referência e a análise é recalculada. A lista completa também fica salva para pesquisa.
| Família | Linhas | Exemplos | Preço (R$) |
|---|
Preço de referência: lançamento no Brasil (pesquisa em imprensa), ou o atual da loja Samsung quando não achei o de lançamento. A coluna "Obs" mostra quando a descrição da lista Premium está errada. Pode corrigir ou preencher qualquer preço: clique no valor, digite e saia do campo, que ele é salvo.
| Família | Nome | Descrição na lista | Códigos | Preço (R$) | Base | Obs |
|---|
| Usuário | Leads exibidos | Aguardando contato | R-NPS | Premium | Contatos hoje | Contatos (7 dias) |
|---|
| Usuário | Exibidos | Aguardando | Contatos hoje | Reuniões hoje | Sem interesse hoje | Pós-venda hoje | Contatos (7d) |
|---|
Para sistemas próprios lerem e atualizarem os leads automaticamente. Cada integração age como um usuário do site: só vê os leads atribuídos a ela e só as colunas liberadas para ela.
POST, formato JSON, para o endereço base:https://txvumacrdcccxkmljtgd.supabase.co/rest/v1/rpc/<endpoint>apikey (chave pública, fixa, abaixo) e leva o token da integração dentro do corpo (JSON), no campo p_token — não é um cabeçalho Authorization.apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InR4dnVtYWNyZGNjY3hrbWxqdGdkIiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODMyMTAwNTcsImV4cCI6MjA5ODc4NjA1N30.Zyq-W2r56sxpuT4wfJtebRlfbnTCKpQDQy3u1RoebpY Content-Type: application/json
apikey é pública (o próprio site a usa) — ela sozinha não dá acesso a nada. Quem protege os dados é o seu token de integração.Vale só para api_leads (o endpoint de buscar leads). Escrever (api_atualizar_status, api_atualizar_dados) não tem limite.
Quando limitado, a resposta vem com "limitado": true e "aguarde_segundos" — não é um erro HTTP, é 200 OK normal.
Busca os leads atribuídos à integração. Use p_desde para buscar só o que mudou desde a última vez (guarde o servidor_em da resposta anterior e mande na próxima).
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
p_token | texto | sim | Token da integração |
p_desde | data/hora ISO 8601 | não | Omita ou mande null na primeira chamada, para trazer tudo |
Resposta (quando não limitado):
{
"limitado": false,
"colunas": ["nome", "telefone", "email", "..."],
"leads": [
{
"id": "uuid-do-lead",
"nome": "João da Silva",
"telefone": "(51) 99999-0000",
"status": "aguardando_contato",
"agendado_em": null,
"atribuido_em": "2026-09-30T12:00:00+00:00",
"atualizado_em": "2026-09-30T12:00:00+00:00"
/* + as demais colunas liberadas pra essa integração */
}
],
"servidor_em": "2026-09-30T20:18:16+00:00"
}
Resposta (quando limitado):
{ "limitado": true, "aguarde_segundos": 612, "servidor_em": "2026-09-30T20:18:16+00:00" }
Muda o status do lead no funil, agenda um retorno/reunião e/ou grava uma observação. Fica registrado no histórico do lead com o autor "API: <nome da integração>".
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
p_token | texto | sim | Token da integração |
p_lead | uuid | sim | O id do lead (vem do api_leads) |
p_status | texto | não | Um de: aguardando_contato, reuniao_marcada, sem_interesse, pos_venda. Omita para não mudar o status. |
p_agendado | data/hora ISO 8601 | não | Data/hora do retorno (Aguardando) ou da reunião (Reunião marcada) |
p_limpar_agendado | booleano | não | true para apagar o agendamento sem marcar outro |
p_nota | texto | não | Observação a registrar no histórico |
Resposta: { "status": "reuniao_marcada", "agendado_em": "...", "ultima_nota": "...", "ultima_atividade_em": "..." }
Preenche campos do lead que ainda estão vazios. Nunca sobrescreve um campo que já tem valor — mesma regra da importação do site.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
p_token | texto | sim | Token da integração |
p_lead | uuid | sim | O id do lead |
p_dados | objeto JSON | sim | Quaisquer destes campos: email, telefone, telefone2, telefone3, telefone4, bairro, cidade, estado, modelo, codigo_asc, promotor_rnps, lead_premium |
Resposta: { "ok": true }
| Valor | Nome no site |
|---|---|
aguardando_contato | Aguardando contato |
reuniao_marcada | Reunião marcada |
sem_interesse | Não tem interesse |
pos_venda | Pós-venda |
Token inválido, desativado, ou tentando mexer num lead que não é dele: a chamada falha (HTTP diferente de 200) com uma mensagem começando por token_invalido ou lead_indisponivel.
import time, requests
URL = "https://txvumacrdcccxkmljtgd.supabase.co/rest/v1/rpc"
APIKEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InR4dnVtYWNyZGNjY3hrbWxqdGdkIiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODMyMTAwNTcsImV4cCI6MjA5ODc4NjA1N30.Zyq-W2r56sxpuT4wfJtebRlfbnTCKpQDQy3u1RoebpY"
TOKEN = "lapi_..." # gerado no admin, aba API
H = {"apikey": APIKEY, "Content-Type": "application/json"}
def buscar_leads(desde=None):
r = requests.post(f"{URL}/api_leads", headers=H, json={"p_token": TOKEN, "p_desde": desde})
r.raise_for_status()
dados = r.json()
if dados.get("limitado"):
print(f"Limite atingido, esperando {dados['aguarde_segundos']}s...")
time.sleep(dados["aguarde_segundos"] + 1)
return buscar_leads(desde)
return dados
def marcar_status(lead_id, status, nota=None, agendado=None):
requests.post(f"{URL}/api_atualizar_status", headers=H, json={
"p_token": TOKEN, "p_lead": lead_id, "p_status": status,
"p_agendado": agendado, "p_nota": nota}).raise_for_status()
def preencher_dados(lead_id, dados):
requests.post(f"{URL}/api_atualizar_dados", headers=H, json={
"p_token": TOKEN, "p_lead": lead_id, "p_dados": dados}).raise_for_status()
# loop simples de verificação periódica (rode a cada 15 min num cron/agendador)
ultima_checagem = None
while True:
resp = buscar_leads(ultima_checagem)
for lead in resp["leads"]:
print("Novo/atualizado:", lead["nome"], lead.get("telefone"), lead["status"])
# ... sua automação de contato aqui ...
# marcar_status(lead["id"], "reuniao_marcada", nota="Contato automático", agendado="2026-10-05T14:00:00-03:00")
ultima_checagem = resp["servidor_em"]
time.sleep(15 * 60)