Módulo PrestaShop
Última atualização:
Para administradores PrestaShop e gestores técnicos. Anterior: · A seguir:
O módulo PrestaKick liga PrestaShop ao PrestaKick, sincroniza dados e apresenta funcionalidades direcionadas ao cliente no website.
Abre a secção de gestão de módulos
Depois de instalar o módulo, abra PrestaKick AI no PrestaShop Back Office. As principais secções são:
- Connection: ligação à loja e acesso a dados.
- Widget: configuração do quadro de chat.
- Features: ativar a pesquisa e as sugestões de produtos.
- Cron Jobs: configurar tarefas recorrentes e visualizar registos.
- AI Content e AI Translate: criar ou traduzir conteúdos no Back Office.
- Support: ver informações de apoio.
Depois de alterar a configuração, selecione Save configuration. Se sair da página antes de guardar, a alteração não terá efeito.
Liga usando OAuth
OAuth é a forma recomendada de ligar:
- Abrir Connection.
- Selecionar Connect with PrestaKick.
- Iniciar sessão no Dashboard se necessário.
- Selecione a loja certa e depois selecione Confirm connection.
- Regresse ao módulo e verifique o estado do Connected.
- Selecione Save configuration.
Completa uma ligação antes de abrir um novo fluxo OAuth. As ligações OAuth têm tempo limitado e só podem ser usadas uma vez.
Ligação manual
Usa Connect manually apenas quando não conseguires ligar-te usando OAuth. Precisa de introduzir os valores fornecidos pelo Dashboard, incluindo:
- PrestaKick URL
- Module Secret
- API Base URL
- Widget Key
- Shop ID
- API Widget URL
Para uma loja ativa, a API deve apontar para https://api.prestakick.com e o serviço de chat para https://chat.prestakick.com.
Depois de entrares, seleciona Save configuration e depois Test connection.
Permissões de acesso a dados
A secção Store API Key permite- PrestaKick solicitar dados à loja. API Permissions especificar o tipo de dados a ler, por exemplo:
- Produtos e categorias.
- Clientes e encomendas.
- Carrinho de compras.
- Armazenar informação.
- Páginas CMS.
Ativa apenas os tipos de dados de que precisas. Se desativar uma permissão, podem faltar funcionalidades que dependem desse tipo de dados.
Quando crias uma nova chave API, a chave antiga deixa de funcionar. Seleciona Save configuration e depois atualiza quaisquer sistemas que ainda usem a chave antiga.
Permitir pesquisa e sugestões
Features aberto para gerir:
- Image Search (Vision Search): pesquisa de produtos por imagens.
- Semantic Search: encontrar produtos pelo significado.
- Display Related Products: exibir produtos relacionados em locais selecionados.
Se a página mostrar API connection required, complete a ligação primeiro. Algumas características requerem um plano adequado; ver .
Como os dados são sincronizados
Quando os dados mudam em PrestaShop, o módulo adiciona a alteração a uma fila. O cron processa a fila e envia os dados para PrestaKick.
Também pode pedir uma resincronização a partir da página Data sync no Dashboard. Cada tipo de dados tem um limite manual de frequência de sincronização; Se vires uma mensagem de limite, espera até poderes tentar novamente.
Estado da Ligação
| Estado | Significado | O que fazer |
|---|---|---|
| Healthy | Sinal de atividade recente e fila normal | Não é necessária qualquer ação |
| Degraded | Sinais antigos ou filas em crescimento | Verifique o cron e os registos se o estado persiste |
| Offline | Não a receber sinal recente | Verifica o módulo, cron e ligação à Internet do servidor |
| Unknown | Dados de avaliação insuficientes | Espere alguns minutos após a primeira ligação |
Connected apenas confirma que os detalhes da ligação são válidos. Os estados acima refletem a atividade recente do módulo.
Configurar Empregos Cron
- Abrir Cron Jobs → Definições.
- Copiar o comando ou URL fornecido pelo módulo.
- Adicione ao agendador do seu host de acordo com a frequência apresentada no ecrã.
- Use Run now para um teste, se necessário.
- Abra os Cron Jobs → Logs para ver os resultados.
Não partilhe URLs cron porque contêm códigos de segurança. Se os registos reportarem Unauthorized: invalid or missing cron token., copie a nova informação do Settings e atualize-a no alojamento.
Conteúdo com IA e Tradução por IA
AI Content apoia a criação de conteúdo. AI Translate suporta tradução para outras línguas. Cada secção tem os seus próprios cenários e história.
Revise o conteúdo gerado por IA antes de publicar. Verifique nomes de produtos, especificações, políticas e terminologia da marca.
Quando é preciso apoio
Enviar para o suporte:
- Nome da loja e domínio da loja.
- Captura de ecrã completa da mensagem de erro.
- Quando ocorreu o erro, com o fuso horário.
- Estado na Connection e registos relacionados em Cron Jobs → Logs.
Não envie Segredos de Módulo, Chaves API, Chaves de Widget ou tokens cron.