Referência de Ações de IA

Quando conectado com as devidas permissões de API, seu assistente de IA pode realizar as seguintes ações em sua loja PrestaShop em tempo real. Essas ações estão disponíveis em fluxos de trabalho SmartFlow e também podem ser utilizadas pela IA durante conversas com seus clientes.

---

Produtos

Obter Produto

Recupere todos os detalhes de um produto pelo seu ID.

• Entrada: ID do Produto
• Retorna: Nome, descrição, descrição curta, referência, preço, quantidade em estoque, status ativo, campos de SEO (meta título, meta descrição, meta palavras-chave)
• Permissão de API: products (GET)

Atualizar Conteúdo do Produto

Atualize a descrição e/ou descrição curta de um produto, com suporte completo a múltiplos idiomas.

• Entradas: ID do Produto, descrição (opcional), descrição curta (opcional), ID do idioma (opcional — padrão para o idioma principal da loja)
• Retorna: Confirmação com a lista de campos atualizados
• Permissão de API: products (GET + PUT)

dica

A IA preserva o conteúdo em outros idiomas ao atualizar um idioma específico. Por exemplo, atualizar a descrição em francês não afetará a versão em inglês.

Atualizar SEO do Produto

Atualize os campos de SEO de um produto, com suporte a múltiplos idiomas.

• Entradas: ID do Produto, meta título (opcional), meta descrição (opcional), meta palavras-chave (opcional), ID do idioma (opcional)
• Retorna: Confirmação com os valores de SEO atualizados
• Permissão de API: products (GET + PUT)

---

Pedidos

Obter Pedido por Referência

Procure um pedido específico usando seu número de referência (por exemplo, ABCDEF123).

• Entrada: Referência do pedido
• Retorna: Detalhes completos do pedido, incluindo data, status, valor total, método de pagamento, informações de envio e lista de produtos
• Permissão de API: orders (GET), order_details (GET), order_states (GET)

Obter Pedidos por Email

Recupere todos os pedidos feitos por um cliente específico.

• Entradas: Email do cliente, limite (opcional — padrão para 10)
• Retorna: Lista de pedidos com detalhes completos, contagem total
• Permissão de API: orders (GET), order_details (GET), order_states (GET), customers (GET)

Obter Último Pedido

Obtenha o pedido mais recente de um cliente específico.

• Entrada: Email do cliente
• Retorna: O último pedido com detalhes completos, ou nulo se nenhum pedido for encontrado
• Permissão de API: orders (GET), order_details (GET), order_states (GET), customers (GET)

Atualizar Status do Pedido

Altere o status de um pedido (por exemplo, marcar como enviado, marcar como entregue).

• Entradas: ID do Pedido, novo ID de estado do pedido, enviar notificação por email (opcional — padrão para não)
• Retorna: Confirmação com o novo status e se um email foi enviado
• Permissão de API: order_histories (GET + POST)

atenção

Alterar o status de um pedido pode acionar notificações por email para o cliente se a opção sendEmail estiver habilitada. Certifique-se de que o status correto está sendo aplicado.

---

Clientes

Obter Cliente

Procure um cliente pelo seu endereço de email.

• Entrada: Email do cliente
• Retorna: ID do Cliente, nome, sobrenome, email, data de nascimento, status da newsletter, data de registro, notas
• Permissão de API: customers (GET)

Atualizar Cliente

Atualize as informações do perfil de um cliente.

• Entradas: ID do Cliente, nome (opcional), sobrenome (opcional), email (opcional), notas (opcional)
• Retorna: Confirmação com a lista de campos atualizados
• Permissão de API: customers (GET + PUT)

---

Configuração

Obter Idiomas

Liste todos os idiomas configurados em sua loja PrestaShop.

• Nenhuma entrada necessária
• Retorna: Lista de idiomas com ID, nome e código ISO (por exemplo, fr, en, de)
• Permissão de API: languages (GET)

info

Esta ação é utilizada internamente pela IA ao realizar atualizações de produtos em múltiplos idiomas, para garantir que o ID do idioma correto seja utilizado.

---

Tabela Resumo

Ação	Categoria	Leitura	Escrita
Obter Produto	Produtos	Sim	—
Atualizar Conteúdo do Produto	Produtos	Sim	Sim
Atualizar SEO do Produto	Produtos	Sim	Sim
Obter Pedido por Referência	Pedidos	Sim	—
Obter Pedidos por Email	Pedidos	Sim	—
Obter Último Pedido	Pedidos	Sim	—
Atualizar Status do Pedido	Pedidos	—	Sim
Obter Cliente	Clientes	Sim	—
Atualizar Cliente	Clientes	Sim	Sim
Obter Idiomas	Config	Sim	—

---

Relacionados

• Permissões de API — Configure as permissões de Webservice necessárias
• Webhooks & Skills — Acione essas ações automaticamente em eventos da loja