Shopify
Conecte sua loja Shopify uma vez e seus agentes passam a responder a partir do seu catálogo, seus pedidos e seu estoque. A configuração leva cerca de cinco minutos, acontece inteira dentro do Cuneiform Chat e não exige mexer no tema nem instalar plugin.
A Shopify funciona em todos os planos, incluindo o teste gratuito. Conectar uma loja não custa nada a mais.
O que você ganha
Com a loja conectada, seu agente de loja pode:
- Responder perguntas sobre o catálogo a partir dos seus produtos, variantes, opções e preços reais
- Ler estoque e preço do catálogo sincronizado, mantido em dia por webhooks, para não oferecer o que você acabou de esgotar
- Recomendar produtos disponíveis em vez do que ele se lembra
- Consultar pedidos para compradores que consigam provar que o pedido é deles
- Enviar atualizações de status do pedido para quem optar por recebê-las, no mesmo chat
- Levar um comprador decidido ao seu checkout da Shopify com o carrinho inteiro
Pré-requisitos
- Uma loja Shopify que você administre
- Um workspace do Cuneiform Chat e uma conta Owner ou Admin nele — conectar uma loja é uma ação administrativa
- Pelo menos um agent, ou espaço no seu plano para criar um (veja Seu agente de loja)
Contas de colaborador não conseguem concluir a configuração. Parte dela acontece no Dev Dashboard do seu admin da Shopify, que a Shopify não oferece a contas de colaborador. Se uma agência cuida da sua loja, essa parte precisa ser feita pelo dono da loja — ou por uma conta de staff com permissões de app.
Como a conexão funciona
Você cria um pequeno app dentro do seu próprio admin da Shopify, instala na sua loja e cola as credenciais dele no Cuneiform Chat. Os dados da sua loja não saem da sua conta Shopify por nenhum outro caminho, e o app pertence a você, não a nós.
O passo a passo fica no produto, onde ele pode mostrar os valores exatos a preencher para a sua loja — esses valores dependem do seu workspace e da versão da API que estamos rodando, então uma cópia aqui ficaria desatualizada sem avisar você.
Para começar: abra Commerce → Shopify no Cuneiform Chat e siga os passos da tela de conexão. Ela orienta você a criar o app, pedir as permissões abaixo, instalá-lo e colar as credenciais.
Instalar o app é um passo próprio. No Dev Dashboard da Shopify, publicar uma versão do seu app não é o mesmo que instalá-lo na loja. Se você parar na publicação, as credenciais são rejeitadas na hora de colar — e a tela de conexão diz isso explicitamente quando acontece.
Permissões que pedimos
Seu app pede cinco permissões somente leitura. Não há nenhuma permissão de escrita no conjunto — ele não pode alterar nada na sua loja.
| Permissão | Por que precisamos |
|---|---|
read_products | Ler seu catálogo: produtos, variantes, opções, preços, imagens |
read_inventory | Ler o estoque para o agent só recomendar o que está disponível |
read_orders | Consultar o pedido de um comprador e enviar atualizações a ele |
read_fulfillments | Informar o andamento do envio desses pedidos |
read_customers | Conferir o telefone do comprador contra o pedido sobre o qual ele pergunta |
Somente leitura é somente leitura. O app não pode criar, editar ou excluir produtos; não pode ajustar estoque; não pode criar, editar ou cancelar pedidos; e não pode capturar pagamentos. Toda compra é concluída no seu próprio checkout da Shopify.
Se alguma permissão não for concedida
A Shopify restringe o acesso a clientes e pedidos nos seus planos mais baratos, então uma loja no Basic ou no Starter pode não conseguir conceder read_orders nem read_customers. Quando isso acontece, a conexão é concluída mesmo assim e o Cuneiform Chat diz quais permissões faltam — na tela de conexão e de novo em Commerce → Shopify → Connection, enquanto a lacuna existir.
Tudo que depende de uma permissão ausente fica desligado em vez de falhar em silêncio; as vítimas habituais são a consulta de pedidos e as atualizações de status. Quando o plano da sua loja cobrir essas permissões, desconecte e conecte a loja de novo para que elas sejam captadas.
Abrir o Cuneiform Chat dentro do seu admin da Shopify
Opcionalmente, seu app pode ser marcado como embedded, o que faz seu painel do Cuneiform Chat abrir dentro do admin.shopify.com, junto com o resto da administração da loja — configuração, status da conexão, ajustes e um dashboard. A tela de conexão fornece os dois valores que a Shopify pede. Pular isso não muda nada no funcionamento da integração; muda apenas de onde você a abre.
Uma loja por workspace
Um workspace conecta uma loja Shopify. Ele também pode ter uma loja WooCommerce conectada ao mesmo tempo — veja Commerce.
Se você tentar conectar uma loja que já está conectada a outro workspace, a tentativa é recusada em vez de tomá-la silenciosamente.
Mudar permissões ou credenciais depois
Não existe um botão “Reconnect” separado. As permissões e as credenciais do seu app são registradas na conexão e não são reescritas depois, então qualquer mudança feita na Shopify — adicionar um scope, girar o client secret — chega ao Cuneiform Chat desconectando e conectando a loja de novo.
Reconectar refaz o desmonte descrito em Desconectando, então leia essa parte antes se você tiver Storefronts vinculadas à loja.
Depois de conectar
- Seu catálogo começa a sincronizar imediatamente. Veja Catálogo e conhecimento para o que a sincronização cobre e como ela se mantém em dia.
- Um agent vira seu agente de loja, escolhido para você na conexão. Veja Seu agente de loja.
- As atualizações de status do pedido vêm ligadas por padrão, e o único gate é do comprador: ele opta por recebê-las depois de verificar o pedido. Veja Pedidos.
Os preços e a moeda da sua loja
Os preços sincronizam com os valores que sua loja guarda, na moeda da sua própria loja — a que as configurações da sua loja Shopify nomeiam. A gente lê da loja, nunca do comprador, e os compradores a veem como o código de três letras ao lado do valor: USD 19,99, EUR 19,99, BDT 1900.
Ser um código e não um símbolo é proposital. $ sozinho é o dólar de quatro países diferentes, e um símbolo errado dito com convicção num preço é pior do que um código inconfundível.
A moeda é relida na reconciliação noturna do catálogo, então se você mudá-la no Shopify o código citado acompanha em um dia. Até essa primeira passada noturna, uma loja conectada antes de a gente começar a ler isso cita valores sem código — o preço continua certo, só ainda não está rotulado.
Os preços do Shopify Markets não são refletidos. Se você vende para vários mercados com moedas próprias, o Shopify mostra a cada comprador um preço local na sua loja. A gente guarda uma moeda por loja — a da sua loja — então o agent cita essa mesma para todo comprador, esteja ele onde estiver.
Os valores continuam certos na moeda com que estão rotulados; eles só não são os números convertidos por mercado que esse mesmo comprador veria no seu site. O checkout não é afetado: o comprador termina no seu checkout do Shopify, que aplica suas regras de mercado como sempre.
Solução de problemas
As credenciais foram rejeitadas
A causa mais comum é o app ter sido publicado mas nunca instalado na loja — são duas ações separadas no Dev Dashboard da Shopify. A tela de conexão diferencia esse caso de uma divergência real de credenciais, então leia a mensagem que ela dá em vez de presumir que o Client ID e o Secret estão errados.
Consulta de pedidos e atualizações de envio não estão disponíveis
Confira Commerce → Shopify → Connection por um aviso de permissão ausente. Nos planos mais baratos da Shopify, read_orders e read_customers podem não ser concedíveis — veja Se alguma permissão não for concedida.
O catálogo está vazio logo depois de conectar
A primeira importação traz o catálogo inteiro e leva alguns minutos numa loja grande. Se ainda parecer vazio depois disso, rode Re-sync now em Commerce → Shopify → Catalog & Data. Enquanto o catálogo estiver vazio, o checklist da aba Overview também oferece um Sync now de um clique.
O agent não responde perguntas sobre produtos
Confirme que você está falando com o agente de loja — aquele vinculado à loja no momento da conexão. A página dele mostra um painel somente leitura dizendo que é gerenciado pela sua loja. Os outros agents não carregam as ferramentas de commerce.
Um Member não consegue conectar a loja
Conectar uma loja exige a permissão Integration connect, que Owners e Admins têm e Members não.
Desconectando
Desconecte em Commerce → Shopify → Disconnect. Ao desconectar:
- A conexão salva e o catálogo sincronizado são removidos
- O conhecimento de produto construído a partir desse catálogo é apagado, então os agents param de responder com ele
- A concessão de commerce do agente de loja é redefinida, sua persona de commerce volta ao original se você nunca a editou, e o próprio agent é arquivado — reconectar a mesma loja o recupera com seus ajustes e histórico de versões intactos
- Qualquer Storefront vinculada àquela loja é excluída permanentemente, junto com seu histórico de analytics. As Storefronts que você montou à mão não são tocadas
- Os Agent Forms de commerce que vieram com a loja são arquivados
- As sugestões de quiz geradas por IA são apagadas, para que uma reconexão futura comece do zero
Se você ainda tiver uma loja WooCommerce conectada, apenas os passos que valem para o workspace inteiro são pulados — arquivar os Agent Forms de commerce e apagar as sugestões de quiz. O catálogo, o conhecimento de produto, as Storefronts, os analytics e o agente da própria loja Shopify são sempre desmontados.
Seu app continua instalado no seu admin da Shopify. Desconectar aqui remove o nosso lado da relação, não o app que você criou — ele é da sua loja. Exclua-o no seu admin da Shopify se quiser que ele suma.
Relacionado
- Visão geral de Commerce — o que conectar uma loja oferece
- WooCommerce — a outra plataforma suportada
- Catálogo e conhecimento — como o catálogo sincroniza e se mantém atualizado
- Pedidos — consulta de pedidos e atualizações de status
- Checkout — levar o comprador até a compra