vamobotDocs

Produtos e estoque

Cadastre produtos à mão ou por planilha, veja o que a IA lê de cada campo e entenda como o estoque sobe e desce.

O agente só vende o que está no Estoque do Vamo. Ele consulta essa lista a cada resposta: preço, quantidade e foto vêm sempre daqui, nunca da memória da conversa. Se o produto está certo no Estoque, a resposta ao cliente sai certa.

Você tem quatro jeitos de montar o catálogo:

JeitoBom paraOnde
Planilha com a ajuda da nossa equipeQuem vende pelo WhatsApp e pelo Instagram, tem a lista numa planilha e quer ajuda para montar o catálogoNo cadastro, etapa Seus produtos → Enviar a planilha para a equipe
Cadastro manualPoucos produtos, ou para testarEstoque → Novo produto
Planilha CSVDezenas ou milhares de produtosEstoque → Importar CSV
Loja conectadaQuem já vende na Shopify ou no WooCommerceConfigurações → Integrações (veja Integrações de loja)

Com uma loja conectada, o catálogo vem dela: Novo produto e Importar CSV ficam desativados, com o aviso "Desativado: o estoque vem da Shopify" (ou do WooCommerce).

Tela Estoque da Loja Aurora com a lista de produtos, as colunas de preço, estoque, origem, IA vende e Catálogo Meta, e os filtros no topo

A tela Estoque

Cada linha mostra o produto, o SKU, o preço, o estoque (em vermelho quando está zerado), a categoria, o status, a Origem (Vamo (manual), Shopify ou WooCommerce), a coluna IA vende e, com o catálogo do WhatsApp ligado, a coluna Catálogo Meta.

Os filtros do topo ajudam a achar o que precisa de atenção: Ativo, Rascunho, Arquivado, Sem estoque, IA não oferece, Recusados na Meta e Em análise. A busca procura pelo nome e pelo SKU.

Clique num produto para abrir o painel dele à direita.

Cadastrar um produto à mão

Em Estoque, clique em Novo produto.

Preencha os campos. Só o nome, o preço e o estoque são obrigatórios.

Clique em Criar produto. O produto entra como Ativo (se você não mudar o status) e a IA já pode oferecer.

CampoComo preencher
NomeComo o cliente reconhece o produto: "iPhone 15 128 GB Preto" é melhor que "IP15-PT"
DescriçãoDetalhes que o cliente pergunta: memória, garantia, o que vem na caixa
PreçoDo jeito que você escreve no dia a dia, na moeda da sua conta: 4.599 ou 4.599,00
EstoqueUm número inteiro, 0 ou mais
SKUO seu código interno (opcional)
StatusAtivo, Rascunho ou Arquivado. A IA só oferece produtos ativos
Foto (link da imagem)O endereço completo da foto, começando com https://

Depois de criar, o painel do produto ainda tem três controles só da IA: IA pode oferecer este produto, Observações para a IA e Preço mínimo para a IA (veja abaixo).

Para mudar qualquer dado, abra o produto, edite em Dados do produto e clique em Salvar produto.

Painel de um produto da Loja Aurora com os dados do produto, o interruptor IA pode oferecer este produto, as observações para a IA e o preço mínimo

Fotos

Cada produto tem até 10 fotos. A primeira é a principal: ela vai junto quando a IA mostra o produto ao cliente, num cartão com nome e preço, e é a primeira que a IA envia quando o cliente pede ("tem foto?"). Quando o cliente pergunta de um produto só, a IA manda também as seguintes, na ordem. Com o catálogo do WhatsApp ligado, a principal é a foto do produto lá e as outras aparecem junto. Sem foto cadastrada, a IA avisa o cliente que não tem foto agora. Veja Fotos.

No painel do produto, a área Fotos mostra a galeria:

  • Adicionar fotos (ou arraste os arquivos para a área) envia várias de uma vez, cada uma com o seu progresso. Uma foto com formato ou tamanho que não serve aparece com o motivo, e as outras entram;
  • arraste uma miniatura para mudar a ordem (funciona com o mouse e com o dedo, no celular);
  • a estrela deixa uma foto como principal;
  • o X remove a foto, depois de você confirmar.

Cada mudança é salva na hora. Se não der para salvar, a galeria volta como estava e um aviso aparece.

Na criação, no Novo produto, clique em Enviar foto e escolha a foto do computador ou do celular. Vale JPG, PNG, HEIC (a foto do iPhone) ou WebP, de até 15 MB. O Vamo guarda a foto, preenche o link sozinho e deixa a foto no jeito que o WhatsApp aceita: HEIC e WebP viram JPG, e uma foto muito grande é reduzida. Depois clique em Criar produto ou Salvar produto.

O campo do link continua lá para quem já tem as fotos num site. Nesse caso:

  • use um link https:// direto para a imagem;
  • prefira JPG ou PNG. Pelo link, uma foto WebP, GIF ou HEIC não aparece no cartão: o cartão vai, mas sem a foto. Quando o cliente pede a foto, a IA trata esse produto como sem foto. Mandando o arquivo, isso não acontece.

Enviar as fotos de vários produtos

Para colocar as fotos do catálogo inteiro de uma vez, use Enviar fotos no topo do Estoque.

Dê a cada foto o nome do SKU ou do nome do produto. Acentos, maiúsculas, espaços, hífens e pontos não contam: CAM-01.jpg, cam 01.jpg e Cam_01.JPG valem todos para o SKU CAM-01, e perfume-arabe.heic vale para o produto Perfume Árabe.

Para mais de uma foto do mesmo produto, numere: ABC123.jpg (ou ABC123_1.jpg) é a principal, e ABC123_2.jpg, ABC123_3.jpg… entram depois, nessa ordem.

Clique em Enviar fotos e escolha várias fotos de uma vez ou um arquivo .zip com elas (até 1 GB).

Escolha o que fazer com as fotos que os produtos já têm: Adicionar às fotos atuais (padrão: uma nova principal vai para a frente e as outras entram depois) ou Substituir as fotos atuais.

Confira a prévia antes de enviar. Para cada produto, ela mostra as miniaturas na ordem em que as fotos vão ficar, e avisa quais não cabem no limite de 10. Depois vêm as que ficaram de fora: as ambíguas (um nome que serve para mais de um produto, ou duas fotos para a mesma posição) e os arquivos recusados. As fotos sem produto aparecem com um campo para você escolher o produto (busque pelo nome ou pelo SKU) ou com Ignorar. Nada é salvo até você clicar no botão Enviar com o número de fotos.

Acompanhe o envio. Se alguma foto falhar, o motivo aparece ao lado dela e Tentar de novo as que falharam reenvia só essas.

Para resolver uma foto ambígua, renomeie o arquivo e envie de novo.

Produtos que vêm de uma loja conectada ficam fora do Enviar fotos: a foto deles vem da loja e voltaria na próxima sincronização. Troque a foto na própria loja.

Variantes

Tamanho, cor, capacidade: as variantes chegam prontas de uma loja conectada, cada uma com seu preço, SKU e estoque. No cadastro manual e na planilha cada linha é um produto só. Para vender o iPhone 15 em duas cores sem loja conectada, cadastre dois produtos: "iPhone 15 128 GB Preto" e "iPhone 15 128 GB Azul".

Quando um produto tem variantes, a IA sempre pergunta qual o cliente quer e só oferece as que têm estoque.

Excluir ou arquivar

No painel do produto, Excluir produto apaga de vez (pede confirmação). Um produto que já aparece em algum pedido não pode ser excluído, porque o pedido guarda o produto: o Vamo oferece Arquivar no lugar. O produto arquivado continua nos pedidos antigos, mas a IA não oferece mais.

Só produtos criados no Vamo podem ser editados ou excluídos aqui. Produtos de uma loja conectada mudam na própria loja.

O que a IA lê de cada campo

CampoO que a IA faz com ele
NomeBusca por ele e chama o produto assim na conversa
DescriçãoUsa para responder dúvidas ("tem carregador na caixa?") e para encontrar o produto
CategoriaAgrupa os produtos quando o cliente pede o catálogo ("o que vocês têm?")
SKUEncontra o produto quando o cliente ou a equipe manda o código
PreçoInforma ao cliente e usa no pedido
EstoqueSabe se tem e quantas unidades há. Sem estoque, não vende
FotoVai no cartão do produto e é a imagem que a IA envia quando o cliente pede a foto. A IA nunca escreve o link da foto no texto
Link da páginaVira o botão do cartão e o link no catálogo do WhatsApp
Observações para a IALidas quando ela consulta os detalhes do produto
Preço mínimo para a IALimita o desconto. A IA nunca diz esse valor ao cliente

Quando você cria ou importa um produto, o Vamo gera sozinho sinônimos em português, espanhol e inglês a partir do nome, da categoria e da descrição. Assim o cliente acha a "capinha" mesmo que o produto se chame "Case MagSafe".

Observações para a IA

Use para o que não cabe na descrição e só a IA precisa saber. Até 2.000 caracteres. Exemplos da Loja Aurora:

  • "Aparelho lacrado, com nota fiscal e 1 ano de garantia Apple."
  • "Se o cliente perguntar por 256 GB, diga que chega na próxima semana."

IA pode oferecer este produto

Desligado, o produto some para a IA: ela não encontra, não mostra e não vende, mesmo que o cliente peça pelo nome. Na lista, a coluna IA vende mostra Não. Sua equipe continua podendo vender esse produto pela caixa de entrada. É útil para peças reservadas, produtos de vitrine ou algo que você prefere negociar pessoalmente.

Preço mínimo para a IA

É o menor preço pelo qual a IA vende o produto quando negocia. Ele vale junto com o desconto máximo da loja (Configurações → Agente IA → Limites), e vale o mais restritivo dos dois. Deixe vazio para não ter mínimo.

Exemplo: o iPhone 15 custa R$ 4.599 e o mínimo é R$ 4.299. Mesmo que a loja permita 15% de desconto, nesse produto a IA dá no máximo 6%. Ela nunca conta ao cliente que existe um mínimo, só não passa dele. Os detalhes estão em Descontos e negociação.

Produto com preço zero

Um produto com preço 0 pode ser salvo, mas a IA nunca o oferece nem o vende. Na lista ele ganha o selo Preço zero. Se o cliente pedir esse produto, a IA responde que alguém da equipe vai ajudar e a conversa passa para vocês. Serve para brindes. Para um produto que tem preço, mas que você não quer divulgar, use Preço sob consulta.

Importar uma planilha

Em Estoque, clique em Importar CSV.

Se a sua conta tem mais de uma loja, escolha a loja. Confira a moeda em Moeda quando o arquivo não tem coluna de moeda.

Envie o arquivo. O Vamo confere a planilha e mostra uma prévia: quantos produtos são novos, quantos serão atualizados e quais linhas têm erro, com o motivo.

Se a prévia estiver certa, clique no botão de importar, que mostra quantos produtos entram (por exemplo, Importar 158 produtos). Nada é gravado antes disso.

Janela Importar Produtos com a prévia da planilha da Loja Aurora: produtos novos, a atualizar e linhas com erro

O arquivo

  • Formato: só CSV. Uma planilha .xlsx não é aceita: no Excel, use Salvar como → CSV; no Google Planilhas, Arquivo → Fazer download → CSV.
  • Separador: vírgula ou ponto e vírgula. O Vamo descobre sozinho, então o CSV do Excel em português funciona como está.
  • Acentos: saem certos tanto em CSV quanto em CSV UTF-8 do Excel. Outros formatos de texto, como "Texto Unicode", aparecem com caracteres estranhos.
  • Tamanho: até 5 MB e 10.000 linhas por arquivo. Para mais, divida em arquivos menores.

Colunas

A primeira linha é o cabeçalho. Maiúsculas e acentos não importam, e você pode escrever em português, espanhol ou inglês.

ColunaTambém aceitaObrigatóriaO que vai nela
nomeproduto, nombre, nameSimAté 255 caracteres
preçovalor, precio, priceSimMaior que zero, ou sob consulta (veja Preço sob consulta)
preço mínimoprecio mínimo, min_priceNãoNão pode ser maior que o preço
moedamoneda, currencyNãoBRL, PYG ou USD
estoquequantidade, cantidad, stockNãoNúmero inteiro. Vazio num produto novo vira 0
controla_estoquecontrola estoque, controla stockNãosim ou não. Com não, o estoque não é controlado (veja Produto sem controle de estoque). Vazio mantém o que está cadastrado
skucódigo, referência, refNãoAté 50 caracteres
categoriacategoryNãoAté 100 caracteres
descriçãodescripción, descriptionNãoAté 2.000 caracteres
imagemfoto, imagen, image_urlNãoLink da foto, com https://
linkurl, enlaceNãoPágina do produto no seu site

Escreva só o nome da coluna. "Preço (R$)" não é reconhecido como preço: tire o "(R$)".

Categoria e link da página só entram pela planilha (ou por uma loja conectada). O cadastro manual não tem esses campos.

Exemplo

A planilha da Loja Aurora, salva pelo Excel com ponto e vírgula:

produtos-aurora.csv
nome;sku;preço;preço mínimo;estoque;categoria;descrição;imagem;link
iPhone 15 128 GB Preto;IP15-128-PT;4.599,00;4.299,00;3;Celulares;Lacrado, com nota fiscal e 1 ano de garantia;https://lojaaurora.com.br/fotos/iphone15-preto.jpg;https://lojaaurora.com.br/iphone-15
Capinha MagSafe iPhone 15;CAP-MS-15;149,90;;25;Acessórios;Silicone, várias cores;https://lojaaurora.com.br/fotos/capinha.jpg;
Carregador USB-C 20W;CAR-20W;129,90;;0;Acessórios;Carregamento rápido;;

O carregador entra com estoque 0: aparece no filtro Sem estoque e a IA não vende até você repor.

Como escrever o preço

Escreva como você escreve no dia a dia. Em real e em dólar, os centavos podem vir depois de vírgula ou de ponto, com ou sem separador de milhar:

MoedaAceitoRecusado (ambíguo)
Real (BRL)10,50, 10.50, 1.899,90, 1899.90, R$ 99,90, 4599, 1.2501,250, 1.250.50
Guarani (PYG)150.000, 1.250.000, Gs. 75.000150,000, 1.250,50
Dólar (USD)1,250.50, 10,50, US$ 3,000, 19.991.250

Quando um preço pode ser lido de dois jeitos, a linha não entra e a prévia mostra o motivo. O Vamo prefere recusar a adivinhar errado.

O estoque é um número inteiro, 0 ou mais. 1.200 e 1,200 são lidos como mil e duzentos. Estoque com texto (cinco), negativo (-3) ou com fração (2,5) não entra: a prévia mostra a linha e o motivo, e as outras linhas são importadas.

Produtos que já existem

Importar de novo atualiza em vez de duplicar. O Vamo procura o produto assim:

  1. Pelo SKU, quando a linha tem um.
  2. Pelo nome, quando a linha não tem SKU ou nenhum produto tem aquele SKU. Maiúsculas e espaços a mais não importam.

Regras que evitam surpresas:

  • Uma linha com SKU só assume, pelo nome, um produto que ainda não tem SKU. "Capinha P" com SKU CAP-P nunca sobrescreve "Capinha G" com SKU CAP-G.
  • Se você mudar o SKU de um produto na planilha, o Vamo cria um produto novo. Arquive o antigo.
  • Nome, preço e moeda são sempre regravados. As outras colunas, quando vazias, mantêm o que já está cadastrado.
  • Um preço mínimo vazio mantém o mínimo atual. Para tirar um mínimo, apague no painel do produto: a planilha não consegue.
  • Uma linha com o preço mínimo vazio cujo novo preço fica abaixo do mínimo já cadastrado não entra. Escreva o novo mínimo na mesma linha.
  • Produtos arquivados ou em rascunho também são encontrados e continuam como estão: a importação nunca reativa um produto.
  • Produtos que não estão na planilha ficam como estão. A importação nunca apaga nada.
  • Se a mesma chave (SKU, ou nome sem SKU) aparece duas vezes no arquivo, vale a última linha e as outras contam como ignoradas.

Confira a moeda antes de importar

A moeda da linha vem da coluna moeda ou, quando ela está vazia, da moeda escolhida na tela. Ao atualizar um produto, essa moeda também é regravada. Se a sua planilha está em reais, deixe BRL selecionado.

Acompanhar o resultado e corrigir erros

Ao importar, a janela fecha e um aviso aparece no topo da lista com o resultado, por exemplo 118 criados · 40 atualizados · 2 com erro. Ele traz três botões:

  • Ver erros: cada linha que não entrou, com o número da linha no seu arquivo (o cabeçalho é a linha 1) e o motivo.
  • Baixar linhas com erro: uma planilha só com essas linhas e uma coluna a mais com o motivo. Corrija e importe de novo: o que já entrou não se repete.
  • Dispensar: tira o aviso.

Importar planilha é coisa de Proprietário, Administrador ou Gerente.

Sem estoque e estoque baixo

A IA vê a quantidade exata de cada produto (e de cada variante) no momento em que responde.

SituaçãoO que a IA faz
O produto tem estoqueMostra o produto e vende até a quantidade disponível
O cliente pede mais do que háDiz quantas unidades existem e oferece essa quantidade
O produto está zeradoDiz que está sem estoque e não cria o pedido. Se sugerir outra coisa, é um produto do mesmo tipo que o cliente pediu
Uma variante está zeradaOferece só as variantes com estoque
A loja inteira está sem estoqueDiz isso ao cliente e se oferece para confirmar com a loja
O produto não aparece na buscaNão diz "não temos". Tenta outras palavras e, se não achar, pergunta ou chama a equipe

A IA nunca mostra o cartão de um produto sem estoque. E nunca diz que um produto acabou sem consultar o Estoque naquela mesma resposta.

O Vamo não manda alerta de estoque baixo. Use o filtro Sem estoque para ver o que precisa de reposição.

Como o estoque muda

O número do Estoque é o que está disponível para vender agora. Ele muda nestes momentos:

QuandoO que acontece com o estoque
A IA cria um pedidoAs unidades saem na hora, reservadas para o cliente (veja Pedidos e reservas)
A reserva de um pedido da IA expira sem o pedido avançarAs unidades voltam
O cliente muda o pedido com a IAO pedido antigo é cancelado e as unidades dele voltam antes de o novo sair
Sua equipe cria um pedido pelo /pedidoAs unidades saem na hora
Sua equipe cancela um pedido Pendente ou ConfirmadoAs unidades voltam
Sua equipe cancela um pedido EnviadoNada volta: os produtos já saíram. Ajuste o estoque à mão se eles voltarem
Sua equipe recusa um pedido da IA que aguardava aprovaçãoAs unidades voltam
Você edita o produto ou importa uma planilhaVale o número que você escreveu
A loja conectada informa o estoqueVale o número da loja, menos as unidades que pedidos do Vamo ainda seguram (veja Integrações de loja)

Quando duas pessoas querem a última unidade, quem confirma primeiro leva: o Vamo nunca vende a mesma unidade duas vezes.

Editar preço e estoque na lista

Para mudar só o preço ou o estoque, não precisa abrir o produto: clique no preço ou no estoque da linha, escreva o novo valor e aperte Enter. O preço é escrito como na sua moeda (4.599,00 em reais) e aparece formatado assim que salva. Esc desiste da mudança.

Produtos da loja conectada não são editados aqui: o preço e o estoque deles vêm da loja. Um produto com variantes também não, porque cada variante tem o seu preço e o seu estoque.

Produto sem controle de estoque

Tem produto que você não conta unidade por unidade: perfume fracionado, peça sob encomenda, item que sempre chega do fornecedor. No produto, ligue Não controlo estoque deste produto. Na planilha, escreva não na coluna controla_estoque.

  • Na lista, o estoque aparece como Não controlado, e o produto não entra no filtro Sem estoque.
  • A IA vende qualquer quantidade, e os pedidos não baixam o estoque.
  • Para parar de vender, arquive o produto. Para voltar a contar, desligue a opção e informe o estoque.

Ao importar, a opção Estoque vazio = não controlado faz isso de uma vez: todo produto novo com a coluna de estoque vazia entra como não controlado. Produtos que já existem continuam como estão.

Preço sob consulta

Para produtos em que o preço depende da conversa (uma moto, um celular importado com cotação do dia), ligue Preço sob consulta no produto, ou escreva sob consulta (ou consultar) na coluna de preço da planilha.

  • Na lista, o preço aparece com o selo Sob consulta.
  • A IA não informa um preço fixo para esse produto.
  • Você pode preencher uma faixa de preço (de, até). Ela é opcional e só aparece ao cliente se a loja permitir que a IA cite a faixa.
  • O produto não vai para o catálogo do WhatsApp: a Meta exige preço em todo item.
  • Um produto sob consulta não tem preço mínimo para a IA, porque não há preço para negociar.

Atualizar todos os preços de uma vez

Quando o dólar muda e você precisa reajustar o catálogo inteiro, use a planilha em vez de editar produto por produto:

Em Estoque, clique em Exportar CSV. O arquivo traz todos os produtos da loja, menos os arquivados, com as mesmas colunas que a importação lê.

Abra no Excel ou no Google Planilhas e mude a coluna preço (e o preço mínimo, se você usa). Uma fórmula sobre a coluna inteira resolve em segundos. Não mude o sku nem o nome: é por eles que o Vamo reconhece cada produto.

Salve como CSV e importe em Importar CSV. A prévia mostra todos os produtos como a atualizar. Confira e importe.

Os pedidos já feitos mantêm o preço antigo. As colunas source e external_id do arquivo exportado são ignoradas na importação.

Nesta página