Plugin WordPress e WooCommerce

O plugin ORYKSA Força-Tarefa de IA coloca o colaborador de IA em um site WordPress ou loja WooCommerce: chat com o nome e a foto do dono, aprendizado 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, 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

Plugin	Versão	Última atualização	Requisitos	Licença
ORYKSA Força-Tarefa de IA (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 você tinha a versão anterior instalada, desative e exclua essa versão antes de ativar esta.

1. Plugins > Adicionar novo > Enviar plugin, escolha o zip, Instalar agora, Ativar.
2. Configurações > ORYKSA AI Employees > Conectar à ORYKSA > Conectar 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, coloca no carrinho e abre o checkout.

Fluxo de conexão

O botão Conectar site usa um código de uso único: dura 10 minutos, a URL de retorno precisa 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 de qualquer outro site, por isso a aparência, os idiomas, a voz e as regras do plano são iguais. O nome e a foto vêm de Sua IA na ORYKSA; o plugin nunca altera isso.

<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, posts e produtos publicados (preço, estoque, id de carrinho por produto e opção) vão para o Brain do agente: até 300 itens de 4.000 caracteres. Roda diariamente, 2 minutos depois de publicar, e sob demanda 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 cookie no meta do pedido _oryksa_visitor; em pagamento concluído, processando ou concluído reporta a venda. A ORYKSA registra uma conversão de venda, avisa o dono (sino, push, e-mail) e marca 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 endereços dos clientes. Custo: cada resposta da IA é uma interação (canal web). Além do plugin, você pode usar a API v1 (por exemplo POST /v1/conversions) e a ferramenta de widget do MCP.

Perguntas frequentes

• Funciona sem WooCommerce? Sim: chat mais aprendizado de páginas e posts.
• De onde vêm o nome e a foto? De Sua IA na ORYKSA; o plugin nunca altera isso.
• Como removo? Desconectar em Configurações > ORYKSA AI Employees, ou desativar o plugin.