Documentação

Recursos do Luxtor Zap

O raro não é “IA que fala”. É voz no WhatsApp que conversa de verdade: escuta, valida fato, aceita interrupção. Esta página explica o motor e lista o que já está no ar.

checando linhas

O que é

O cliente vê o número da operação no WhatsApp. Sem app novo. Sem URA. A conversa pode ser da IA (Luna na demo) ou do humano, no mesmo chip.

O Wavoip vendeu o telefone no Zap para um humano no navegador. O Zap Luxtor é a central de voz: a IA atende e liga; o time entra pelo Nexa quando fecha.

Não é o site de carros. Auto Premium usa esta voz. Zap é o produto para qualquer vertical.

Mapa de recursos

Três canais no mesmo número

Na demo os canais usam o WhatsApp da Fabi: +55 (19) 99026-4680. Um número, vários companions — igual o Wavoip. Cada canal = uma chamada ao mesmo tempo. Não misturamos companion de voz com Cloud API da Meta no mesmo dispositivo.

1 · Ligar (saída)

Ao vivo. Você coloca o DDD + número no site, no console, no widget ou na API. A Fabi dispara áudio no WhatsApp. Atende no celular. Depois da saudação ela escuta — pode falar por cima.

2 · Atender (entrada)

Ao vivo. De outro chip, disca nesse número no WhatsApp (áudio, não vídeo). Ela atende e conversa. No site: copiar número ou “Abrir no WhatsApp”.

3 · Retorno (aparelho extra) — depois

O serviço já está no ar, com sessão vazia. O aparelho extra ainda não foi colocado no WhatsApp da Fabi. Quando for: no celular dela, Aparelhos conectados → Conectar aparelho, no companion de retorno — sessão nova, nunca a mesma do ligar nem a do atender.

Até lá o ciclo (ligar de volta com motivo) usa a linha de ligar. Depois do pareamento, retorno e ciclo passam a este canal; ligar e atender ficam nos outros dois. Sem blast. Sem discador. Um retorno de cada vez neste canal.

O QR de “aparelhos conectados” não fica na internet. Quando formos colocar o aparelho extra, o pareamento é no console autenticado ou túnel — não na landing.

Como a voz conversa de verdade

Quase ninguém vende isso: uma ligação de WhatsApp em que a pessoa do outro lado conversa, não ouve um áudio gravado. A Luxtor montou um loop, não um recado.

1. Áudio da chamada. Companion no próprio WhatsApp (ligar e atender). Sem app novo pro cliente.
2. Escuta. O trecho vira texto em português. Se veio lixo ou silêncio, ela pede pra repetir. Não alucina o que não ouviu.
3. Intenção. Oi não é busca. Desconto não é “apresenta o carro de novo”. Espera não é pressão. Tchau é tchau. Cada trilho tem fala segura pronta, mesmo se o modelo cair.
4. Pacote de fatos (o trilho). Só o estoque real entra na boca dela: no máximo dois itens, preço já escrito para voz (“trezentos e dezenove mil reais”, nunca R$ 319.000), nome que dá pra falar (X um, não X1). O que não está no pacote não existe.
5. Conversa + validador. Um modelo gera o tom — curto, humano, consultora. Um validador recusa link, markdown, “Duda”, desconto inventado, preço feio. Recusou? Cai no script do trilho. A personalidade é solta. O fato é travado.
6. Voz na linha. TTS da casa, em português de fala. Enquanto ela fala, o microfone continua vivo: barge-in. Você interrompe, ela para, escuta, responde.
7. Humano no fecho. Pediu desconto, dono, visita: ela não mente o número. Manda ficha no Zap quando couber, ping no dono, card no Nexa. Quase substitui o atendimento. Quem assina o negócio continua sendo gente.

Por isso não parece URA. URA tem árvore. Bot de voz barato lê um texto e não deixa falar. Aqui tem turno, memória curta da ligação, recorte, e um corte automático quando o modelo quer ser esperto demais.

Na demo o pacote é o pátio da Auto Premium (Luna). No contrato o mesmo loop recebe o estoque, a voz e as proibições da sua operação. O campo de fatos no console já guarda o que não pode errar — no contrato isso entra no motor, não só na ficha.

O que o validador protege

• Não inventa item, preço, parcela, desconto.
• Não lê catálogo. No máximo dois nomes, um motivo, o preço por extenso.
• Não promete o que o dono não autorizou. “Levo ao dono no Zap.”
• Não mistura papéis: Luna não é Duda, não é Alma, não explica servidor.
• Se o modelo falhar ou atrasar, a ligação não morre: o script do trilho fala.

Barge-in: se a pessoa fala enquanto ela fala, ela para e escuta. Sem isso a ligação vira monólogo — e deixa de ser conversa.

Ciclo de atendimento — do início ao fim

Não é discador. Não é frio. É o atendimento que a casa quase nunca fecha: a pessoa liga, a IA resolve o que der na hora, e se faltar algo (horário, dúvida, “me liga depois”) ela volta com o motivo na boca.

1. Entrada. Cliente liga no Zap da casa. A IA atende, escuta, valida fato, conversa.
2. Demanda. No hangup a ligação vira ficha: agendamento, esclarecimento ou retorno. Sem motivo, não entra na fila de volta.
3. Nexa. O time vê o card. Humano fecha o que a voz não pode prometer.
4. Retorno automático. Se a demanda veio da entrada e tem motivo, a Luna liga de volta sozinha em cerca de 5 minutos. Horário comercial (8h–19h, São Paulo). Teto de 8 retornos por dia. No máximo 2 tentativas. Um lead de cada vez. Sem motivo, não sai. Enquanto o aparelho extra não estiver no Zap, essa volta sai na linha de ligar.
5. Humano no console. Pode ligar agora, pausar o auto ou marcar resolvida. Manual só com quem já falou com a casa.

Não é CSV. Não é frio. É o ciclo: atendeu → ficou algo → volta com causa.

Nexa e ficha

Nexa é o mensageiro da equipe, não o WhatsApp do cliente. Quando a ligação acaba, a ficha cai no Nexa de quem fecha (hoje Marcelo) e um recado no Zap do dono. O lead não recebe consultora automática no Zap dele.

Padrão da casa: SIM / interesse → painel do produto + card no Nexa. Zap Luxtor segue isso no hangup da demo.

Teste ao vivo no site

1. Abra o WhatsApp no celular.
2. No bloco Teste grátis, peça pra ela ligar no seu número — ou ligue nela.
3. Opcional: no campo de saudação, escreva o que ela fala ao atender. Vazio = Luna livre. Depois pergunte do site ou de um carro.
4. Atenda em áudio. Conversa livre. Desligue. A ficha vai pro Nexa.

Ouvir a Luna no topo toca o pitch (/api/pitch.mp3) sem ocupar a linha.

Linha agora mostra saídas e entradas recentes, com os últimos 4 dígitos. Sem número completo no feed.

Widget · Falar com a loja

Botão flutuante. O visitante pede “ligar pra mim” (mesma API) ou abre o WhatsApp da Luna. Já está na landing. No console, depois do login, sai o snippet com o slug da casa.

<script src="https://zap.luxtor.ia.br/widget.js"
  data-api="https://zap.luxtor.ia.br"
  data-casa="sua-loja"></script>

Na demo a linha continua sendo a Luna. No contrato o mesmo botão dispara o Zap da loja.

Login por QR

Em /entrar.html: nome da operação → QR no computador → confirma no celular (ou “estou neste aparelho”). Sem senha. Cookie na sessão, 7 dias.

Isso não é o QR de “aparelhos conectados” do WhatsApp. O QR de parear o companion da Luna não vai para a internet — senão qualquer um toma a linha. Pareamento do número da casa é passo de contrato, com túnel ou console autenticado.

Console

/app.html mostra os três canais (ligar e atender ao vivo; retorno marcado como depois), dispara chamada, copia o número de entrada, feed, e — se você entrou pelo QR — o snippet do widget e o campo de fatos.

Ainda não é login de cliente com fatura e canais próprios. É o rascunho da central.

API

Detalhe com curl em /developers.html. Resumo:

• POST /api/ligar — {"to":"5519…"}. Opcional text (o que ela fala ao atender, até 420 caracteres), origem (widget) e casa.
• GET /api/status — ligar / atender / retorno, número da Luna, wa.me. Retorno connected: false até o aparelho extra.
• GET /api/feed — últimos eventos mascarados.
• GET /api/pitch.mp3 — apresentação em áudio.
• GET /widget.js — o botão da loja.
• /api/operacao/* — start, poll, confirm, me, fatos, logout. Cookie, não token de parceiro ainda.

Token por tenant, webhook assinado e SIP não estão nesta demo.

Limites da demo

• Um teste de saída a cada 3 minutos por IP.
• Teto diário de disparos públicos (hoje 40).
• Número brasileiro com DDD.
• Não use para frio em massa. Risco de bloqueio do chip. Zap é retorno, atendimento e lead que já pediu contato.

O que não é

• Não é Cloud Calling oficial da Meta nesta demo. É companion de voz no próprio WhatsApp.
• Não substitui o WhatsApp do time no celular. É dispositivo extra (o terceiro da demo ainda vai ser colocado).
• Não é o painel de carros, nem o Nexa (Nexa é da equipe).
• Não vendemos SIP/gravação como se já estivesse pronto.

O que entra no contrato

Número de vocês (QR de companion), voz própria, fatos travados no motor, canais simultâneos, API com token, webhook, card Nexa no usuário certo. Humano no fone do navegador, SIP e gravação: plano Casa / roadmap.

Vendas: WhatsApp do Marcelo.