Plugin WordPress e WooCommerce

O plugin ORYKSA AI Employees põe o colaborador de IA num site WordPress ou loja WooCommerce: chat com o nome e a foto do dono, aprendizagem de páginas e produtos, ações de carrinho e checkout, 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

Plugin	Versão	Última atualização	Requisitos	Licença
ORYKSA AI Employees (download direto; publicação no WordPress.org em preparação)	1.1.6	2026-10-01	WordPress 5.8+, PHP 7.2+, compatível com HPOS do WooCommerce	GPL-2.0+

Instalar (sem código)

Atualização: se tinha a versão anterior instalada, desative-a e apague-a antes de ativar esta.

1. Plugins > Adicionar novo > Carregar plugin, escolhe o zip, Instalar agora, Ativar.
2. Definições > ORYKSA AI Employees > Ligar à ORYKSA > Ligar site: o dono entra na ORYKSA e aprova. Nada para copiar.
3. O chat fica ativo no site. No WooCommerce a IA também abre produtos, põe-nos no carrinho e abre o checkout.

Fluxo de ligação

O botão Ligar site usa um código de uso único: dura 10 minutos, o URL de retorno tem de ser /wp-admin/ no mesmo host, e o state é verificado com um transient de 30 minutos. O plugin troca o código servidor a servidor e guarda o token do widget.

GET  https://auth.oryksa.com/wordpress/connect?site=&return=&state=&lang=&woo=
     -> the owner signs in and approves
     <- browser returns to <return>?oryksa_code=...&state=...
POST https://app.oryksa.com/wordpress/exchange   {code, site}      (server to server)
     <- {token, name}

O chat

O plugin carrega o mesmo widget que qualquer outro site, por isso a aparência, as línguas, a voz e as regras do plano são iguais. O nome e a foto vêm de A tua IA na ORYKSA; o plugin nunca os altera.

<script src="https://app.oryksa.com/static/oryksa-widget.js"
        data-token="..." data-position="right" data-lang="auto"
        data-platform="woocommerce" data-checkout="/checkout/"></script>

O que a IA faz no site

Ação	Chat do site	WhatsApp e Telegram
[OPEN:url]	Abre a página	Envia o link
[CART:id:qty]	POST /?wc-ajax=add_to_cart (id do produto ou da variação) e atualiza o mini carrinho	Envia /?add-to-cart=ID&quantity=N
[CHECKOUT]	Abre o checkout	Envia /checkout/

Sincronização

Páginas, artigos e produtos publicados (preço, stock, id de carrinho por produto e opção) vão para o Brain do agente: até 300 itens de 4.000 caracteres. Corre diariamente, 2 minutos depois de publicar, e a pedido com Atualizar agora.

POST https://app.oryksa.com/wordpress/sync
{ "token": "...", "site_url": "https://shop.example", "platform": "woocommerce",
  "pages": [ { "title": "Delivery", "url": "https://shop.example/delivery", "content": "..." } ] }

Vendas (WooCommerce)

O widget cria um cookie próprio oryksa_visitor (30 dias). No checkout o plugin guarda-o no meta da encomenda _oryksa_visitor; em pagamento concluído, em processamento ou concluída reporta a venda. A ORYKSA regista uma conversão de venda, avisa o dono (sino, push, email) e etiqueta a conversa como "venda".

POST https://app.oryksa.com/wordpress/sale
{ "token": "...", "visitor_id": "oryksa_visitor cookie", "order_id": 1043, "order_name": "#1043",
  "total": "59.90", "currency": "EUR", "items": [ { "name": "Blue mug", "qty": 2 } ] }

Nunca enviado: dados de pagamento e moradas dos clientes. Custo: cada resposta da IA é uma interação (canal web). Por cima do plugin podes usar a API v1 (por exemplo POST /v1/conversions) e a ferramenta de widget do MCP.

Perguntas frequentes

• Funciona sem WooCommerce? Sim: chat mais aprendizagem de páginas e artigos.
• De onde vêm o nome e a foto? De A tua IA na ORYKSA; o plugin nunca os altera.
• Como o removo? Desligar em Definições > ORYKSA AI Employees, ou desativar o plugin.