Integração com o PrestaShop

Ligue o seu chatbot ChatLab à sua loja PrestaShop para dar aos clientes acesso em tempo real a informações sobre produtos e acompanhamento de encomendas diretamente no chat.

Importante: Melhores Práticas de E-Commerce

Depois de concluir a integração abaixo, leia o guia abrangente sobre como otimizar o seu chatbot para e-commerce: Como configurar o ChatLab para a sua loja de E-commerce

O que a Integração Oferece

Pesquisa de Produtos - Os clientes podem pesquisar no seu catálogo PrestaShop introduzindo uma frase. O chatbot pesquisa nos títulos e descrições dos produtos, devolvendo os 5 principais produtos correspondentes com:

• ID, nome e descrição do produto
• Preço (opcionalmente com impostos e descontos de preços específicos aplicados)
• Ligação direta para a página do produto na sua loja
• Imagem do produto

Pesquisa de Produtos por Referência (SKU) - Os clientes podem procurar produtos utilizando códigos de referência exatos. O chatbot pesquisa em múltiplos tipos de identificadores - referência/SKU, código de barras EAN-13, ISBN e MPN - tanto nos produtos como nas respetivas variantes (combinações). Isto é útil quando os clientes têm um código de produto específico de um catálogo, fatura ou embalagem.

Detalhes da Encomenda - Os clientes podem verificar o estado da sua encomenda fornecendo um ID de encomenda e o endereço de e-mail associado à mesma. Ambos os valores são validados com os registos da sua loja PrestaShop. O chatbot devolve:

• Referência, data e estado atual da encomenda (por exemplo, em processamento, concluída, cancelada)
• Total da encomenda
• Nome do destinatário, empresa, morada de entrega completa (rua, cidade, código postal) e número de telefone
• Nome da transportadora e números de rastreio (suporte para múltiplos números de rastreio)
• Artigos encomendados com nomes, quantidades e preços individuais

Pré-requisitos

Antes de iniciar a integração com o PrestaShop, certifique-se de que:

• O seu chatbot já foi adicionado à sua loja PrestaShop - consulte Instalar o Chatbot numa Loja PrestaShop
• Tem acesso ao painel de administração do PrestaShop (back office)

Passo 1: Ativar o Webservice no PrestaShop

1. Inicie sessão no back office do seu PrestaShop
2. Aceda a Configure > Advanced Parameters > Webservice (Configurar > Parâmetros Avançados > Webservice)

3. Desloque-se para baixo até à secção Configuration (Configuração)
4. Defina Enable PrestaShop's webservice (Ativar webservice do PrestaShop) para Yes (Sim)
5. Clique em Save (Guardar)

Passo 2: Criar uma Chave de Webservice

1. Na mesma página de Webservice, clique em Add new webservice key (Adicionar nova chave de webservice)

2. Clique em Generate (Gerar) para criar uma nova chave
3. Introduza uma descrição (por exemplo, "ChatLab Integration")
4. Certifique-se de que a chave está definida como Enabled (Ativada)
5. Nas permissões de recursos, conceda acesso de View (GET) (Visualizar [GET]) aos seguintes recursos:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • states
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Clique em Save (Guardar)
7. Copie a chave de webservice gerada - irá precisar dela no passo seguinte

Passo 3: Encontrar o Formato do URL do Produto

1. No back office do PrestaShop, aceda a Configure > Shop Parameters > Traffic & SEO (Configurar > Parâmetros da Loja > Tráfego e SEO)

2. Desloque-se para baixo até à secção Schema of URLs (Esquema de URLs)
3. Copie o valor do campo Route to products (Rota para produtos) (por exemplo, {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Passo 4: Ligar o PrestaShop no ChatLab

1. Inicie sessão no ChatLab e selecione o seu bot
2. Aceda ao separador Connect (Ligar)

3. Clique em Connect (Ligar) no mosaico do PrestaShop
4. Introduza a sua Webservice key (Chave de webservice) (obtida no Passo 2)
5. Introduza o seu Shop url (URL da loja) (o URL completo da sua loja, por exemplo, https://www.mystore.com)
6. Introduza o seu Product url format (Formato do URL do produto) (obtido no Passo 3)

7. Clique em Initialize Configuration (Inicializar Configuração) - esta ação obtém os idiomas disponíveis na sua loja
8. Selecione o Default language (Idioma predefinido) correto no menu pendente
9. Clique em Connect (Ligar)

O ChatLab testa a ligação automaticamente, verificando se a sua chave de webservice tem as permissões necessárias. Se a operação for bem-sucedida, verá uma mensagem de confirmação.

Passo 5: Configurar Ações do PrestaShop

Após a ligação, pode ativar e personalizar ações individuais de IA. Aceda a Settings > Actions (Definições > Ações) e filtre pela plataforma PrestaShop.

Estão disponíveis as seguintes ações:

• Prestashop - product search - permite que o chatbot pesquise no seu catálogo de produtos por nome
• Prestashop - search by reference - permite que o chatbot encontre produtos por códigos de referência/SKU, EAN-13, ISBN ou MPN
• Prestashop - order details - permite que o chatbot consulte informações sobre encomendas
• Prestashop - get product variants - permite que o chatbot obtenha informações detalhadas sobre variantes (tamanhos, cores) de um produto específico

Clique no botão de ativação em cada ação para a ativar. Também pode personalizar a etiqueta da ação (a mensagem mostrada aos utilizadores enquanto a ação é executada) e as instruções que orientam a forma como a IA utiliza cada ação.

Quando a ação "Search by reference" está ativada, a pesquisa normal de produtos também recorrerá automaticamente à pesquisa por código de referência caso não sejam encontrados resultados pelo nome. Isto significa que os clientes podem introduzir um SKU ou código de barras numa pesquisa normal e continuar a obter resultados precisos.

Mostrar Produtos com Data de Reposição de Stock (Pré-encomenda)

Quando a opção "Products in stock only" (Apenas produtos em stock) está ativada nas definições da ação Product Search, pode ativar adicionalmente "Show products with restock date" (Mostrar produtos com data de reposição de stock). Isto permite que o chatbot inclua produtos esgotados que tenham uma data prevista de reposição definida no PrestaShop. Em vez de ocultar estes produtos por completo, o chatbot informa o cliente sobre a data de reposição e que o produto se encontra disponível para pré-encomenda.

Requisitos:

• O PrestaShop deve ter a opção "Allow ordering of out-of-stock products" (Permitir encomendar produtos esgotados) ativada (Shop Parameters > Product Settings [Parâmetros da Loja > Definições de Produtos])
• A chave de webservice tem de ter acesso de View (GET) aos recursos combinations e configurations
• Os produtos têm de ter uma available_date definida nas suas combinações no PrestaShop

Preços com IVA Incluído

Ative o seletor "Apply tax (VAT) to prices" (Aplicar imposto [IVA] aos preços) nas definições da ação Product Search para apresentar os preços com impostos incluídos. Quando ativado, o chatbot calcula os preços utilizando as regras fiscais da sua loja PrestaShop com base no país predefinido da loja. Isto garante que os preços visualizados pelos clientes no chat correspondem aos apresentados na sua loja.

Requisitos:

• A chave de webservice tem de ter acesso de View (GET) aos recursos taxes, tax_rules, tax_rule_groups e configurations

Preços Específicos (Descontos e Promoções)

Ative o seletor "Apply specific prices (discounts/promotions)" (Aplicar preços específicos [descontos/promoções]) nas definições da ação Product Search para apresentar preços com desconto provenientes das regras de preços específicos do PrestaShop. Quando um desconto está ativo para um produto, o chatbot apresenta tanto o preço com desconto como o preço original, para que os clientes possam ver a poupança.

Isto abrange regras de preços específicos universais - promoções e saldos aplicáveis a todos os clientes com uma quantidade mínima de 1. Promoções com limite de tempo também são suportadas; o chatbot aplica apenas os descontos que estão atualmente ativos com base nas respetivas datas de início e fim.

Requisitos:

• A chave de webservice tem de ter acesso de View (GET) aos recursos specific_prices e specific_price_rules

Testar a Sua Integração

Após ativar as ações, abra o widget do seu chatbot e experimente:

• "Mostra-me sapatilhas de corrida" (testa a pesquisa de produtos)
• "Procuro o produto ABC-12345" (testa a pesquisa por referência/SKU)
• "Qual é o estado da minha encomenda 12345?" (testa os detalhes da encomenda)

Verifique se as respostas correspondem aos dados da sua loja PrestaShop, se as ligações dos produtos abrem corretamente e se os preços incluem impostos e descontos quando essas opções estão ativadas.

Instalar o Chatbot na Sua Loja PrestaShop

Para adicionar o widget de chat à sua loja PrestaShop, consulte o guia detalhado: Instalar o Chatbot numa Loja PrestaShop