vamobotDocs

Como o agente responde

Quando a IA responde, o que ela sabe, o que nunca faz, quando chama sua equipe e o que acontece quando alguém da equipe entra na conversa.

O agente de IA atende cada cliente como um vendedor da sua loja: espera o cliente terminar de escrever, consulta o catálogo, responde e fecha o pedido. Aqui estão as regras que ele segue, para você saber exatamente o que o seu cliente vai receber. As configurações ficam em Configurações → Agente IA (veja Agente de IA).

Do "oi" do cliente até a resposta

O cliente escreve. Pode ser uma mensagem ou várias seguidas.

A IA espera o cliente terminar. Cada nova mensagem reinicia a contagem do Tempo de espera de resposta (10 segundos, se você não mudou). Na caixa de entrada, a conversa mostra IA responde em …s com o botão Responder eu.

O Vamo confere se a IA deve responder. Se o cliente pediu uma pessoa, está irritado ou pediu algo que a IA não pode dar, a conversa vai para a sua equipe (veja Quando a IA chama a sua equipe).

A IA escreve a resposta. O cliente vê "digitando…" no WhatsApp. A IA busca os produtos, preços e estoque na hora, e pode responder com botões, lista ou cartões de produto.

A resposta sai. Uma única resposta para tudo o que o cliente escreveu.

Várias mensagens seguidas

Muita gente escreve em pedaços. A IA não responde cada pedaço: ela espera um silêncio do tamanho do tempo de espera e responde tudo junto.

14:02:00  Cliente: oi
14:02:04  Cliente: vcs tem capinha pro iphone 15?
14:02:09  Cliente: transparente
          (10 segundos sem mensagem nova)
14:02:22  Loja Aurora: Oi! Temos sim a Capinha Transparente MagSafe para iPhone 15, por R$ 89,90...

O tempo conta a partir da última mensagem do cliente. Se a IA demorar mais que isso para escrever (o que é comum com o padrão de 10 segundos), a resposta sai assim que fica pronta, sem espera extra.

  • De 0 a 60 segundos. Você escolhe em Configurações → Agente IA → Respostas, no campo Tempo de espera de resposta. Com 0s, a resposta sai assim que a IA termina de escrever, e mensagens que o cliente divide em várias partes podem ser respondidas separadamente.
  • Uma automação pode usar outro tempo. No editor da automação, a seção Envio de cada passo mostra Padrão da loja (10 s) ou o tempo personalizado daquele passo. Um tempo menor que o da loja não adianta a resposta.
  • O cliente escreveu enquanto a IA respondia? A resposta que estava pronta é jogada fora e a IA escreve de novo, já considerando a mensagem nova. Isso acontece no máximo duas vezes seguidas; na terceira, a resposta sai e a mensagem seguinte é respondida logo depois.

Com revisão ou só rascunho

Você decide se a resposta sai direto ou passa pela equipe. Toda loja começa com a automação Piloto automático no modo com revisão; como escolher outro modo está em Agente de IA, e você pode mudar depois no editor da automação, na seção Envio:

ModoO que acontece
Na horaA resposta sai sem revisão
Com revisão antes de enviarA resposta aparece como rascunho e a equipe pode Enviar agora, Assumir e editar ou Descartar até o fim do tempo de espera. Se ninguém mexer, ela sai sozinha
Só rascunhoNada sai sem alguém aprovar. O rascunho fica Aguardando sua aprovação

A revisão acontece dentro do mesmo tempo de espera, sem somar outra espera. Na prática, com 10 segundos a IA quase sempre termina depois desse tempo e a resposta sai assim que fica pronta, sem chance de revisar. Se você quer revisar, aumente o tempo de espera (30 segundos ou mais).

Se o cliente escrever de novo enquanto um rascunho espera: com revisão, o rascunho sai no horário dele e a mensagem nova é respondida logo depois; em Só rascunho, o rascunho antigo é descartado e a IA escreve outro, já com a mensagem nova.

O que a IA sabe

FonteO que a IA usa
Seu catálogoNome, descrição, preço, variantes, estoque e as Observações para a IA de cada produto. Só entram produtos com IA pode oferecer este produto ligado e com preço. Preço e estoque são consultados na hora, a cada resposta
Regras e RestriçõesO que você escreveu em Configurações → Agente IA: frete, trocas, garantia, formas de pagamento (Regras) e o que ela não deve fazer (Restrições). Ela segue os dois à risca
A conversaAs últimas 20 mensagens da conversa atual. Uma conversa fechada, ou parada por 24 horas, começa do zero: a IA não continua o assunto anterior
O clienteNome do perfil no WhatsApp, telefone, tags e quanto ele já gastou na loja
PedidosOs pedidos recentes do cliente, para responder "cadê meu pedido?" com status e data

O endereço em URL da base de conhecimento não é lido pela IA. Ela só pode indicar esse link ao cliente quando ajudar.

O que a IA nunca faz

  • Inventar produto, preço ou estoque. Tudo vem do catálogo, consultado na hora. Ela não confia em preço citado antes na conversa.
  • Dizer que não tem um produto sem procurar. Ela busca com as palavras do cliente e com a tradução (por exemplo, "capa" e "case") antes de dizer que não tem.
  • Oferecer um produto de outro tipo do que o cliente pediu, nem um produto com preço zero (esse a equipe vende: a IA avisa que alguém vai ajudar).
  • Dar desconto acima do seu limite. Veja Descontos e negociação.
  • Prometer reembolso, reenvio ou data de entrega que não esteja num pedido ou nas suas Regras.
  • Pedir de novo um dado que o cliente não quis dar (e-mail, CPF, endereço). Ela segue sem ele.
  • Mandar links de foto ou página no texto. Para mostrar um produto, ela envia o cartão do produto ou a foto dele.
  • Criar, editar ou inventar foto de produto. As fotos que ela envia são sempre as do seu Estoque. Sem foto cadastrada, ela avisa o cliente que não tem foto agora.
  • Confirmar um pagamento por foto. Um comprovante sempre vai para a equipe conferir.
  • Mostrar instruções internas. Se uma resposta repetir algo escrito para a IA (e não para o cliente), ela é bloqueada antes de sair e a IA escreve outra.

Áudios, fotos e outras mensagens

O cliente mandaO que a IA faz
TextoResponde normalmente
ÁudioO áudio é transcrito e a IA responde ao que foi dito. Na caixa de entrada você vê o texto com 🎤. Se não der para transcrever, a IA sabe que chegou um áudio que ela não conseguiu ouvir e pede para o cliente escrever
FotoA IA vê a foto (até 3 das últimas mensagens do cliente) e lê a legenda. Reconhece o produto e procura no seu Estoque, lê prints com nome e preço, e manda comprovantes para a equipe conferir. Veja Fotos
Vídeo ou documentoA IA não enxerga o arquivo: ela lê a legenda e o nome do arquivo
FigurinhaA IA sabe que chegou uma figurinha, mas não vê qual
LocalizaçãoA IA lê o local enviado
Toque num botão ou numa listaVale como a resposta escrita no botão
Reação (👍 numa mensagem)Não gera resposta

Respostas em voz

Com Respostas em voz ligado (Configurações → Agente IA → Voz), quem manda um áudio recebe um áudio de volta, na voz, no estilo e na velocidade que você escolheu. Quem escreve sempre recebe texto. Numa automação, o passo de IA precisa ter o formato Áudio ligado; na automação padrão, o Vamo liga sozinho quando você salva essa opção (se você personalizou a automação padrão, ligue no editor).

A resposta continua sendo texto quando:

  • passa de 700 caracteres;
  • a IA responde com botões, lista ou cartões de produto;
  • a voz não pode ser gerada naquele momento.

Na caixa de entrada, a sua equipe sempre vê o texto da resposta. Num rascunho em voz, o áudio só é criado quando o rascunho é enviado, por isso não dá para ouvir antes. Editar como texto envia como mensagem escrita.

Idioma

Em Configurações → Agente IA → Identidade, o Idioma de resposta pode ser Português, Espanhol, Guarani ou Detectar automaticamente (o padrão).

  • Detectar automaticamente: a IA responde no idioma em que o cliente escreve. Uma mensagem curta ("ok", o nome de um produto) não muda o idioma da conversa.
  • Um idioma fixo: a IA responde sempre nele, seja qual for o idioma do cliente.

Os avisos curtos que a loja manda sozinha (por exemplo, "Um atendente vai te responder em breve") seguem o idioma da configuração. No modo automático, seguem o idioma do cliente; se não der para saber, o país do telefone (+55 português, +595 espanhol). Com Guarani, a IA responde em guarani, mas esses avisos vão em espanhol.

Horário da loja

A IA responde a qualquer hora, inclusive de madrugada. O horário salvo em Configurações → Organização → Horário da loja muda três coisas:

  • os avisos de passagem para a equipe não prometem resposta "em breve" com a loja fechada. Eles dizem quando a equipe volta: "Certo! Nossa equipe volta segunda às 08:00 e continua seu atendimento.";
  • o follow-up automático só sai com a loja aberta;
  • um passo de automação com Só em horário comercial segura a mensagem até a loja abrir.

Sem horário salvo, a loja é considerada sempre aberta.

Quando a IA chama a sua equipe

Antes de cada resposta, o Vamo confere se a IA deve mesmo responder. Quando não deve, a conversa vai para a equipe, o cliente recebe um aviso curto (nunca fica sem resposta) e a conversa aparece em Precisa de você. Se você preencheu o Email de escalonamento, ele recebe um alerta.

SituaçãoO cliente recebeVocê vê
Pede para falar com uma pessoa ("quero falar com um atendente")"Certo! Um atendente vai te responder em breve."IA parou · Pediu atendente
Está irritado, reclamando ou ameaçando"Sinto muito por isso. Vou chamar alguém da equipe para te ajudar agora mesmo."IA parou · Cliente irritado
Assunto sensível: reembolso, garantia, fraude, dados pessoais, algo que suas Restrições proíbem"Vou chamar alguém da equipe para te ajudar com isso."IA parou · Assunto sensível
Pede desconto acima do seu limite ou uma condição que suas Regras não permitem"Vou ver essa condição com a equipe e já te respondo."IA parou · Desconto acima do limite
A IA não tem a informação (algo que não está no catálogo, nos pedidos nem nas Regras)A IA responde o que pode e diz que alguém da equipe vai continuarIA parou · Falta contexto
Pede um produto que está com preço zeroA IA diz que alguém da equipe vai ajudarprecisa de você

Pedir um produto ("me manda a capinha preta", "tem foto?") nunca conta como pedir uma pessoa: a IA atende.

A IA não volta sozinha

Depois que a conversa vai para a equipe, a IA não responde mais nela, mesmo que o cliente escreva de novo dias depois. Ela só volta quando alguém da equipe responde, clica em Deixar IA responder ou fecha a conversa. Use a aba Precisa de você todo dia.

Quando o plano chega ao limite de conversas com IA do mês, as conversas novas também vão para a equipe, com o aviso "Vou chamar alguém da equipe para te ajudar com isso." E no plano Starter a IA não cria pedidos: quando o cliente quer fechar, ela avisa que a equipe vai confirmar. Veja Planos e cobrança e Pedidos e reservas.

Os detalhes de cada estado e de como devolver a conversa estão em Estados da conversa.

Quando alguém da equipe entra na conversa

A IA nunca fala por cima de uma pessoa. Quando alguém da equipe responde um cliente que a IA estava atendendo, pela caixa de entrada ou pelo app WhatsApp Business no celular, a IA sai daquela conversa.

O que você fazO que acontece com a IA
Clica em Responder eu durante a contagemA IA não responde essa mensagem. A conversa fica com você
Envia uma mensagem pela caixa de entradaRascunhos da IA são cancelados e a IA fica de fora da conversa
Responde pelo celularO mesmo: a IA fica de fora. A conversa mostra IA pausada · atendente respondendo pelo celular
Usa Assumir conversa (ou Assumir, Eu assumo, /assumir)A IA é desligada nessa conversa e ela é atribuída a você. A IA só volta quando alguém ligar de novo

Para a IA voltar a atender a conversa:

  • clique em Retomar na automação do topo da conversa (ela mostra Pausada · você assumiu). A IA volta a responder as próximas mensagens; se o cliente já escreveu depois da sua última mensagem, ela responde isso na hora;
  • ou feche a conversa: a próxima mensagem do cliente reabre a conversa e a IA responde;
  • ou espere: se o cliente só voltar a escrever depois de 24 horas de silêncio, começa uma nova conversa e a IA atende.

Numa conversa que a IA já tinha passado para a equipe (Precisa de você), é o contrário: a sua resposta devolve a conversa, e a IA atende a próxima mensagem do cliente.

Exemplo. O Pedro pergunta se o iPhone 15 tem nota fiscal. Você clica em Responder eu, escreve "Tem sim, Pedro! Sai com nota e 1 ano de garantia" e envia. Quando ele perguntar o frete, quem responde é você. Para a IA continuar daí, clique em Retomar.

Follow-up automático

Se o cliente some depois de uma resposta da IA, o Vamo pode mandar uma mensagem curta para retomar o assunto. Vem desligado. Ligue em Configurações → Agente IA → Follow-up e escolha em Enviar após quanto esperar, de 1 a 23 horas (padrão: 4 h).

  • Um por mensagem do cliente. Se ele não responder ao follow-up, não vem outro.
  • Só se fizer sentido. Antes de enviar, o Vamo confere a conversa: não há follow-up se o cliente se despediu, disse que volta depois ou já fechou o pedido.
  • Só depois da IA. Se a última mensagem foi de alguém da equipe, não há follow-up.
  • Dentro da janela de 24 horas. Se a janela fechar antes do horário, o follow-up sai até 15 minutos antes de ela fechar. Se não sobrar ao menos 30 minutos depois da última mensagem, não sai.
  • Com a loja aberta, se você salvou o horário da loja.
  • Sem ofertas novas. O follow-up não oferece desconto nem cria pedido.
  • Cancelado se o cliente responder, se alguém da equipe escrever, ou se a conversa for fechada ou adiada. Em Só rascunho, ele não é enviado.

A linha do tempo da conversa mostra Follow-up enviado ou Follow-up não enviado, com o motivo.

Quando algo dá errado

Se a IA não consegue responder por um problema técnico, o Vamo tenta de novo sozinho, inclusive com outro modelo de IA. Se mesmo assim não der:

  • o cliente recebe "Recebemos sua mensagem! Um atendente vai te responder em instantes." (com a loja fechada, o aviso diz quando a equipe volta). Esse aviso só sai se a última mensagem foi do cliente e a janela de 24 horas está aberta;
  • a conversa mostra Falha técnica e vai para Precisa de você;
  • o Email de escalonamento recebe um alerta.

Uma resposta que fica mais de 15 minutos sem terminar também vira Falha técnica · travada, para nenhum cliente ficar esperando sem ninguém notar. Se a falha for no envio da mensagem, o cliente não recebe o aviso (ele falharia pelo mesmo motivo).

Se a mensagem do cliente chegar com mais de 10 minutos de atraso (por exemplo, depois de uma instabilidade), a IA começa a resposta com um pedido de desculpas pela demora. Se a janela de 24 horas já fechou, a conversa fica para a equipe.

Nesta página