ORYKSAORYKSADevelopers
Obter chaves de API

App Shopify

Instala a ORYKSA numa loja Shopify com um clique: chat na loja, memória do catálogo, carrinho, estado das encomendas e avisos de venda.

Só para clientes. Este canal atende os clientes da empresa (perguntas, vendas, marcações) com o teu Brain, produtos e serviços. Nunca é uma interface do dono: não muda definiçõ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ó na app ORYKSA oficial, no painel e na extensão do browser. Saber mais

O que a app faz

  • Põe o chat da ORYKSA na loja online como incorporação de aplicação do tema: o lojista ativa-o com um clique (sem código, sem tokens).
  • Aprende os produtos (preço, variantes, marca, descrição), as páginas e as políticas numa memória própria dessa loja.
  • No chat da loja a ORYKSA age pelo cliente: abre a página do produto, põe 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 já (/cart/VARIANTE:1). Os carrinhos levam o atributo oryksa=chat.
  • Dá o estado da encomenda só quando o cliente indica o número e o email certo.
  • Avisa o dono (sino, push, email) de cada encomenda feita pelo chat da ORYKSA, com o resumo da encomenda, e conta-a em Conectores > Shopify.
  • As conversas da loja aparecem em Atividade no painel, onde o dono pode responder em direto (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": "a-minha-loja.myshopify.com" }
oryksa_shopify { "action": "status" }
oryksa_shopify { "action": "sync", "store_id": "shp_..." }

Ligar o chat

  1. Instala a app e carrega em Ligar a loja na página da ORYKSA.
  2. Carrega em Ativar o chat na loja. O editor do tema abre em Incorporações de aplicações com o ORYKSA chat já ativado.
  3. Carrega em Guardar. O chat passa a aparecer em todas as páginas da loja online.
  4. À mão: Loja online > Temas > Personalizar > Incorporações de aplicações (barra lateral) > ativar ORYKSA chat > Guardar.

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

Permissões

PermissãoPara quê
read_productsCatálogo, preços e variantes
read_online_store_pagesPáginas da loja (envios, FAQ, sobre)
read_legal_policiesPolíticas de devolução, privacidade e envio
read_ordersEstado das encomendas, só depois de verificar o email
write_customersGuarda nos Clientes da loja os contactos deixados no chat

A app nunca lê pagamentos nem altera produtos ou encomendas. 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".