Findalo

Integração

Ligar a sua loja ao Findalo: os seis sítios onde as pessoas encravam

· 6 min de leitura · Por Ray Rodríguez, fundador do Findalo

A 9 de Setembro, um comerciante registou-se, pagou, descarregou o módulo e pôs-se a ligar a sua loja. Vinte minutos depois tinha cancelado. Não desistiu: tentou quatro vezes. O problema é que o caminho por onde tentava não podia funcionar, e ninguém na Findalo deu por isso até o cancelamento já estar feito.

Resolvemos no mesmo dia. Este artigo é o que aprendemos, convertido no guia que gostávamos que ele tivesse tido à frente: os seis sítios onde as pessoas encravam ao ligar a sua loja, com a saída de cada um.

Serve tanto se está a começar agora como se leva meia hora a lutar com aquilo.

1. O botão de ligar e a ligação à mão

Há duas formas de emparelhar a sua loja com a sua conta.

A automática é o botão «Ligar ao Findalo» do módulo: leva-o ao painel, escolhe a loja e volta sozinho, com tudo preenchido. Quando funciona, são dez segundos.

A manual é copiar dois valores do painel para o módulo, e funciona sempre. Os dois valores estão no painel, em Integração:

  • ID do motor de pesquisa (Search engine ID).
  • Token de sincronização (Sync token) — mostra-se com o ícone do olho e copia-se com o botão.

No módulo: «A ligação não funciona? Ligar manualmente» → cola os dois → guardar.

Se o botão automático o puser às voltas, não insista: use a manual. Foi isso que teria poupado vinte minutos àquele comerciante. E não, não são duas qualidades de ligação: uma vez emparelhada, a loja funciona exactamente igual pelos dois caminhos.

2. Regenerar o token deixa o módulo de fora

Este é o encravanço mais silencioso de todos, e o mais fácil de provocar quando algo não vai e se começa a carregar em botões.

No painel há uma opção para regenerar o token de sincronização. Ao carregar nela, o token anterior deixa de valer no instante. Se o módulo da sua loja ainda tiver o antigo, a sincronização pára e o módulo começa a responder que não tem token configurado.

Não há nada partido: há duas metades de uma chave que já não encaixam.

A saída: se regenerar o token, copie o novo para o módulo imediatamente. E se já não souber qual tem, regenere mais uma vez e cole esse, que assim de certeza são o mesmo.

3. Se se registou com o Google, entre com o Google

Parece óbvio e não é. Se criou a conta com o Google, não tem palavra-passe. Quando o painel lhe pede utilizador e palavra-passe, não há nenhuma combinação correcta que possa escrever, e o natural é acabar em «esqueci-me da palavra-passe» a inventar uma.

Funciona, mas é um desvio absurdo. No ecrã de acesso do painel há botão do Google: use-o.

Contamo-lo porque esse desvio foi exactamente o segundo degrau do caso de 9 de Setembro.

4. Que a pesquisa consiga ler o seu catálogo

Com o módulo instalado, o habitual é que isto funcione sem mexer em nada: é a sua loja que empurra o catálogo para o Findalo quando detecta alterações, não somos nós a ir buscá-lo.

Onde pode ser preciso uma ajuda é se a sua loja tiver um muro de acesso — catálogo só para clientes registados, loja em manutenção, uma camada de protecção à frente — que intercepte também as rotas do módulo. Aí é preciso deixá-las passar. São duas linhas e vê-se logo na primeira sincronização, não três semanas depois.

O mesmo vale para as protecções anti-robôs agressivas: se o seu fornecedor bloqueia qualquer pedido que não pareça um navegador, pode estar a bloquear o seu próprio.

5. Cada loja e cada idioma não são o mesmo que cada motor

Aqui as pessoas encravam por uma expectativa, não por uma falha.

Um motor do Findalo é uma configuração: o seu catálogo, os seus sinónimos, as suas regras e o seu desenho. Se tem multi-loja, o normal é querer um motor por loja, porque cada uma vende coisas diferentes a gente diferente. Já os idiomas vivem dentro do mesmo motor: indexam-se juntos e o widget serve o que calhar.

Os planos trazem um motor; podem acrescentar-se mais por 12 € por mês cada. Se tem três lojas e esperava que entrassem as três no plano base, mais vale sabê-lo antes de instalar do que depois.

6. A primeira sincronização: o que ver e o que não

Ligado não é o mesmo que a funcionar. Depois de guardar a ligação:

  • Lance «Sincronizar agora» a partir do módulo e espere. Um catálogo pequeno demora segundos; um grande, minutos.
  • Veja o número de produtos no painel. É a única confirmação que vale. Se disser zero, a ligação está feita mas o catálogo não chegou.
  • Dê um par de minutos às imagens e aos links. É normal que os produtos apareçam antes das fotos: não está partido, está a acabar de montar-se.
  • Não reindexe em ciclo. Se a primeira sincronização falhou, a segunda vai falhar igual; o que há que ver é a mensagem de erro, que agora é legível e diz o que fazer.

O que mudámos depois daquilo

Porque contar o problema e não contar a correcção seria contar metade.

  • O botão de ligar funciona para clientes. Antes havia um caminho em que um cliente com sessão iniciada acabava expulso para o login e perdia o fio da ligação. Era essa a falha de fundo, e era determinista: não era azar.
  • Pode entrar-se com o Google. Antes era preciso inventar uma palavra-passe pelo caminho longo.
  • Retirou-se um atalho que já não servia. O painel oferecia copiar um código que o módulo tinha deixado de aceitar meses antes. Já não está lá.
  • Os erros de sincronização lêem-se. Antes saía o erro em cru; agora diz o que aconteceu e o que fazer.
  • E ficamos a saber. Agora salta um aviso interno na primeira vez que falha a sincronização de um cliente que paga. Naquele dia houve nove tentativas falhadas e um cancelamento sem que soasse nada.

Se encravou na mesma

Escreva-nos para hola@findalo.io e diga-nos em que passo está. Duas coisas que ajudam muito e que pode enviar sem receio: o endereço da sua loja e o ID do motor de pesquisa.

O que nunca nos deve enviar por email é o token de sincronização. Se for preciso, vemo-lo nós por dentro.

E se preferir não andar às voltas: diga e ligamo-lo nós. Não cobramos por isso.

Continua a ler