HIKO Wish Keeper

São necessárias duas coisas: ativar o app embed no tema e ativar a lista de desejos nas definições da aplicação.

Passo 1 — ativar o app embed

1. Abra o HIKO Wish Keeper no painel de administração da Shopify
2. Clique em «Ativar no tema» no topo da página — o editor de temas abre com o app embed já selecionado
3. Confirme que o interruptor está ligado e guarde no editor de temas

Passo 2 — ativar a lista de desejos nas definições

1. Volte à página Definições do HIKO Wish Keeper
2. Em Páginas de produto, ative «Ativar lista de desejos nas páginas de produto»
3. Em Páginas de coleção, ative «Ativar lista de desejos na grelha de produtos»
4. Clique em Guardar

Os botões passam então a aparecer automaticamente na sua loja. Não é preciso alterar o código do tema.

O app embed é a causa mais frequente do «não aparece nada». Tudo o que esta aplicação desenha na sua loja — os botões, a página de conta, as páginas de listas partilhadas — é carregado a partir desse único app embed.

Sim. Nas Definições do HIKO Wish Keeper, ative «Exigir início de sessão». Enquanto estiver ativa, a lista de desejos não é carregada de forma alguma para visitantes sem sessão e nenhum botão aparece.

Deixe-a desativada se quiser que também os visitantes possam guardar produtos. As listas deles vivem no próprio navegador e são juntadas à conta no primeiro início de sessão, por isso nada se perde.

A página de Análises reúne o que é preciso para compreender o comportamento dos seus clientes.

• Todos os clientes com lista de desejos e os produtos que guardaram
• Os produtos mais guardados da sua loja
• Taxas de entrega, abertura e clique das notificações
• Atividade de partilha por plataforma (Facebook, Twitter, Pinterest, WhatsApp, LINE)
• Padrões de visualização de produtos e tendências de popularidade
• Conversão e estado de faturação das encomendas provisórias
• Comparação da atividade por dia e por semana
• Exportação dos e-mails dos clientes e dos dados das listas em CSV

A página de conta é uma página da sua loja que reúne tudo o que esta aplicação trata para um cliente. Fica em /apps/hwl/account e está organizada em separadores: a lista de desejos e, depois do início de sessão, encomendas, endereços, perfil, preferências de notificação e encomendas provisórias.

Está ativa por predefinição. Pode desativá-la em Página de conta > Página de conta; esse endereço deixa então de funcionar e as ligações que lhe apontam desaparecem da loja.

A página de conta é desenhada pelo app embed, tal como os botões. Se o embed estiver desativado, o cliente chega à página mas vê uma breve mensagem de carregamento em vez da sua conta.

Com as duas, e não há nada para ativar. A app não pergunta que versão a sua loja usa.

A razão está no sítio onde a página de conta vive. É uma página da sua própria loja, em /apps/hwl/account, desenhada pelo seu tema — não uma página dentro da área de conta alojada pela Shopify. Lê o cliente com sessão iniciada, as encomendas e as moradas através do seu tema, tal como qualquer outro template, e isso funciona da mesma forma nas duas versões.

O início de sessão também funciona nas duas. A ligação que a app disponibiliza aponta para /customer_authentication/login: a Shopify encaminha o cliente para o ecrã de início de sessão correspondente à versão da sua loja e depois devolve-o ao sítio onde estava.

Há uma diferença, e é da Shopify, não nossa. Nas novas contas de cliente, as páginas de conta alojadas pela Shopify não conseguem mostrar conteúdo de uma app de tema, por isso não existe ali uma entrada para a lista de desejos. É por isso que a app envia o ícone de conta do cabeçalho do seu tema para a página de conta. Nas contas clássicas, esse ícone continua a levar às páginas de conta da própria Shopify, que funcionam normalmente — os clientes chegam à página de conta pelo ícone de coração ou por qualquer ligação que adicione.

Vá a Página de conta > Separadores. Cada separador tem um interruptor e um ícone, e as setas mudam a ordem. A ordem que definir é exatamente a que os seus clientes verão.

Os separadores são Perfil, Endereços, Lista de desejos, Encomendas, Encomendas provisórias e Preferências de notificação. Os dois últimos exigem um plano pago; todos os outros vêm ativos.

Há duas regras a conhecer:

• Tirando a lista de desejos, todos os separadores exigem que o cliente tenha sessão iniciada. Um visitante sem sessão verá apenas a lista de desejos, por mais que tenha ativado.
• Desativar um separador apenas o esconde, não apaga nada. Se o voltar a ativar, os dados estão intactos.

Está tudo em Página de conta, e a pré-visualização ao vivo acompanha cada alteração.

1. Layout — quatro disposições: barra lateral, separadores, painel (mosaicos) ou acordeão
2. Cores — claro, escuro, quente ou automático (o automático segue a preferência de sistema do visitante)
3. Cor da marca — usada nos botões, nas ligações e no separador ativo. No tema escuro é clareada automaticamente, para que uma cor escura não desapareça
4. CSS personalizado — para o que as definições não cobrem; só se aplica dentro da página de conta

Sim, com um plano pago. Em Página de conta > Separadores, abra Perfil e acrescente campos: texto, lista pendente com as suas opções, data ou caixa de verificação.

As respostas são guardadas como metacampos do cliente Shopify, pelo que podem ser usadas no Shopify Flow, em segmentos e no seu tema. O painel Onde os campos são guardados, na mesma página, indica o namespace e a chave exatos de cada campo.

Três coisas a saber antes de começar:

• O tipo de campo não pode ser alterado depois. É uma restrição da Shopify. Escolha-o bem desde o início: mudá-lo obriga a criar um campo novo.
• Remover um campo apenas o retira do formulário. As respostas já recolhidas e a definição permanecem na Shopify. É intencional: um clique infeliz não deve apagar os dados de clientes de uma loja inteira.
• No plano gratuito pode continuar a editar e a remover os campos existentes. Só acrescentar novos está reservado aos planos pagos.

O coração no cabeçalho da sua loja leva ao lugar onde aquele cliente pode realmente ver a sua lista.

• Sem sessão — para a página de lista de desejos autónoma
• Com sessão e separador da lista de desejos ativo — para o separador da lista de desejos na página de conta
• Com sessão e separador da lista de desejos desativado — para a página de lista de desejos autónoma

Se mostrar a lista como janela sobreposta ou painel lateral, o coração mantém esse comportamento e não leva a nenhuma página.

Em Página de conta > Depois do início de sessão escolhe entre três destinos: a página de conta (predefinição), a página inicial ou uma página à sua escolha.

Para um destino próprio, escreva um caminho começado por barra, por exemplo /pages/membros. URL completos são rejeitados: o reencaminhamento só aceita caminhos dentro da sua loja, e um valor rejeitado recai silenciosamente na página de conta.

Esta definição aplica-se a qualquer entrada no início de sessão, incluindo o ícone de conta no cabeçalho do seu tema.

O HIKO Wish Keeper tem um único plano pago, com faturação mensal ou anual.

• Gratuito — a lista de desejos completa, sem limite no número de listas nem de artigos guardados, além das análises da página Análises e da partilha nas redes sociais
• Professional — 6,99 $ por mês ou 62 $ por ano. Acrescenta notificações por e-mail, acesso à API, encomendas provisórias com faturação e campos de perfil personalizados na página de conta

O plano pago inclui 7 dias de experiência gratuita. Pode mudar a qualquer momento na página de mudança de plano.

Não. A Shopify aplica automaticamente o cálculo proporcional e desconta a parte não usada do seu plano atual. Paga apenas a diferença.

Ao passar de mensal para anual, os dias que restam do ciclo mensal são descontados do preço anual. Se mudar a meio do mês, por exemplo, essa meia mensalidade não usada é subtraída.

De tudo isto trata o sistema de faturação da Shopify: não tem de fazer nada.

Passados os 7 dias, a Shopify envia-lhe um e-mail a pedir que aprove a subscrição recorrente. Não é cobrado automaticamente: a Shopify exige sempre uma aprovação explícita.

Se aprovar, a subscrição continua normalmente. Se não aprovar em 2 dias, a loja volta ao plano gratuito e as funções pagas ficam inacessíveis até nova subscrição.

Pode voltar a subscrever quando quiser na página de mudança de plano. Descer de plano não apaga nada: listas, campos personalizados e definições ficam todos no lugar.

O aspeto do botão afina-se ao detalhe, tudo a partir da página Definições.

1. Mude a forma, a cor e o tamanho do ícone em Definições > Estilo global
2. Ajuste separadamente a cor ativa (guardado) e a inativa
3. Escolha o efeito de animação: pulsação, salto ou nenhum
4. Ajuste o tamanho do ícone e a espessura do traço
5. Acompanhe as alterações na pré-visualização ao vivo

Sim, separadamente para páginas de coleção e de produto.

1. Páginas de coleção: posição (canto superior direito, superior esquerdo, inferior direito, inferior esquerdo) e margens
2. Páginas de produto: mostrá-lo como «sobreposição na imagem» ou como «botão normal»
3. Colocação: junto a «Adicionar ao carrinho», sob o preço, ou num lugar à sua escolha
4. Estilo do botão: «ícone + texto» ou «só ícone»

A aplicação vem traduzida em 15 idiomas: inglês, chinês tradicional, chinês simplificado, japonês, coreano, alemão, francês, espanhol, italiano, português, russo, vietnamita, tailandês, árabe e hebraico. Cada cliente vê o idioma do seu navegador, sem que tenha de configurar nada.

A página Traduções não serve para acrescentar idiomas, mas para mudar a redação.

1. Abra a página Traduções a partir da navegação
2. Escolha o seu idioma principal na lista pendente
3. Altere as etiquetas dos botões, as mensagens e os nomes de listas que quiser redigir de outra forma
4. Guarde

Pode acrescentar qualquer idioma através de uma tradução personalizada.

1. Abra a página Traduções
2. Clique em «Adicionar idioma»
3. Escreva o código do idioma (ko para coreano, de para alemão)
4. Traduza todos os textos: etiquetas dos botões, avisos, nomes de listas, textos das janelas
5. Clique em Guardar

Quando o idioma do navegador de um cliente corresponder ao seu código, é a sua tradução que é usada. Todo o texto que os clientes veem fica nas suas mãos.

Os seus clientes podem partilhar qualquer lista própria com amigos e família através de uma ligação dedicada.

1. Abrir a página da lista de desejos e escolher uma lista própria
2. Clicar em «Partilhar» para copiar a ligação
3. Enviá-la a quem quiserem — quem a recebe não precisa de conta
4. A página partilhada mostra todos os artigos com informação e preços

Cada lista própria recebe automaticamente um token de partilha único. As listas predefinidas «Favoritos» e «Ver mais tarde» também podem ser partilhadas.

Sim. Quem abrir uma ligação partilhada pode subscrever essa lista.

1. Abrir a ligação enviada por um amigo
2. Clicar em «Subscrever» para a acrescentar à sua própria página de lista de desejos
3. As listas subscritas aparecem ao lado das próprias
4. As alterações de quem é dono da lista chegam automaticamente aos subscritores

Os seus clientes podem partilhar os produtos guardados nas redes sociais.

• Facebook — partilhar o produto com imagem e descrição
• Twitter / X — publicar uma mensagem com a ligação do produto
• Pinterest — guardar a imagem do produto
• WhatsApp — enviar a ligação por mensagem
• LINE — partilhar através do LINE
• E-mail — enviar a ligação do produto por e-mail
• Copiar ligação — copiar o URL do produto para a área de transferência

Ativa-se em Definições > Partilha nas redes sociais. Escolhe as plataformas mostradas e pode alterar o modelo da mensagem.

Os seus clientes são avisados automaticamente quando o preço de um produto guardado desce.

1. Vá a Notificações > Definições
2. Ative «Avisos de baixa de preço»
3. Defina o limiar (qualquer baixa, uma percentagem ou um valor)
4. Defina a frequência das verificações (a cada hora, diariamente…)
5. Os clientes que deram consentimento recebem os e-mails automaticamente

Os avisos de reposição de stock são enviados apenas quando um produto passa de indisponível a disponível. Na primeira leitura do estado de inventário nada é enviado, de propósito: de outro modo, todos os seus clientes receberiam um e-mail no dia da instalação.

Para enviar notificações tem de configurar um fornecedor de e-mail.

1. Vá a Notificações > Definições
2. Escolha um fornecedor: Resend, SendGrid, Brevo ou SMTP próprio
3. Introduza a chave de API e os dados do remetente
4. Verifique a configuração com «Enviar e-mail de teste»
5. Ative os tipos de notificação que quiser
6. Defina a frequência das verificações automáticas

O mais simples é o Resend; pode obter uma chave de API gratuita em resend.com.

Sim. Pode compor e-mails à imagem da sua loja.

1. Vá a Notificações > Modelos
2. Escolha o tipo de notificação (baixa de preço, reposição de stock…)
3. Escolha o idioma do modelo
4. Altere o assunto do e-mail
5. Adapte o corpo HTML à sua marca
6. Acrescente uma versão em texto simples para os programas que não lidam com HTML
7. Use variáveis como {{product_title}}, {{new_price}} ou {{product_url}} para conteúdo dinâmico
8. Pré-visualize antes de guardar

A ajuda com IA permite-lhe produzir rapidamente um modelo bem acabado.

Uma encomenda provisória permite-lhe preparar uma encomenda para um cliente a partir dos produtos que ele guardou. É uma função dos planos pagos.

• Criar uma encomenda provisória diretamente a partir dos artigos guardados de um cliente
• Enviar uma fatura para o cliente concluir a compra
• Acompanhar o estado: provisória, enviada, aberta, clicada, concluída
• Cancelar ou eliminar uma encomenda provisória em qualquer momento
• Consultar todas as encomendas provisórias e o seu estado na página respetiva

No separador Encomendas provisórias da página de conta. Ative-o em Página de conta > Separadores; vem desativado porque exige um plano pago.

Aí o cliente vê todas as faturas ainda por pagar, com uma ligação de pagamento e a possibilidade de cancelar. Os e-mails de fatura que envia levam exatamente a esse lugar.

As versões anteriores ofereciam um bloco de tema para inserir à mão no editor de temas. Esses blocos foram retirados: o separador da página de conta substitui-os e já não há nada a acrescentar ao tema.

Tudo acontece na página Encomendas provisórias do HIKO Wish Keeper.

1. Na página Encomendas provisórias, encontre ou procure o cliente
2. Clique no cliente para ver os produtos que guardou
3. Marque com as caixas os artigos a incluir
4. Clique em «Criar encomenda provisória (N)», em que N é o número de artigos selecionados
5. Na janela pode definir um desconto (percentagem ou valor), um prazo de reserva e uma nota
6. «Criar» mostra um resumo com o detalhe dos preços
7. «Confirmar» cria a encomenda provisória; «Confirmar e enviar» cria-a e envia logo a fatura

O cliente recebe um e-mail com uma ligação de pagamento. Cada estado — provisória, enviada, aberta, clicada, concluída — acompanha-se na página Encomendas provisórias.

As encomendas provisórias exigem o plano Professional (6,99 $ por mês ou 62 $ por ano).

Se não se vê nenhum botão, percorra estes pontos por ordem.

• A função está ativa em Definições > Páginas de produto ou Páginas de coleção?
• O app embed desta aplicação está ativo no editor de temas, secção «App embeds»?
• A opção «Exigir início de sessão» está ativa nas definições? Nesse caso a lista não é carregada para visitantes sem sessão
• Limpe a cache do navegador e recarregue a página
• O seu tema suporta blocos de aplicação (um tema Online Store 2.0)?
• Verifique numa janela de navegação privada
• Se nada disto ajudar, escreva ao suporte

A página de conta é desenhada pelo app embed. Se a mensagem de carregamento ficar, é porque o embed está desativado.

1. Clique em «Ativar no tema» no topo da página da aplicação
2. Confirme que o interruptor está ligado e guarde no editor de temas

Se o endereço responder «não encontrado», é a própria página de conta que está desativada: volte a ativá-la em Página de conta > Página de conta.

Se os e-mails não chegam, percorra as causas habituais.

• A chave de API do fornecedor em Notificações > Definições está correta?
• O endereço do remetente está verificado no fornecedor?
• O cliente deu consentimento para receber notificações?
• O histórico de envios em Análises > Notificações mostra erros?
• Envie um e-mail de teste para verificar a configuração
• Veja devoluções e problemas de entrega no painel do seu fornecedor

Estamos cá para ajudar.

• Para questões técnicas: [email protected]
• Envie uma mensagem diretamente pelo botão de suporte na aplicação
• As dúvidas mais comuns estão reunidas nestas perguntas frequentes

Envie a sua chave de API como token Bearer no cabeçalho Authorization: Authorization: Bearer your_api_key. As chaves criam-se na página Integração com a API.

Funcionam ambos: o ID numérico (por exemplo 1234567890) e o GID completo da Shopify (por exemplo gid://shopify/Customer/1234567890). Todos os endpoints aceitam as duas formas.

A API usa os códigos de estado HTTP habituais.

• 200 – Sucesso: o pedido foi processado
• 400 – Pedido inválido: parâmetros errados ou em falta
• 401 – Não autorizado: chave de API ausente ou inválida
• 404 – Não encontrado: o recurso não existe
• 429 – Demasiados pedidos: o limite foi excedido
• 500 – Erro do servidor: o problema é nosso

Os endpoints de listagem aceitam os parâmetros page e limit. A resposta inclui um objeto pagination com a página atual, o total de páginas e o total de elementos, o que permite percorrer conjuntos grandes de resultados.

Sim. Configure um URL de webhook na página Integração com a API e a aplicação enviará para lá um pedido POST em cada evento da lista de desejos. Não é preciso sondar.