Ligação outbound cobre quem está na lista. Inbound cobre quem discou o número. O agente Web cobre quem já está no seu site e quer falar agora, pelo microfone do navegador, sem esperar callback nem abrir um chatbot de texto paralelo. No Pipevoz é o mesmo tipo de agente de voz: roteiro, voz, variáveis e pós-processamento. A diferença é o canal: o lead clica, autoriza o microfone e a conversa começa no browser.
O que o agente Web faz
É um agente de voz publicado para o canal Web. O visitante inicia a sessão no seu site ou app; o Pipevoz sobe o áudio, o agente fala e escuta como numa ligação, e o workspace registra a conversa em Logs e Relatórios do menu Web.
Não substitui o discador. Complementa: a campanha outbound liga para a lista; o agente Web atende quem já chegou na landing, na página de preço ou depois de um formulário. A demo da própria landing do Pipevoz usa esse mesmo fluxo.
- Mesmo editor de fluxo e mesma voz dos agentes de telefone.
- Conversa no navegador, sem discar e sem DID.
- Histórico em Web → Logs e Web → Relatórios, separado das campanhas de discagem.
Quando faz sentido no site
Use quando o visitante já está quente e o atraso de um retorno por telefone esfria o lead. Página de preço, resultado de um quiz, área logada do produto ou um botão “falar com um especialista” são os encaixes naturais.
Se a operação precisa de volume em lista fria, o caminho continua sendo campanha outbound. O Web resolve o momento em que a pessoa já está no funil digital e quer conversar na hora.
- Saudar pelo nome quando o visitante já está autenticado ou veio de um formulário.
- Tirar dúvida de produto sem mandar o lead para um formulário de callback.
- Qualificar no site e, se fizer sentido, seguir o restante da cadência por telefone.
Como publicar: agente, app e snippet
No app, o caminho é Web → Agentes. Crie o agente na direção Web, monte o fluxo, escolha a voz e publique uma versão. Sem versão publicada a sessão não sobe (o SDK recebe 409).
Depois, em Web → Apps, crie um app, vincule o agente publicado e, se quiser restringir, preencha os domínios permitidos. O modal de instalação entrega o snippet: um script apontando para /web/pipevoz.js com a chave pública do app no atributo data-key. Cole no HTML do site.
- Um app, uma chave pública. Trocar o agente do app não exige recortar o script.
- Domínios permitidos bloqueiam origem que não está na lista (resposta 403).
- App inativo, chave inválida ou agente pausado devolvem 404.
Iniciar a conversa e passar contexto
O script sozinho não liga o microfone. No seu front, chame Pipevoz.start quando o visitante clicar no botão. O objeto variables entra no agente como variáveis dinâmicas: dá para mandar first_name, plano, origem da página e o roteiro usa isso na saudação.
Pipevoz.stop encerra. mute e unmute controlam o microfone. on e off escutam a sessão para animar o widget: call_started, call_ready, agent_start_talking, agent_stop_talking, update, call_ended e error.
- variables: objeto de string para string, injetado no contexto do agente.
- call_ready marca áudio pronto; agent_start_talking e agent_stop_talking servem para o orb “falando”.
- error traz o código (origin_denied, rate_limited, billing, missing_key, entre outros).
Crédito, slots e limites
Minuto de conversa web cobra crédito na mesma lógica da ligação atendida: duração em segundos vezes a tarifa por minuto do workspace. Sem saldo ou sem slot simultâneo a sessão não abre (402). Caixa postal não se aplica aqui: ou a conversa aconteceu, ou não.
Há rate limit por IP: 8 requisições em 10 segundos ou 60 por minuto. Isso evita abuso do endpoint público sem atrapalhar um visitante normal clicando no botão.
O que conferir antes de ir ao ar
Publique o agente, teste o start no domínio certo, ouça a abertura com as variáveis que o site realmente manda e veja o log em Web → Logs. Se o site estiver em staging e produção, coloque os dois domínios na lista do app.
Para o roteiro em si, o guia de nós do workflow e o artigo de comportamento do agente valem igual. A diferença de canal não muda a forma de escrever o fluxo; muda só onde a conversa começa.