ORYKSAORYKSADevelopers
Obter chaves de API

App Shopify

Instale a ORYKSA em uma loja Shopify com um clique: chat na loja, memória do catálogo, carrinho, status dos pedidos e avisos de venda.

Só para clientes. Este canal atende os clientes da empresa (perguntas, vendas, agendamentos) com o seu Brain, produtos e serviços. Nunca é uma interface do dono: não altera configurações, não lê Atividades nem aceita ordens do dono, mesmo que alguém diga que é o dono. O dono fala com a ORYKSA só no app ORYKSA oficial, no painel e na extensão do navegador. Saiba mais

O que o app faz

  • Coloca o chat da ORYKSA na loja virtual como incorporação de aplicativo do tema: o lojista ativa com um clique (sem código, sem tokens).
  • Aprende os produtos (preço, variantes, marca, descrição), as páginas e as políticas em uma memória própria dessa loja.
  • No chat da loja a ORYKSA age pelo cliente: abre a página do produto, coloca a variante exata no carrinho e abre o checkout. No WhatsApp e no Telegram envia links de adicionar ao carrinho (/cart/add?id=VARIANTE&quantity=1) e de comprar agora (/cart/VARIANTE:1). Os carrinhos levam o atributo oryksa=chat.
  • Informa o status do pedido só quando o cliente informa o número e o email certo.
  • Avisa o dono (sino, push, email) de cada pedido feito pelo chat da ORYKSA, com o resumo do pedido, e conta em Conectores > Shopify.
  • As conversas da loja aparecem em Atividade no painel, onde o dono pode responder ao vivo (a IA fica em pausa para esse visitante).

Instalar

Os lojistas instalam em Conectores > Shopify no painel, ou por um link de instalação. A partir de uma ferramenta de programação com IA, a ferramenta MCP oryksa_shopify devolve o link:

oryksa_shopify { "action": "install_link", "shop": "minha-loja.myshopify.com" }
oryksa_shopify { "action": "status" }
oryksa_shopify { "action": "sync", "store_id": "shp_..." }

Ativar o chat

  1. Instale o app e clique em Conectar a loja na página da ORYKSA.
  2. Clique em Ativar o chat na loja. O editor do tema abre em Incorporações de aplicativos com o ORYKSA chat já ativado.
  3. Clique em Salvar. O chat passa a aparecer em todas as páginas da loja virtual.
  4. Manualmente: Loja virtual > Temas > Personalizar > Incorporações de aplicativos (barra lateral) > ativar ORYKSA chat > Salvar.

O chat é uma incorporação de aplicativo do tema: o código do tema não é alterado, e desativar ou desinstalar o app o remove.

Permissões

PermissãoPara quê
read_productsCatálogo, preços e variantes
read_online_store_pagesPáginas da loja (entrega, FAQ, sobre)
read_legal_policiesPolíticas de devolução, privacidade e entrega
read_ordersStatus dos pedidos, só depois de verificar o email
write_customersSalva nos Clientes da loja os contatos deixados no chat

O app nunca lê pagamentos nem altera produtos ou pedidos. Desinstalar remove o chat e a memória da loja.

Webhooks

As atualizações de conhecimento vindas da loja emitem o webhook knowledge.updated com "source": "shopify".