Conectando Plataformas de Revisão Externas

Integração da Plataforma de Revisão Externa

Conecte sua plataforma de revisão de terceiros existente ao LoyaltyTree para sincronizar avaliações e conceder sementes automaticamente aos clientes.

Visão Geral

Se você já usa uma plataforma de revisão como Judge.me, Loox ou Yotpo, pode integrá-la ao LoyaltyTree em vez de mudar para nosso sistema de revisão nativo. Isso permite que você:

• Mantenha suas avaliações existentes: Não há necessidade de migrar ou começar do zero
• Conceda sementes por avaliações: Os clientes ganham recompensas de fidelidade ao deixarem avaliações
• Experiência do cliente unificada: As avaliações contribuem para sua jornada de fidelidade geral
• Sincronização automática: As avaliações fluem para o LoyaltyTree via webhooks

Passo 1: Acesse as Configurações de Revisão

1. Navegue até Loja no seu admin do LoyaltyTree
2. Encontre o cartão da sua loja e clique no botão Configurações de Revisão 
3. Vá para a aba Configurações

Passo 2: Selecione o Modo de Plataforma Externa

Nas Configurações do Sistema de Revisão:

1. Encontre o dropdown Sistema de Revisão
2. Altere de "LoyaltyTree Nativo" para Plataforma Externa
3. Certifique-se de que Habilitar Sistema de Revisão esteja marcado

Passo 3: Escolha Sua Plataforma de Revisão

Selecione seu provedor de revisão no dropdown Plataforma de Revisão:

Passo 4: Habilitar Processamento de Webhook

Marque a opção Habilitar Processamento de Webhook. Isso permite que o LoyaltyTree receba e processe dados de revisão da sua plataforma externa.

Passo 5: Configurar URL do Webhook

Uma vez que você selecione uma plataforma, o LoyaltyTree gera uma URL de Webhook única para sua loja.

Copie Sua URL de Webhook:

1. Encontre o campo URL de Webhook no painel de integração
2. Clique no botão Copiar para copiar a URL completa
3. Mantenha esta URL segura - ela é única para sua loja

Adicione o Webhook à Sua Plataforma de Revisão:

Os passos exatos variam por plataforma, mas geralmente:

1. Vá para as configurações de admin da sua plataforma de revisão
2. Encontre a seção Webhooks ou Integrações
3. Adicione um novo webhook com a URL que você copiou
4. Selecione o evento Avaliação Criada ou Nova Avaliação
5. Salve sua configuração de webhook

Passo 6: Segredo do Webhook (Opcional)

Para maior segurança, você pode configurar um Segredo de Webhook para verificar se os webhooks recebidos são autênticos.

Como funciona:

1. Insira uma chave secreta no campo Segredo de Webhook
2. Configure sua plataforma de revisão para assinar solicitações com este segredo
3. O LoyaltyTree verificará a assinatura usando o cabeçalho x-webhook-signature ou x-signature

Nota: Nem todas as plataformas suportam assinaturas de webhook. Se a sua não suportar, você pode deixar este campo vazio.

Passo 7: Opção Genérica/Personalizada - Formato JSON Esperado

Quando sua plataforma de revisão enviar um webhook, o LoyaltyTree espera o seguinte formato de dados:

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "Ótimo produto!",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "Nome do Produto"
}

Campos Obrigatórios:

Suporte a Formatos Aninhados:

O LoyaltyTree também suporta formatos de dados aninhados comumente usados por plataformas de revisão:

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "Ótimo produto!"
  }
}

Recompensas de Sementes para Avaliações Externas

Nota: As alocações de sementes para avaliações são gerenciadas no nível do Grupo de Fidelidade. Vá para Configurações de Fidelidade da sua loja → Configurações de Sementes para configurar quantas sementes os clientes ganham por avaliações, bônus de fotos e bônus de primeira avaliação.

Quando um webhook de avaliação é recebido:

1. O LoyaltyTree combina o customer_email com um cliente existente
2. Se encontrado, as sementes são concedidas com base na configuração das suas Configurações de Sementes
3. Avaliações com fotos podem ganhar sementes bônus se configuradas
4. Avaliações de primeira vez podem ganhar sementes bônus adicionais

Resolução de Problemas

Avaliações não sincronizando?

• Verifique a URL do webhook: Certifique-se de que você copiou a URL completa, incluindo todos os parâmetros de consulta
• Verifique se o webhook está habilitado: Confirme se "Habilitar Processamento de Webhook" está marcado no LoyaltyTree
• Verifique sua plataforma de revisão: Certifique-se de que o webhook está ativo e apontando para a URL correta
• Teste com uma nova avaliação: Envie uma avaliação de teste para acionar o webhook

Cliente não recebendo sementes?

• O e-mail deve coincidir: O customer_email no webhook deve coincidir com um cliente no seu banco de dados do LoyaltyTree
• Verifique as Configurações de Sementes: Verifique se as recompensas de avaliação estão configuradas no seu Grupo de Fidelidade
• O cliente deve estar registrado: Clientes anônimos ou convidados podem não receber recompensas de sementes

Erros de assinatura de webhook?

• O segredo deve coincidir: O segredo no LoyaltyTree deve coincidir exatamente com o configurado na sua plataforma de revisão
• Formato do cabeçalho: O LoyaltyTree procura cabeçalhos x-webhook-signature ou x-signature

Precisa de Ajuda?

Entre em contato com nossa equipe de suporte pelo support@loyaltytree.eco para assistência com a integração da plataforma de revisão externa.