Collegamento delle piattaforme di revisione esterne

Integrazione della Piattaforma di Revisione Esterna

Collega la tua piattaforma di revisione di terze parti esistente a LoyaltyTree per sincronizzare le recensioni e assegnare semi ai clienti automaticamente.

Panoramica

Se utilizzi già una piattaforma di revisione come Judge.me, Loox o Yotpo, puoi integrarla con LoyaltyTree invece di passare al nostro sistema di revisione nativo. Questo ti consente di:

• Mantenere le tue recensioni esistenti: Non è necessario migrare o ricominciare da capo
• Assegnare semi per le recensioni: I clienti guadagnano premi di fedeltà quando lasciano recensioni
• Esperienza cliente unificata: Le recensioni contribuiscono al loro percorso di fedeltà complessivo
• Sincronizzazione automatica: Le recensioni fluiscono in LoyaltyTree tramite webhook

Passo 1: Accedi alle Impostazioni di Revisione

1. Vai su Negozio nel tuo admin di LoyaltyTree
2. Trova la scheda del tuo negozio e clicca sul pulsante Impostazioni di Revisione 
3. Vai alla scheda Impostazioni

Passo 2: Seleziona la Modalità Piattaforma Esterna

Nelle Impostazioni del Sistema di Revisione:

1. Trova il menu a discesa Sistema di Revisione
2. Cambialo da "LoyaltyTree Nativo" a Piattaforma Esterna
3. Assicurati che Abilita Sistema di Revisione sia selezionato

Passo 3: Scegli la Tua Piattaforma di Revisione

Seleziona il tuo fornitore di recensioni dal menu a discesa Piattaforma di Revisione:

Passo 4: Abilita l'Elaborazione dei Webhook

Seleziona l'opzione Abilita Elaborazione Webhook. Questo consente a LoyaltyTree di ricevere ed elaborare i dati delle recensioni dalla tua piattaforma esterna.

Passo 5: Configura l'URL del Webhook

Una volta selezionata una piattaforma, LoyaltyTree genera un URL Webhook unico per il tuo negozio.

Copia il Tuo URL Webhook:

1. Trova il campo URL Webhook nel pannello di integrazione
2. Clicca sul pulsante Copia per copiare l'URL completo
3. Conserva questo URL al sicuro - è unico per il tuo negozio

Aggiungi il Webhook alla Tua Piattaforma di Revisione:

I passaggi esatti variano a seconda della piattaforma, ma in generale:

1. Vai alle impostazioni admin della tua piattaforma di revisione
2. Trova la sezione Webhook o Integrazioni
3. Aggiungi un nuovo webhook con l'URL copiato
4. Seleziona l'evento Revisione Creata o Nuova Revisione
5. Salva la configurazione del tuo webhook

Passo 6: Segreto del Webhook (Opzionale)

Per una maggiore sicurezza, puoi configurare un Segreto del Webhook per verificare che i webhook in arrivo siano autentici.

Come funziona:

1. Inserisci una chiave segreta nel campo Segreto del Webhook
2. Configura la tua piattaforma di revisione per firmare le richieste con questo segreto
3. LoyaltyTree verificherà la firma utilizzando l'intestazione x-webhook-signature o x-signature

Nota: Non tutte le piattaforme supportano le firme dei webhook. Se la tua non lo fa, puoi lasciare questo campo vuoto.

Passo 7: Opzione Generica/Personalizzata - Formato JSON Atteso

Quando la tua piattaforma di revisione invia un webhook, LoyaltyTree si aspetta il seguente formato di dati:

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "Ottimo prodotto!",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "Nome del Prodotto"
}

Campi Richiesti:

Supporto per Formati Annidati:

LoyaltyTree supporta anche formati di dati annidati comunemente usati dalle piattaforme di revisione:

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "Ottimo prodotto!"
  }
}

Premi in Semi per Recensioni Esterne

Nota: Le assegnazioni di semi per le recensioni sono gestite a livello di Gruppo di Fedeltà. Vai alle Impostazioni di Fedeltà → Impostazioni Semi del tuo negozio per configurare quanti semi guadagnano i clienti per le recensioni, i bonus per le foto e i bonus per la prima recensione.

Quando viene ricevuto un webhook di revisione:

1. LoyaltyTree abbina l'customer_email a un cliente esistente
2. Se trovato, i semi vengono assegnati in base alla tua configurazione delle Impostazioni Semi
3. Le recensioni fotografiche possono guadagnare semi bonus se configurate
4. I revisori per la prima volta possono guadagnare semi bonus aggiuntivi

Risoluzione dei Problemi

Le recensioni non si sincronizzano?

• Controlla l'URL del webhook: Assicurati di aver copiato l'URL completo, inclusi tutti i parametri di query
• Verifica che il webhook sia abilitato: Conferma che "Abilita Elaborazione Webhook" sia selezionato in LoyaltyTree
• Controlla la tua piattaforma di revisione: Assicurati che il webhook sia attivo e punti all'URL corretto
• Testa con una nuova recensione: Invia una recensione di prova per attivare il webhook

Il cliente non riceve semi?

• L'email deve corrispondere: L'customer_email nel webhook deve corrispondere a un cliente nel tuo database di LoyaltyTree
• Controlla le Impostazioni Semi: Verifica che i premi per le recensioni siano configurati nel tuo Gruppo di Fedeltà
• Il cliente deve essere registrato: I clienti anonimi o ospiti potrebbero non ricevere premi in semi

Errori di firma del webhook?

• Il segreto deve corrispondere: Il segreto in LoyaltyTree deve corrispondere esattamente a quello configurato nella tua piattaforma di revisione
• Formato dell'intestazione: LoyaltyTree cerca le intestazioni x-webhook-signature o x-signature

Hai bisogno di aiuto?

Contatta il nostro team di supporto all'indirizzo support@loyaltytree.eco per assistenza con l'integrazione della piattaforma di revisione esterna.