Permissões da API
Para desbloquear todo o potencial do AI SmartTalk — como consultar pedidos, atualizar descrições de produtos ou gerenciar clientes — você precisa configurar um token da API do PrestaShop Webservice com as permissões corretas.
Esta etapa é obrigatória se você quiser usar Ações de IA (SmartFlow). Sem isso, seu assistente de IA ainda pode responder a perguntas com base no conhecimento sincronizado, mas não conseguirá acessar dados em tempo real da loja.
1. Habilitando o Webservice
- Vá para Parâmetros Avançados > Webservice
- Habilite o webservice do PrestaShop
- Clique em Salvar
2. Criando uma chave da API
- Na página do Webservice, clique em Adicionar nova chave de webservice
- Preencha o formulário:
- Chave: Clique em Gerar para criar um token seguro ou insira o seu próprio
- Descrição da chave:
AI SmartTalk - Status: Habilitado
- Defina as permissões conforme descrito abaixo
- Clique em Salvar
Copie e salve a chave da API — você precisará dela ao configurar a integração no AI SmartTalk.
3. Permissões necessárias
Na seção de permissões da sua chave da API, habilite os seguintes recursos:
| Recurso | GET | PUT | POST | Descrição |
|---|---|---|---|---|
| produtos | Sim | Sim | — | Ler detalhes do produto, atualizar descrições e SEO |
| pedidos | Sim | — | — | Consultar pedidos por referência ou cliente |
| detalhes_do_pedido | Sim | — | — | Visualizar produtos dentro de um pedido |
| estados_do_pedido | Sim | — | — | Ler rótulos de status do pedido |
| históricos_do_pedido | Sim | — | Sim | Ler histórico de status, adicionar alterações de status |
| clientes | Sim | Sim | — | Consultar e atualizar informações do cliente |
| idiomas | Sim | — | — | Listar idiomas disponíveis da loja |
Marque apenas as permissões listadas acima. Não há necessidade de conceder acesso a outros recursos.
4. Para que cada recurso é usado
Produtos (leitura + gravação)
- Leitura: Recuperar detalhes do produto — nome, descrição, descrição curta, preço, referência, estoque, campos de SEO (título meta, descrição meta, palavras-chave meta)
- Gravação: Atualizar descrições de produtos, descrições curtas e campos de SEO com suporte total a múltiplos idiomas
Pedidos (somente leitura)
- Consultar um pedido pelo número de referência
- Listar pedidos para um cliente específico (por e-mail)
- Obter o pedido mais recente de um cliente
Detalhes do Pedido (somente leitura)
- Visualizar os produtos dentro de um pedido: nome, referência, quantidade, preço unitário
Estados do Pedido (somente leitura)
- Recuperar o rótulo legível para humanos de cada status de pedido (por exemplo, "Pagamento aceito", "Enviado")
Históricos do Pedido (leitura + criação)
- Leitura: Visualizar o histórico de alterações de status de um pedido
- Criar: Adicionar uma nova alteração de status a um pedido (por exemplo, marcar como enviado), com notificação por e-mail opcional ao cliente
Clientes (leitura + gravação)
- Leitura: Consultar um cliente por e-mail ou ID — recuperar nome, e-mail, data de registro, status da newsletter, notas
- Gravação: Atualizar informações do cliente (primeiro nome, sobrenome, e-mail, notas)
Idiomas (somente leitura)
- Listar todos os idiomas configurados na sua loja (usado para atualizações de produtos multilíngues)
5. Inserindo a chave da API no AI SmartTalk
Uma vez que sua chave de Webservice esteja criada e configurada:
- Vá para a configuração do módulo AI SmartTalk no PrestaShop
- A chave da API é normalmente transmitida durante a conexão OAuth
- Se você precisar atualizá-la, vá para o seu painel do AI SmartTalk > Integração > PrestaShop e atualize o token do Webservice
Para configurações de múltiplos sites, cada site pode ter sua própria chave da API do Webservice configurada de forma independente.
Próximos passos
- Sincronize os dados da sua loja — Envie seu catálogo de produtos para a IA
- Veja o que a IA pode fazer — Referência completa das ações disponíveis