Compreender o estado e os erros da sincronização do catálogo

Leia o progresso da sincronização e transforme uma sincronização do catálogo falhada ou parcial numa ação seguinte focada. Este guia mantém o trabalho focado na sincronização do catálogo e fornece um caminho repetível...

Leia o progresso da sincronização e transforme uma sincronização do catálogo falhada ou parcial numa ação seguinte focada. Este guia mantém o trabalho focado na sincronização do catálogo e fornece um caminho repetível que um novo utilizador de Humind pode seguir sem alterar configurações não relacionadas.

O catálogo fornece à Humind informações estruturadas sobre produtos, como produtos, variantes, preços, disponibilidade, coleções e metadados. A sincronização do Shopify traz os dados de origem para a Humind, enquanto a indexação e os filtros de IA determinam o que o Agent pode usar. Uma sincronização bem-sucedida, por si só, não prova que todos os produtos estejam prontos para conversas com clientes.

Antes de começar

Acesso: O acesso de leitura ao catálogo é suficiente para inspecionar o estado. Voltar a ligar ou iniciar a sincronização requer acesso de escrita ao catálogo ou à empresa.

  • Conheça a loja ligada e o Shopify Market pretendido.
  • Registe quando os dados de origem foram alterados pela última vez.
  • Escolha um produto que possa ser verificado de ponta a ponta.

Trabalhe na menor área responsável descrita abaixo e mantenha disponível o estado atual voltado para o cliente enquanto prepara a alteração. Antes de clicar em qualquer ação final, confirme a empresa ativa, o Agent, a loja, o idioma e o mercado apresentados na Humind. Um controlo em falta pode indicar acesso só de leitura ou uma capacidade que não está configurada para esta empresa. Nesse caso, registe a tarefa pretendida e peça a um administrador que reveja a permissão ou dependência exata. Não contorne este limite partilhando uma conta, copiando dados para outra área ou prometendo uma capacidade que o espaço de trabalho não expõe.

Fluxo de trabalho passo a passo

  1. Confirmar o âmbito e o estado atual

    Abra o catálogo ou a integração do Shopify e distinga trabalho em fila de espera, em execução, concluído, parcial e falhado do estado de indexação separado.

    • Confirme a empresa ativa e o Agent antes de editar.
    • Registe o estado atual para que o resultado possa ser comparado após a alteração.
    • Pare se o ecrã ou a permissão não corresponderem à tarefa pretendida.
  2. Preparar a alteração

    Inspecione a fase comunicada e os detalhes do erro, depois verifique se o produto de origem, o mercado ou a autorização explicam o problema.

    • Use a menor alteração que conclua a tarefa do cliente.
    • Mantenha a informação autorizada na sua fonte proprietária.
    • Reveja etiquetas, datas, idioma e texto visível para o cliente antes de guardar.
  3. Guardar e permitir que o processamento necessário termine

    Tente novamente ou volte a ligar apenas depois de corrigir a causa identificada. Evite iniciar sincronizações sobrepostas que ocultem o resultado.

    • Aguarde que a interface confirme que a alteração foi guardada.
    • Se for necessária sincronização, indexação ou publicação, aguarde pelo estado final.
    • Recarregue a área e confirme que os valores guardados persistem.
  4. Testar o percurso completo do cliente

    Confirme o produto representativo, as variantes, o preço, o stock, o mercado e a disponibilidade do Agent depois de os estados finais de sincronização e indexação estarem concluídos.

    • Use uma sessão nova e um cenário de cliente realista.
    • Verifique em desktop e móvel quando o resultado aparecer numa montra.
    • Capture o passo exato que falha se o resultado diferir do esperado.

Limites importantes e notas de funcionamento

  • Um guardado bem-sucedido confirma a persistência, não cada sincronização a jusante ou atualização pública.
  • As permissões do espaço de trabalho podem ocultar uma área ou permitir leitura sem permitir alterações.
  • Não copie dados voláteis do catálogo, da conta ou do cliente para conteúdo narrativo como solução alternativa.
  • Teste apenas capacidades suportadas que estejam visíveis e configuradas para a empresa atual.
  • Mantenha as alterações na sincronização do catálogo separadas de trabalho não relacionado no Agent, Knowledge, catálogo, Inbox ou Helpdesk.

Verificar o resultado

  • A sincronização atinge um estado final claro.
  • Os totais comunicados são plausíveis para a loja e o mercado pretendidos.
  • O produto representativo corresponde aos dados de origem do Shopify.
  • Um teste de produto pode usar o artigo depois de a indexação estar concluída.

Mantenha um registo curto do que testou, do cenário de cliente que usou e do que mudou. Isto torna a resolução de problemas posterior mais precisa e ajuda outro colega de equipa a reproduzir o resultado sem depender da memória.

Resolução de problemas

Uma sincronização permanece em fila de espera ou em execução

Aguarde pelo trabalho ativo e atualize o respetivo estado. Se ultrapassar a janela normal de funcionamento, registe a loja, a fase, a hora de início e o erro visível antes de pedir ao suporte que investigue.

A sincronização termina, mas faltam produtos

Verifique separadamente a ativação do mercado, a publicação na origem, a visibilidade do produto e a indexação. Uma importação concluída não significa que cada item de origem esteja elegível para utilização pelo Agent.

Guias relacionados

Este artigo foi útil?