Integrações de loja
Conecte a Shopify ou o WooCommerce para a IA vender com o estoque e os preços reais da loja, e entenda o que sincroniza e quando.
Se você já vende numa loja virtual, conecte a loja ao Vamo em vez de cadastrar tudo de novo. A IA passa a responder com os produtos, os preços e o estoque reais da loja, e os pedidos que ela fecha no WhatsApp podem ir para a loja também.
Hoje funcionam a Shopify e o WooCommerce. O Google Sheets e as outras plataformas da tela aparecem como Em breve.
Antes de começar
- Uma plataforma por loja. Cada loja do Vamo tem uma plataforma conectada por vez. Enquanto uma está conectada, a outra aparece Bloqueado. Para trocar, desconecte a atual.
- Quem pode conectar: Proprietário ou Administrador. Os outros papéis veem o status, mas não conectam nem desconectam.
- Os produtos manuais ficam. O que você cadastrou à mão no Vamo nunca é alterado pela sincronização. Mas, com a loja conectada, Novo produto e Importar CSV ficam desativados: o catálogo novo vem da loja.
Conectar
Vá em Configurações → Integrações, no grupo Lojas, e clique no cartão da sua plataforma.
Pelo app da Shopify (o jeito mais simples):
Em Domínio da loja, digite o endereço no formato nome.myshopify.com (por exemplo, loja-aurora.myshopify.com).
Clique em Conectar com a Shopify. A Shopify abre nesta mesma aba.
Aprove o acesso. Você volta para o Vamo e a importação dos produtos começa sozinha.
Por um app personalizado, se a sua loja já usa um:
No admin da Shopify, abra Configurações → Aplicativos e canais de vendas → Desenvolver aplicativos (ou o Dev Dashboard) e crie um app.
Em Escopos da Admin API, marque read_products, read_inventory e write_draft_orders. Marque também read_locations se quiser escolher os locais de estoque.
Instale o app na loja e copie o Token de acesso da Admin API (ele aparece uma vez só) e a Chave secreta da API.
No Vamo, clique em Usar um app personalizado, preencha o domínio, o token e a chave secreta e conecte.
Se faltar alguma permissão, o Vamo diz quais são. Adicione no app, reinstale e tente de novo.
Enquanto importa, o painel mostra Importando os produtos…. Um catálogo grande pode levar alguns minutos.
O que vem da loja
| Da loja para o Vamo | Detalhes |
|---|---|
| Produtos | Nome, descrição (em texto simples), fotos, categoria e link da página |
| Variantes | Tamanho, cor, capacidade, cada uma com preço, SKU e estoque próprios |
| Preço | Sempre o preço atual da loja. No WooCommerce, o preço promocional já vem aplicado |
| Estoque | A quantidade disponível. Na Shopify, somando os locais que você escolher |
| Status | Produtos publicados ficam ativos. Rascunhos só entram com Importar rascunhos ligado |
O que não entra:
- Produtos sem preço (preço zero).
- Rascunhos, a não ser que você ligue Importar rascunhos.
- No WooCommerce, variações desativadas.
- Pedidos feitos no seu site. O Vamo lê só os produtos e o estoque.
Um produto apagado na loja sai do Vamo. Se ele já aparece em algum pedido, fica arquivado em vez de apagado, para o histórico continuar completo.
Estoque que a loja não conta
No WooCommerce, um produto com Gerenciar estoque desligado só diz se está "Em estoque" ou não. Enquanto estiver em estoque, a IA vende a quantidade que o cliente pedir, e o Vamo não desconta unidades dele. Para a IA respeitar uma quantidade, ligue Gerenciar estoque no produto.
Na Shopify, todo produto é tratado como contado. Um produto com o controle de quantidade desligado costuma chegar com estoque 0, e a IA não vende.
A loja manda
A loja é a fonte da verdade. Nome, descrição, fotos, preço, estoque e variantes de um produto sincronizado mudam só na Shopify ou no WooCommerce: o painel do produto no Vamo mostra "Nome, fotos, preço e estoque vêm da Shopify. Para mudar, edite na Shopify."
Três coisas são do Vamo e a sincronização nunca mexe nelas:
- IA pode oferecer este produto;
- Observações para a IA;
- Preço mínimo para a IA.
Se a loja baixar o preço para menos que o preço mínimo, a IA vende pelo preço da loja e não dá desconto nenhum nesse produto.
Quando sincroniza
| Quando | O que acontece |
|---|---|
| Você muda algo na loja | A loja avisa o Vamo e o produto se atualiza em poucos segundos |
| Alguém compra no seu site | O estoque novo chega do mesmo jeito, em segundos |
| A cada hora | O Vamo confere o catálogo inteiro e corrige qualquer diferença. Uma sincronização que falhou é tentada de novo aqui |
| Você clica em Sincronizar agora | Importação completa na hora |
O botão Sincronizar agora fica no topo do Estoque e no painel da loja em Integrações. No Estoque, a aba Sincronização mostra a última importação completa, o último aviso da loja e cada execução (Importação completa, Aviso da loja, Conferência, Pedido da IA), com o que foi criado, atualizado ou removido e se deu certo.
Se a loja de repente responder sem nenhum produto (uma falha dela, por exemplo), o Vamo não apaga o seu catálogo: a sincronização é marcada como falha e tenta de novo na hora seguinte.
Pedidos do WhatsApp na loja
Por padrão, os pedidos que a IA fecha ficam só no Vamo. Para criá-los também na loja e concluir por lá, abra a loja em Configurações → Integrações e ligue Enviar pedidos da IA para a loja.
Como o pedido aparece na loja:
- Shopify: como pedido com pagamento pendente. Se a sua loja não tem a condição de pagamento "no recebimento", ele fica como rascunho de pedido, e você conclui na Shopify.
- WooCommerce: como pedido Pendente. Você cobra e muda o status quando receber.
O que vale saber:
- O preço é o combinado na conversa, com o desconto que a IA deu, não o preço de tabela.
- Só vão pedidos da IA, e só quando todos os itens vieram da loja conectada. Pedidos que a sua equipe cria pelo
/pedidoficam no Vamo. - Pedido que espera aprovação só vai para a loja depois que alguém da equipe aprova (veja Pedidos e reservas).
- Ao ligar a opção, os pedidos da IA das últimas 24 horas que ainda não estão na loja são enviados na conferência da hora seguinte.
- Falhou? Aparece em Estoque → Sincronização como execução Pedido da IA que falhou. Na Shopify, o Vamo tenta de novo sozinho. No WooCommerce, não: repetir poderia criar o pedido duas vezes na loja, então confira na loja e, se não estiver lá, crie à mão.
Depois que um pedido está na loja, ele é gerenciado lá. No Vamo, ele aparece como Gerenciado pela Shopify (ou pelo WooCommerce) com o botão Abrir na Shopify, e as etapas não mudam por aqui. O Vamo acompanha o que a loja diz:
| Na loja | No Vamo |
|---|---|
| Pedido atendido (Shopify) ou concluído (WooCommerce) | Entregue |
| Pedido cancelado, ou reembolsado por inteiro | Cancelado, mesmo que já estivesse entregue |
| Reembolso parcial | Nada muda |
Na Shopify, cancelamentos, reembolsos e entregas só chegam ao Vamo se o app tiver a permissão de ler pedidos (read_orders). Sem ela, o painel da loja mostra o aviso "Cancelamentos e reembolsos não chegam ao Vamo sem a permissão de pedidos". Para receber, adicione a permissão ao app e reconecte.
Estoque enquanto o pedido não chega à loja
Quando a IA cria um pedido, as unidades saem do estoque do Vamo na hora. Até a loja receber esse pedido, o Vamo segura essas unidades: a cada sincronização, ele desconta do número da loja o que os pedidos abertos dele estão reservando. Assim a mesma unidade não é vendida duas vezes.
Conclua os pedidos na loja
Depois que o pedido chega à loja, quem conta o estoque é ela. No WooCommerce (pedido Pendente) e na Shopify quando o pedido fica como rascunho, a loja só baixa o estoque quando você conclui o pedido lá. Até isso, a próxima sincronização pode devolver a unidade ao Vamo, e a IA pode oferecê-la de novo.
O Vamo segura as unidades de um pedido que não foi para a loja por até 14 dias. Se você usa reservas mais longas que isso, a sincronização volta a mostrar o estoque da loja depois desse prazo.
Quando a reserva acaba e o pedido está na loja
Um pedido da IA fica reservado por um tempo (24 horas, por padrão). Se ele foi enviado à loja e o prazo acaba, o Vamo pergunta à loja antes de cancelar:
| Na loja, o pedido está | O que o Vamo faz |
|---|---|
| Sem pagamento | Cancela na loja também (na Shopify, apaga o rascunho ou cancela o pedido). O estoque volta pela própria loja |
| Pago | Não cancela. A conversa vai para Precisa de você com o aviso "O pedido #3F9A1C2E já foi pago na Shopify e não foi cancelado" |
| O Vamo não tem permissão para cancelar | Não cancela. A conversa vai para Precisa de você para a equipe resolver na loja |
Na Shopify, cancelar um pedido já criado (não um rascunho) precisa da permissão opcional de escrever pedidos (write_orders). Sem ela, cai na última linha da tabela.
Locais de estoque (Shopify)
Se a sua loja guarda estoque em mais de um lugar (a loja física e um depósito, por exemplo), escolha quais contam para a IA.
Em Configurações → Integrações, abra a loja Shopify conectada.
Em Locais de estoque, marque os locais que devem contar. Por padrão, todos contam.
Clique em Salvar locais. O catálogo é importado de novo com o estoque só dos locais marcados.
Se aparecer o aviso para reconectar, a loja foi conectada sem a permissão read_locations. Enquanto isso, o estoque soma todos os locais.
Importar rascunhos
Importar rascunhos traz também os produtos que a loja mantém como rascunho. Fica desligado por padrão. Ao mudar, o catálogo é importado de novo. Rascunhos entram no Vamo como Rascunho, e a IA não oferece rascunhos.
Desconectar
Em Configurações → Integrações, abra a loja e clique em Desconectar. Antes de confirmar, o Vamo mostra o que vai acontecer:
- os produtos e variantes sincronizados são apagados do Vamo (os que já estão em pedidos ficam arquivados);
- os itens da loja saem do catálogo do WhatsApp;
- a IA para de oferecer produtos até você conectar outra loja ou cadastrar produtos;
- automações com passos da loja são pausadas;
- pedidos e conversas antigos ficam guardados.
Use Baixar os produtos em CSV antes para guardar uma cópia: o arquivo pode ser importado de novo depois em Estoque → Importar CSV. Para confirmar, digite o nome da loja e clique em Desconectar e apagar. Não dá para desfazer, mas você pode conectar a loja de novo quando quiser.