Integração com a Shopify

Ligue o seu chatbot ChatLab à sua loja Shopify para dar aos clientes acesso em tempo real às informações dos produtos e ao seguimento de encomendas diretamente no chat.

Importante: Melhores práticas de E-Commerce

Depois de concluir a integração abaixo, leia o guia completo 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 Shopify introduzindo uma frase. O chatbot pesquisa nos títulos, descrições, tipos, etiquetas e fornecedores dos produtos, devolvendo produtos ativos correspondentes com:

• Nome, descrição e tipo de produto
• Fornecedor e etiquetas
• Preço ou intervalo de preços (para produtos com múltiplas variantes)
• Variantes disponíveis com SKU, preço de comparação, quantidade em inventário e estado de disponibilidade
• Imagem do produto e link direto para a sua loja

Pode configurar a pesquisa de produtos para mostrar apenas artigos em stock. Quando ativada, os artigos esgotados são excluídos dos resultados. Uma opção adicional permite incluir produtos disponíveis para pré-encomenda mesmo quando o filtro de stock está ativo. Consulte o Passo 4 para obter detalhes.

Detalhes da encomenda - Os clientes podem verificar o estado da encomenda fornecendo o número da encomenda e o endereço de e-mail. Ambos os valores são validados em relação aos registos da sua loja Shopify. O chatbot devolve:

• Referência da encomenda, data, total e moeda
• Artigos encomendados com nomes, quantidades, preços, SKU, título da variante e fornecedor
• Estado de processamento e informações de seguimento (número, transportadora, URL)
• Endereço de envio e endereço de faturação
• Método e custo de envio
• Informações de contacto do cliente (e-mail, nome, telefone)
• Motivo e data de cancelamento (para encomendas canceladas)

Passo 1: Criar credenciais de API da Shopify

Importante para agências e parceiros Shopify: A aplicação Shopify TEM de ser criada no Dev Dashboard da organização proprietária da loja - comece sempre a partir da administração da própria loja (Settings > Apps > Develop apps > Build apps in Dev Dashboard [Definições > Aplicações > Desenvolver aplicações > Criar aplicações no Dev Dashboard]). Uma aplicação criada por uma organização diferente (por exemplo, uma agência ou parceiro Shopify a trabalhar no seu próprio Dev Dashboard) e instalada na loja através de um link de instalação personalizado NÃO funcionará com o ChatLab, mesmo que a instalação seja bem-sucedida e a aplicação apareça entre as aplicações instaladas na loja com as permissões corretas. O motivo: o ChatLab liga-se utilizando o Client ID e o Secret (a concessão de credenciais de cliente da Shopify), e a Shopify só permite esta concessão para aplicações desenvolvidas pela organização proprietária da loja - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (documentação da Shopify). Trata-se de uma limitação da Shopify, não do ChatLab. O sintoma é uma falha de ligação no ChatLab com a mensagem "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (causada pelo erro OAuth shop_not_permitted da Shopify), mesmo quando o Client ID, o Secret e o subdomínio da loja estão todos corretos e a aplicação está instalada. Um sinal evidente de uma aplicação de outra organização: a administração da loja apresenta "This custom app was built by a Shopify partner for your store." A solução para agências: não precisa do programador do comerciante para o fazer - peça ao comerciante para adicionar o seu utilizador à organização DELE com a função de App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - documentação da Shopify) e, em seguida, crie a aplicação enquanto trabalha na organização do comerciante. O acesso de colaborador por si só não é suficiente - as aplicações criadas enquanto trabalha na sua própria organização permanecem na sua organização.

1. Inicie sessão no painel de administração da Shopify
2. Aceda a Settings > Apps (Definições > Aplicações)
3. Clique em Develop apps (Desenvolver aplicações)
4. Na página App Development, clique em Build apps in Dev Dashboard (Criar aplicações no Dev Dashboard) - esta ação abre dev.shopify.com/dashboard
5. Clique em Create app (Criar aplicação) e introduza um nome (por exemplo, "ChatLab Integration")

6. Uma vez criada, navegue até à secção Access (Acesso) e clique em Select scopes (Selecionar âmbitos)

7. Sob os âmbitos de acesso da Admin API, localize e ative estas permissões:
   • read_products
   • read_orders
8. Clique em Done (Concluído)

9. Clique no botão Release (Lançar) para disponibilizar a sua aplicação
10. Aceda a App settings (Definições da aplicação) e copie o Client ID e o Secret - guarde-os em segurança, pois precisará deles para ligar ao ChatLab

11. Aceda à secção Home (Início) e clique para instalar a aplicação na sua loja

12. Selecione a sua loja e confirme clicando em Install (Instalar)

Passo 2: Encontrar o subdomínio da sua loja

O seu subdomínio é a parte antes de .myshopify.com no URL de administração da sua Shopify. Por exemplo, se o seu URL de administração for https://pizza-delicious.myshopify.com/admin, o seu subdomínio será pizza-delicious.

Passo 3: Ligar a Shopify 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 cartão da Shopify
4. Introduza o seu Client ID (do Passo 1)
5. Introduza o seu Secret (do Passo 1)
6. Introduza o seu Shopify subdomain (subdomínio da Shopify do Passo 2)

7. Clique em Connect (Ligar)

O ChatLab testa automaticamente a ligação verificando se as suas credenciais de API têm os âmbitos de acesso necessários. Se for bem-sucedido, verá uma mensagem de confirmação.

Passo 4: Configurar ações da Shopify

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

Estão disponíveis duas ações:

• Shopify - product search - permite que o chatbot pesquise no seu catálogo de produtos
• Shopify - order details - permite que o chatbot consulte informações sobre encomendas

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 apresentada aos utilizadores enquanto a ação é executada) e as instruções que orientam a forma como a IA utiliza cada ação.

Pesquisa de produtos - Definições de inventário

A ação de pesquisa de produtos inclui opções de filtragem de inventário no separador Product Search Settings (Definições de pesquisa de produtos):

• Products in stock only (Apenas produtos em stock) - Quando ativado, o chatbot apenas devolve produtos que estejam atualmente em stock. Os produtos esgotados são excluídos dos resultados da pesquisa.
• Show products available for pre-order (Mostrar produtos disponíveis para pré-encomenda) - Esta opção aparece quando "Products in stock only" está ativado. Quando ativa, os produtos esgotados, mas configurados para continuar a vender (pré-encomenda) na Shopify, continuarão a aparecer nos resultados da pesquisa, marcados como disponíveis para pré-encomenda.

Testar a sua integração

Depois de ativar as ações, abra o widget do seu chatbot e experimente:

• "Mostra-me sapatilhas de corrida" (testa a pesquisa de produtos)
• "Qual é o estado da minha encomenda #1001?" (testa os detalhes da encomenda)

Verifique se as respostas correspondem aos dados da sua loja Shopify e se os links dos produtos abrem corretamente.

Instalar o chatbot na sua loja Shopify

Para adicionar o widget de chat à sua loja Shopify:

1. No ChatLab, aceda ao separador Deploy (Publicar) do seu bot
2. Selecione o separador da plataforma Shopify
3. Copie o fragmento de código
4. Na administração da sua Shopify, aceda a Online Store > Themes (Loja online > Temas)
5. Clique no menu de três pontos no seu tema ativo e selecione Edit code (Editar código)
6. Abra o ficheiro theme.liquid sob Layout
7. Cole o fragmento de código dentro da secção <head>
8. Clique em Save (Guardar)

No final - é necessário ativar as ações de IA disponíveis para a Shopify - Detalhes da encomenda e Pesquisa de produtos.