Tradução preliminar: esta página aguarda revisão por uma pessoa nativa do idioma.
Para lojas virtuais com acesso aos dados dos pedidos
Uma resposta clara sobre o pedido, no idioma do cliente.
Conecte sua API de pedidos ou credenciais REST somente de leitura do WooCommerce. Seu servidor valida o número do pedido e o e-mail antes de retornar os dados à conversa.
get_order({ order_id: "DEMO-1042", email: "[email protected]" }) → status: "en tránsito", carrier: "Transportista Demo", eta: "2–3 días hábiles"
Resposta da IA
Tu pedido está en tránsito con Transportista Demo. La fecha estimada en el sistema es dentro de 2–3 días hábiles.
Seu servidor deve validar o número do pedido e o e-mail juntos. Incorporar o widget não dá acesso aos pedidos.
Consulta de pedido com validação no servidor
Nome da ferramenta
get_order
Descrição
Leia status, transportadora e previsão de entrega somente após validar o número do pedido e o e-mail.
URL do endpoint
GET https://api.example.com/verified-orders/{order_id}
Autenticação
Authorization: Bearer {{ORDER_API_SECRET}}
Mapeamento de entrada
order_id ← input.order_id
email ← input.email
Mapeamento de saída
status ← $.order.status
carrier ← $.shipping.carrier
eta ← $.shipping.eta
Configuração de exemplo. Use sua API de pedidos ou credenciais REST somente de leitura do WooCommerce e configure o endpoint e os campos.
O servidor deve validar order_id e email juntos antes de retornar dados. Mantenha as credenciais do WooCommerce no servidor; instruções à IA não substituem o controle de acesso.
Conecte a fonte de pedidos que você controla
Use sua própria API de pedidos ou credenciais REST somente de leitura do WooCommerce. Configure o endpoint e o mapeamento dos campos necessários. Isso exige configuração; não é um conector nativo de plataforma.
Valide o número do pedido e o e-mail no servidor
Antes de retornar qualquer dado do pedido, seu endpoint deve exigir e validar tanto o número quanto o e-mail do cliente. A validação deve ser obrigatória no servidor, não apenas uma instrução à IA. Mantenha as credenciais REST no servidor.
Explique o status em vários idiomas
Consulte status, transportadora e previsão de entrega na fonte conectada. Responda no idioma do cliente e diferencie uma estimativa de uma entrega confirmada. Use a base de conhecimento para as políticas da loja.
Incorpore a conversa; conecte os dados separadamente
Você pode incorporar o widget no Shopify ou na Nuvemshop, mas isso não permite ler pedidos automaticamente. Os conectores de plataforma ficam para uma etapa futura. Alterações de pedidos vão para sua equipe; as ferramentas são somente de leitura.
Dúvidas antes de conectar
O que preciso para consultar pedidos?
Uma API de pedidos sob seu controle ou credenciais REST somente de leitura do WooCommerce, com um endpoint no servidor que valide o número do pedido e o e-mail juntos. Configure a autenticação e retorne apenas os campos necessários à resposta.
Incorporar no Shopify ou na Nuvemshop já permite consultar pedidos?
Não. O código de incorporação adiciona a interface da conversa, mas não lê pedidos da plataforma. Os conectores nativos ficam para uma etapa futura; a consulta exige uma fonte de dados configurada separadamente.
O cliente pode consultar apenas com o número do pedido?
Seu servidor deve rejeitar essa solicitação. O número do pedido e o e-mail precisam ser validados antes do retorno dos dados. Uma instrução à IA, sozinha, não garante esse controle de acesso.
A IA pode alterar ou reembolsar um pedido?
Não. A primeira versão apenas lê informações de pedidos e entregas. Solicitações de alteração podem ser encaminhadas à sua equipe com o contexto da conversa.
O cliente pergunta. A IA consulta seu sistema.
Conecte sua base de conhecimento e APIs somente de leitura para consultar pedidos, transferências, faturas e planos no idioma do cliente.
