Sådan genererer du invitationslinks ved hjælp af Trustpilots API'er

Denne funktion er en del af Connect-tilkøbet, som er tilgængelig med pakkerne Premium og Advanced og er inkluderet i Enterprise-pakken.

Med Trustpilots API'er kan du generere invitationslinks og sende dem til dine kunder via dine egne e-mails eller andre kommunikationskanaler. Læs med her, og find ud af, hvordan du gør.

Det kræver teknisk ekspertise.

Find din API key og secret key

Hvis du har adgang til API'er via din virksomhedskonto, kan du oprette og administrere dine API keys ved at følge vejledningen nedenfor eller gå direkte hertil.

  1. Gå ind på din virksomhedskonto > Integrationer > Udviklere > API'er.
  2. Navngiv din applikation, og angiv de domæner, du gerne vil inkludere, under Opret en ny applikation. Klik derefter på Opret applikation.
  3. Din nye applikation vises under Dine applikationer. Klik på rullemenuen for at udvide applikationen og se din API key og secret key.

Find dit Business Unit ID (BUID)

Dit Business Unit ID er et unikt ID, der er specifikt for dit domæne. Det er altid det samme og ændrer sig kun, hvis dit domæne på Trustpilot bliver ændret. Du kan finde Business Unit ID'et for dit domæne ved hjælp af slutpunktet "Find Business Unit". Den påkrævede parameter her er dit business units "name", dvs. dit websites domæne. Eksempel: Hvis du gerne vil finde Trustpilots BUID, skal du angive parameteren "trustpilot.com".

Du kan selv prøve det af. Du skal bare huske at angive en anden API key.

https://api.trustpilot.com/v1/business-units/find?apikey={{apikey}}&name=trustpilotdemo.com

Når du får svar, skal du finde feltet "id". Dette er dit BUID for det domæne, du søgte efter.

Godkendelse med OAuth 2.0

Hvis du gerne vil kunne bruge et hvilket som helst privat API-slutpunkt på Trustpilot, kræves der godkendelse i form af et adgangstoken. Eftersom generering af invitationslinks betragtes som et privat slutpunkt, vil målet være først at få et adgangstoken, som du kan genbruge til flere API calls, mens det er gyldigt. Når dit token er udløbet, kan du opdatere det. Du finder flere oplysninger i vores dokumentation om godkendelse her (på engelsk).

Ved integrationer på serversiden anbefaler vi, at du anvender Grant Type: Password.

Generér et invitationslink til en serviceanmeldelse

Når først du har dit adgangstoken, kan du bruge vores API-slutpunkt "Generate service review invitation link". Denne JSON-anmodning med API call skal indeholde kundens navn, e-mailadresse, locale og et referencenummer, f.eks. et ordrenummer eller fakturanummer. Nedenstående eksempel er en komplet JSON-anmodning:

    {
        "referenceId": "fak00001",
        "name": "Jens Hansen",
        "tags": [
          "tag1", 
          "Tag2"
        ],
        "locale": "da-DK",
        "email": "jens.hansen@trustpilot.com", 
        "redirectUri": "https://trustpilot.dk"
    }

Dette API call opretter et unikt invitationslink, som du kan sende direkte til kunden.

Anmodningen vil også indeholde valgfri tags og redirectUri-felter. Denne oversigt kan give dig en bedre forståelse af de to felter:

Valgfrie tags

Dette kan være nogle ekstra, specifikke data, som du har om kunden eller købet. Hvis du tilføjer dem, før anmeldelsen indsendes, vil den blive tagget med relevante data, som giver dig mulighed for at foretage en grundigere analyse og få en skræddersyet visning af anmeldelsen.

Gyldige tegn er a–z, A–Z, 0–9, understreg, tankestreg og punktum. Mellemrum er ikke tilladt.

URI-omdirigering

Med en redirectUri kan du omdirigere kunden til en webside, du selv vælger, når kunden har indsendt sin anmeldelse. Hvis du ikke angiver en redirectUri, føres kunden til Trustpilots side med bekræftelse på, at anmeldelsen er indsendt. Du kan også føre kunden tilbage til én af dine websider, som for eksempel din egen takkeside eller bare startsiden.

Sørg for at bruge hele URL'en, inklusive http eller https (https://eksempel.dk ville være gyldig, mens eksempel.dk ikke ville være gyldig).

Related articles